Авто-bandwidth
Подписка Авто-bandwidth держит на вашем адресе TRON делегированным фиксированный объём bandwidth, чтобы переводы с этого адреса не сжигали TRX на bandwidth. Когда перевод расходует делегированный bandwidth, мы сразу обновляем его. Даты окончания нет: подписка работает, пока вы не поставите её на паузу или не удалите.Как это работает
- Создайте подписку для адреса с
volume— объёмом bandwidth, который нужно держать на адресе; для одного перевода USDT это около 350. - Мы делегируем на адрес
volumebandwidth и списываем комиссию за первые 24 часа. - Мы проверяем адрес раз в минуту и сразу после каждого исходящего перевода USDT с него. Переводы TRX, USDD и других токенов подхватываются проверкой раз в минуту.
- Когда перевод израсходовал делегированный нами bandwidth, мы списываем одну комиссию за перевод и снова делегируем
volume.
Стоимость
Обе комиссии равны цене заказа bandwidth объёмом
volume на один час для вашего аккаунта: bandwidth по вашей ставке плюс фиксированная комиссия. transfer_bw_trx и transfer_fee_trx показывают эту разбивку. Подписка, созданная с API-ключом, тарифицируется как покупка через этот API-ключ; созданная на сайте — как покупка на сайте. Чтобы узнать цену до подписки, используйте Расчёт цены Авто-bandwidth.
- Перевод, полностью оплаченный из бесплатного bandwidth адреса или его собственного стейка, наш bandwidth не трогает, и комиссии за такой перевод нет.
- Пока подписка на паузе, остановлена или на авто-паузе, комиссия за подписку не списывается.
- Увеличение
volumeвнутри оплаченных суток списывает разницу за остаток этих суток. Уменьшение не возвращается. - Если адреса ещё нет в сети, первая делегация заодно активирует его, и активация списывается сверху.
Баланс
Перед каждой делегацией баланса должно хватать на одну комиссию за перевод плюс комиссию за подписку, если текущие сутки ещё не оплачены. Если не хватает, подписка останавливается соstatus: "stopped_balance", и мы забираем bandwidth обратно. Она возобновится сама после депозита, покрывающего сутки и один перевод. Если к аккаунту привязан Telegram, при остановке вы получите сообщение.
Создание или повторное включение подписки заранее проверяет ту же сумму и при нехватке баланса возвращает 402 INSUFFICIENT_BALANCE, а суммы указаны в error.required_trx и error.available_trx.
Статус
delivery_state показывает, как прошла последняя делегация: ok, waiting_stake (bandwidth временно недоступен для делегации — мы повторяем попытку, ничего не списывается) или failed (делегация не прошла — мы повторяем попытку).
Параметры
Токен.token указывает, какой токен отправляет адрес: USDT, TRX, USDD, CUSTOM (ваш собственный токен TRC-20, указанный в contract) или OWN (ваш собственный volume, при желании с contract). Он не ограничивает то, что мы покрываем: обновляется любой перевод, израсходовавший наш bandwidth. Он задаёт токен для stop_after_transfer, а в личном кабинете подсказывает volume: 350 для USDT и USDD, 300 для TRX. Для собственного токена сначала добавьте его контракт; в ответе указано, сколько bandwidth занимает один его перевод.
Авто-пауза. При auto_pause: true мы не держим bandwidth, пока бесплатный суточный bandwidth адреса (600 на аккаунт) не меньше threshold, и подписка показывает free_bw. Тогда threshold должен быть от большего из volume и 345 до 600.
Уведомление о бесплатном bandwidth. При notify_free_bw: true мы отправляем сообщение в ваш Telegram и на email каждый раз, когда бесплатный bandwidth адреса восстанавливается до threshold после падения ниже него. Используются тот же threshold и тот же диапазон, но без авто-паузы при volume больше 600 допускается threshold: 600.
Остановка после следующего перевода. При stop_after_transfer: true первый перевод токена подписки, отправленный после установки флага, ставит подписку на паузу с stopped_reason: "transfer". Этот перевод всё равно покрывается.
Смена адреса. Если в Изменении подписки указать новый address, подписка переезжает: мы забираем bandwidth со старого адреса, затем делегируем на новый. Пока перенос не завершён, address_change_to показывает новый адрес.
Лимиты
- Одна подписка на адрес в аккаунте. Вторая для того же адреса вернёт
409 AUTO_BW_ADDRESS_TAKEN. - Число подписок на аккаунт не ограничено — ни активных, ни на паузе.
- 20 контрактов токенов в вашем списке. Сверх лимита:
409 AUTO_BW_CONTRACT_LIMIT. - Адреса контрактов не принимаются, например контракт токена USDT: TRON не позволяет делегировать им ресурсы.
- Адреса, уже покрытые bandwidth из Smart Mode или пакетом переводов с bandwidth, не принимаются:
409 AUTO_BW_ADDRESS_COVERED. - Лимиты запросов на создание и изменение подписок и на добавление контрактов — см. Лимиты запросов.
503 AUTO_BW_DISABLED. Ничего не создаётся и не меняется — повторите позже.
Сравнение с автопополнением и Smart Mode
Эндпоинты
Для создания, изменения и удаления подписок и контрактов нужен скоуп
buy_bandwidth; для просмотра списков и расчёта цены — view.