Wycena transakcji

Zwraca dokładną kwotę, jaką Utwórz transakcję z tym samym body pobrałoby w tej chwili, i niczego nie zapisuje. W przeciwieństwie do Oblicz koszt zasobów, które pokazuje opublikowany cennik, jest to kwota, po której naliczany jest zakup.

Dla zamówienia energy większego niż największa usługa energii (do 20 000 000 na zamówienie) odpowiedź wymienia także części, w których zamówienie zostanie zrealizowane. Odeślij zwrócony amount jako expected_amount w /v1/transaction/new, aby zapłacić dokładnie tę sumę — opcjonalnie, zalecane dla takiego zamówienia.

POST /v1/transaction/quote

Żądanie

Body jest takie samo jak w Utwórz transakcję: service, params (oraz external_id, który jest tu ignorowany). Jest walidowane w tej samej kolejności i z tymi samymi kodami błędów.

{
  "service": "energy",
  "params": {
    "address": "TRX_ADDRESS",
    "amounts": { "energy": 10000000 },
    "duration": 1
  }
}

Odpowiedź

Pole	Typ	Opis
result.service	string	Wyceniona usługa
result.amounts	object|null	Wycenione ilości zasobów
result.duration	integer	Czas trwania w godzinach
result.amount	string	Suma w TRX — wszystkie części oraz aktywacja, jeśli jest uwzględniona
result.activation	boolean	Czy suma obejmuje aktywację adresu
result.parts	array|null	Części dużego zamówienia energii: każda z resource_amount i amount (TRX); null dla zamówienia realizowanego w jednej części

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "service": "energy",
    "amounts": { "energy": 10000000 },
    "duration": 1,
    "amount": "601.200000",
    "activation": false,
    "parts": [
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 2000000, "amount": "120.240000" }
    ]
  }
}

Wycena dotyczy chwili i nie jest rezerwacją: ceny się zmieniają. Jeśli zamówienie zostanie potem wycenione inaczej, /v1/transaction/new z expected_amount odrzuci je z kodem 409 price_moved i niczego nie pobierze.

Ten endpoint zużywa ten sam limit zapytań o cenę co Oblicz koszt zasobów i Oszacuj energię.

Możliwe błędy

Błędy Utwórz transakcję występujące przed płatnością: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429, gdy limit zapytań o cenę się wyczerpie, 503 temporarily_unavailable, gdy sieć TRON nie odpowiedziała na czas na sprawdzenie adresu (HTTP 503, z nagłówkiem Retry-After; spróbuj ponownie za chwilę), oraz 500.