Перейти к основному содержанию
GET
Рассчитать цену bandwidth

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

Возвращает точную сумму, которая будет списана за заказ bandwidth такого объёма и срока, — аренда и фиксированная комиссия вместе, по вашей ставке. Котировка рассчитывается тем же кодом, который списывает оплату за заказ, поэтому, пока цена не изменилась, покупка стоит ровно total_trx. Эндпоинт публичный — аутентификация не обязательна. Передайте свой API-ключ, чтобы получить котировку по своей ставке и своей фиксированной комиссии; без него вернётся публичная цена.
Покажите total_trx пользователю и передайте его как max_price_trx в Купить bandwidth. Если цена изменится между котировкой и покупкой, покупка будет отклонена с 409 PRICE_CHANGED и ничего не спишется — запросите котировку заново и повторите.

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

integer
обязательно
Объём bandwidth для расчёта. От 1 до 100 000.
string
по умолчанию:"1h"
Срок аренды: 1h, 1d или целое число минут от 5m до 59m — те же значения, что и в Купить bandwidth.

Заголовки

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

Ответ

number
Объём bandwidth, для которого рассчитана котировка
string
Срок аренды, для которого рассчитана котировка
string
Ставка в SUN за 1 единицу bandwidth, округлённая до 0.01 для отображения. На минутные сроки действует скидка, поэтому их ставка дробная, а суммы ниже рассчитаны по точной ставке — берите total_trx, а не умножайте это округлённое значение сами.
string
Стоимость аренды для этого объёма и срока, без фиксированной комиссии
string
Фиксированная комиссия, берётся один раз за заказ независимо от объёма и срока. Отражает вашу комиссию, если для аккаунта настроена индивидуальная комиссия, скидка или её снятие.
string
Сумма, которая будет списана: rental_trx + fixed_fee_trx. Передайте её как max_price_trx в Купить bandwidth.
boolean
true, если применилась ваша согласованная ставка, false — если котировка по публичной цене. Проверяйте это поле: забытый заголовок X-API-Key иначе выглядит как обычный ответ, и вы будете показывать клиентам публичную цену, а списываться будет ваша.

Пример

Значения ниже — пример, при price_sun_1h, равном 400, и short_max_discount_pct, равном 5. Актуальные ставки и скидка — в Получить цены bandwidth.
Response

Что не входит в котировку

Котировка — как и max_price_trx — распространяется только на заказ bandwidth. Если целевой адрес ещё не активирован on-chain, Купить bandwidth активирует его и списывает активацию сверх (activation_cost_trx в ответе). Это списание не входит в total_trx и не сверяется с max_price_trx.

Действия от имени другого аккаунта: GET /v1/bandwidth/quote/me

/bandwidth/quote считает цену для владельца API-ключа. Если ваш ключ действует от имени другого аккаунта через заголовок X-Account-Id, покупка списывается по ставке и комиссии этого аккаунта — котировка может отличаться от списания, а max_price_trx, взятый из неё, может быть отклонён с 409 PRICE_CHANGED. В этом случае используйте GET /v1/bandwidth/quote/me. Он принимает те же параметры запроса и возвращает тот же ответ, но аутентификация обязательна, а аккаунт определяется ровно так же, как при покупке, включая X-Account-Id. Для него нужен скоуп view, который всегда есть у любого ключа.
cURL

Ошибки

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