Котировка транзакции

Возвращает точную сумму, которую Создание транзакции с тем же телом спишет прямо сейчас, и ничего не записывает. В отличие от Расчета стоимости ресурсов, который показывает опубликованный тариф, это именно та сумма, по которой будет оформлена покупка.

Для заказа energy больше самого крупного сервиса энергии (до 20 000 000 на заказ) ответ также перечисляет части, которыми будет выполнен заказ. Передайте полученный amount как expected_amount в /v1/transaction/new, чтобы списалась ровно эта сумма, — необязательно, но рекомендуется для такого заказа.

POST /v1/transaction/quote

Запрос

Тело запроса — то же, что у Создания транзакции: service, params (и external_id, который здесь игнорируется). Оно проверяется в том же порядке и с теми же кодами ошибок.

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

Ответ

Поле	Тип	Описание
result.service	string	Сервис, для которого рассчитана цена
result.amounts	object|null	Рассчитанные количества ресурсов
result.duration	integer	Длительность в часах
result.amount	string	Итог в TRX — все части и активация, если она включена
result.activation	boolean	Включает ли итог активацию адреса
result.parts	array|null	Части крупного заказа энергии: у каждой resource_amount и amount (TRX); null для заказа, выполняемого одной частью

{
  "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" }
    ]
  }
}

Котировка — это снимок момента, а не резерв: цены меняются. Если затем заказ будет стоить иначе, /v1/transaction/new с expected_amount отклонит его с кодом 409 price_moved и ничего не спишет.

Этот эндпоинт расходует тот же лимит запросов цены, что и Расчет стоимости ресурсов и Расчет энергии.

Возможные ошибки

Ошибки Создания транзакции, возникающие до оплаты: 1, 2, 10, 11, 12, 24, 25, 35, 50, 429, когда лимит запросов цены исчерпан, 503 temporarily_unavailable, когда сеть TRON не ответила вовремя на проверку адреса (HTTP 503, с заголовком Retry-After; повторите запрос через несколько секунд), а также 500.