> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор Авто-bandwidth

> Bandwidth на адресе для каждого перевода, с обновлением после каждого из них

## Авто-bandwidth

Подписка Авто-bandwidth держит на вашем адресе TRON делегированным фиксированный объём bandwidth, чтобы переводы с этого адреса не сжигали TRX на bandwidth. Когда перевод расходует делегированный bandwidth, мы сразу обновляем его. Даты окончания нет: подписка работает, пока вы не поставите её на паузу или не удалите.

### Как это работает

1. Создайте подписку для адреса с `volume` — объёмом bandwidth, который нужно держать на адресе; для одного перевода USDT это около 350.
2. Мы делегируем на адрес `volume` bandwidth и списываем комиссию за первые 24 часа.
3. Мы проверяем адрес **раз в минуту** и **сразу после каждого исходящего перевода USDT** с него. Переводы TRX, USDD и других токенов подхватываются проверкой раз в минуту.
4. Когда перевод израсходовал делегированный нами bandwidth, мы списываем одну комиссию за перевод и снова делегируем `volume`.

Обновление занимает около двух блоков (примерно 6 секунд). Второй перевод, отправленный до того, как обновление дойдёт, оплачивается из бесплатного bandwidth адреса, а если его не хватает — сжигает TRX.

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

### Стоимость

| Комиссия | Когда списывается | Поля ответа |
| - | - | - |
| Комиссия за подписку (за 24 часа) | Заранее, при делегации bandwidth, и затем каждые 24 часа, пока он остаётся на адресе | `daily_trx` |
| Комиссия за перевод | Один раз за каждую делегацию, которую перевод израсходовал | `transfer_trx` = `transfer_bw_trx` + `transfer_fee_trx` |

Обе комиссии равны цене заказа bandwidth объёмом `volume` на один час для вашего аккаунта: bandwidth по вашей ставке плюс фиксированная комиссия. `transfer_bw_trx` и `transfer_fee_trx` показывают эту разбивку. Подписка, созданная с API-ключом, тарифицируется как покупка через этот API-ключ; созданная на сайте — как покупка на сайте. Чтобы узнать цену до подписки, используйте [Расчёт цены Авто-bandwidth](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/quote.md).

* Перевод, полностью оплаченный из бесплатного bandwidth адреса или его собственного стейка, наш bandwidth не трогает, и комиссии за такой перевод нет.
* Пока подписка на паузе, остановлена или на авто-паузе, комиссия за подписку не списывается.
* Увеличение `volume` внутри оплаченных суток списывает разницу за остаток этих суток. Уменьшение не возвращается.
* Если адреса ещё нет в сети, первая делегация заодно активирует его, и активация списывается сверху.

### Баланс

Перед каждой делегацией баланса должно хватать на одну комиссию за перевод плюс комиссию за подписку, если текущие сутки ещё не оплачены. Если не хватает, подписка останавливается со `status: "stopped_balance"`, и мы забираем bandwidth обратно. Она возобновится сама после депозита, покрывающего сутки и один перевод. Если к аккаунту привязан Telegram, при остановке вы получите сообщение.

Создание или повторное включение подписки заранее проверяет ту же сумму и при нехватке баланса возвращает `402 INSUFFICIENT_BALANCE`, а суммы указаны в `error.required_trx` и `error.available_trx`.

### Статус

| `status` | Значение |
| - | - |
| `active` | Мы держим bandwidth на адресе и обновляем его после каждого перевода |
| `free_bw` | Авто-пауза: на адресе бесплатного bandwidth не меньше `threshold`, поэтому мы ничего не держим и ничего не списываем. Когда бесплатный bandwidth упадёт ниже `threshold`, мы снова делегируем |
| `paused` | Выключена — вами, переводом (см. `stop_after_transfer`) или поддержкой. Ничего не держится и не списывается |
| `stopped_balance` | Баланса не хватило на следующую делегацию. Возобновится сама после депозита |

| `stopped_reason` | Значение |
| - | - |
| `insufficient_balance` | Остановлена из-за баланса |
| `transfer` | Поставлена на паузу переводом токена подписки, потому что был включён `stop_after_transfer` |
| `admin` | Выключена поддержкой; самостоятельно включить её обратно нельзя — свяжитесь с нами |
| `null` | Остановок не зафиксировано, либо подписку приостановили вы |

`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. Для собственного токена сначала [добавьте его контракт](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/add-contract.md); в ответе указано, сколько 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"`. Этот перевод всё равно покрывается.

**Смена адреса.** Если в [Изменении подписки](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/update-subscription.md) указать новый `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`.
* **Лимиты запросов** на создание и изменение подписок и на добавление контрактов — см. [Лимиты запросов](https://docs.tronrental.com/ru/resources/rate-limits.md).

Если Авто-bandwidth временно выключен, создание подписки, её включение и добавление контракта возвращают `503 AUTO_BW_DISABLED`. Ничего не создаётся и не меняется — повторите позже.

### Сравнение с автопополнением и Smart Mode

| | Авто-bandwidth | [Автопополнение bandwidth](https://docs.tronrental.com/ru/api-reference/auto-refill/overview.md) | [Smart Mode](https://docs.tronrental.com/ru/api-reference/smart-mode/overview.md) |
| - | - | - | - |
| Ресурс | Bandwidth | Bandwidth (или энергия) | Энергия, плюс bandwidth по желанию |
| Когда доставляет | Держится на адресе, обновляется после каждого перевода, который его расходует | Когда уровень падает ниже вашего порога | При каждом исходящем переводе USDT |
| За что вы платите | Комиссия за 24 часа плюс комиссия за каждую израсходованную делегацию | За каждое пополнение, как за обычный заказ | Суточная подписка плюс каждый перевод USDT |

### Эндпоинты

| Действие | Эндпоинт |
| - | - |
| Цена суток и одного перевода | [`GET /bandwidth/auto/quote`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/quote) |
| Создать подписку | [`POST /bandwidth/auto`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/create-subscription) |
| Список подписок | [`GET /bandwidth/auto`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/list-subscriptions) |
| Изменить, приостановить, возобновить, сменить адрес | [`PATCH /bandwidth/auto/{sub_id}`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/update-subscription) |
| Удалить | [`DELETE /bandwidth/auto/{sub_id}`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/delete-subscription) |
| Ваши контракты токенов | [`GET /bandwidth/auto/contracts`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/list-contracts) |
| Добавить контракт токена | [`POST /bandwidth/auto/contracts`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/add-contract) |
| Удалить контракт токена | [`DELETE /bandwidth/auto/contracts/{address}`](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/delete-contract) |

Для создания, изменения и удаления подписок и контрактов нужен скоуп `buy_bandwidth`; для просмотра списков и расчёта цены — `view`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.