Skip to main content
GET
Рассчитать цену

Рассчитать цену

Возвращает точную сумму, которая будет списана за указанный объём энергии — аренда и фиксированная комиссия вместе, по вашей ставке. Эндпоинт публичный — аутентификация не обязательна. Передайте свой API-ключ, чтобы получить свою цену; без него вернётся публичная рыночная.
Используйте этот эндпоинт, когда нужна цена под конкретный объём. GET /api/v1/prices всегда считает на 65 000 единиц и параметров не принимает, а POST /api/v1/energy/estimate возвращает только аренду по рыночной цене, игнорируя ваш ключ.

Параметры запроса

integer
обязательно
Объём энергии для расчёта. От 60 000 до 5 000 000.
string
по умолчанию:"1h"
Срок аренды. Для энергии поддерживается только 1h.

Заголовки

string
Необязательный. С действующим ключом ответ отражает вашу согласованную ставку и вашу комиссию. Отсутствующий, неверный или отозванный ключ — не ошибка: вы просто получите публичную рыночную цену.

Ответ

number
Объём энергии, для которого рассчитана котировка
string
Срок аренды (1h)
string
Ставка в SUN за 1 единицу энергии. По ней можно посчитать любой другой объём самостоятельно: аренда = объём × price_sun / 1 000 000
string
Стоимость аренды для этого объёма, без фиксированной комиссии
string
Фиксированная комиссия, берётся один раз за заказ независимо от объёма. Отражает вашу комиссию, если для аккаунта настроена индивидуальная ставка, скидка или её снятие.
string
Сумма, которая будет списана: rental_trx + fixed_fee_trx
string | null
Та же сумма в USD. null, если курс TRX/USD временно недоступен — значения в TRX при этом остаются верными.
boolean
true, если применилась ваша согласованная ставка, false — если котировка по публичной рыночной цене. Проверяйте это поле: забытый заголовок X-API-Key иначе выглядит как обычный ответ, и вы будете показывать клиентам публичную цену, а списываться будет ваша.

Пример

Значения ниже — пример. У энергии есть рыночная цена, и она меняется в течение суток.
Response

Типовые объёмы

Каталога пакетов нет — подходит любой объём от 60 000 до 5 000 000, и фиксированная комиссия в любом случае берётся один раз за заказ. Два перевода одному получателю дешевле оформить одним заказом на 131 000, чем двумя по 65 000: комиссия платится один раз вместо двух.

Ошибки

Неверный или отозванный X-API-Key здесь не ошибка: котировка вернётся по публичной рыночной цене с personal_price: false.