Перейти к основному содержанию
POST
Создать подписку

Создать подписку

Создаёт подписку Авто-bandwidth для одного адреса. Начиная со следующей проверки — обычно в течение нескольких секунд — мы держим на адресе делегированными volume bandwidth и обновляем их после каждого перевода, который их израсходовал. Как устроены обновление, стоимость и статусы, — в обзоре. Сам запрос ничего не списывает, но баланса должно хватать на первые 24 часа и один перевод — плюс активацию, если адреса ещё нет в сети, — иначе вернётся 402 INSUFFICIENT_BALANCE. Нужен скоуп buy_bandwidth. Чтобы сначала узнать цену, используйте Расчёт цены Авто-bandwidth.

Тело запроса

string
обязательно
Адрес TRON, на котором нужно держать bandwidth, — адрес, отправляющий переводы (формат T…, 34 символа). Адреса контрактов отклоняются.
number
по умолчанию:"350"
Bandwidth, который нужно держать на адресе. От 1 до 5 000. Один перевод USDT или USDD занимает около 345, перевод TRX — около 270.
string
по умолчанию:"USDT"
Токен, который отправляет адрес: "USDT", "TRX", "USDD", "CUSTOM" или "OWN". Он не ограничивает, какие переводы покрываются, — см. Токен.
string
Адрес контракта TRC-20 из вашего списка токенов. Обязателен с token: "CUSTOM", необязателен с "OWN", с остальными токенами не принимается.
string
Ваше собственное название подписки, до 50 символов. Необязательно.
boolean
по умолчанию:"false"
Не держать bandwidth, пока на адресе бесплатного bandwidth не меньше threshold.
number
по умолчанию:"600"
Уровень бесплатного bandwidth для auto_pause и notify_free_bw. От 1 до 600; если включена любая из этих опций, он должен быть от большего из volume и 345 до 600. Без auto_pause при volume больше 600 допускается 600.
boolean
по умолчанию:"false"
Отправлять сообщение в Telegram и на email каждый раз, когда бесплатный bandwidth адреса восстанавливается до threshold.
boolean
по умолчанию:"false"
Поставить подписку на паузу после следующего перевода её токена.

Ответ

Новая подписка — с теми же полями, что в Списке подписок. Сразу после создания delegated_bw равен 0, а paid_until — null: первая делегация следует в течение нескольких секунд.

Пример

Response

Ошибки

Повторять создание после таймаута безопасно. Если первый запрос прошёл, повтор вернёт 409 AUTO_BW_ADDRESS_TAKEN, а не создаст вторую подписку; чтобы узнать её id, запросите список подписок.