> ## 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 на адресе не опускаются ниже выбранного вами уровня ## Автопополнение Автопополнение следит за адресом TRON и пополняет его, как только энергия или bandwidth опускаются ниже заданного вами уровня. Вы выбираете **порог**, сколько **добавлять** за раз и **срок** аренды. Каждое пополнение — обычный заказ, оплаченный с вашего баланса. ### Как это работает 1. Создайте правило для адреса: порог, `add_volume` и `duration`. 2. Мы проверяем, сколько энергии (или bandwidth) доступно на адресе, **раз в минуту** и **сразу после каждого исходящего перевода USDT** с этого адреса. 3. Если уровень ниже порога, мы покупаем для адреса `add_volume` и списываем стоимость с вашего баланса по вашей цене. 4. Аренда заканчивается по истечении срока. Когда уровень снова опускается ниже порога, правило покупает снова. Так правило и держит адрес обеспеченным: отдельного шага продления нет. Если проверке не удаётся прочитать адрес, она ничего не покупает; правило показывает время такой проверки в `last_read_error_at`, а следующая проверка пробует снова. Создание правила само ничего не покупает. Первое пополнение происходит при следующей проверке, обычно в течение минуты. Ответ на создание показывает, будет ли оно (`will_refill_now`), и сколько ресурса на адресе прямо сейчас. > [!NOTE] > > Автопополнение реагирует на уже упавший уровень, а не срабатывает заранее, перед переводом. Ставьте порог не ниже того, что нужно вашей следующей транзакции, — тогда к моменту отправки она уже будет покрыта. ### Энергия и bandwidth У двух ресурсов свои эндпоинты и свои правила. На одном адресе могут одновременно действовать правило для энергии и правило для bandwidth; каждое сверяется со своим порогом. | | Энергия | Bandwidth | | - | - | - | | Эндпоинты | `/api/v1/energy/auto-refill` | `/api/v1/bandwidth/auto-refill` | | Поле порога | `threshold_energy`, 1 – 50 000 000 | `threshold_bandwidth`, 1 – 1 000 000 | | `add_volume` за одно пополнение | 32 000 – 5 000 000 | 350 – 100 000 | | `duration` | только `1h` | `1h` или `1d` | | С чем сравнивается порог | Доступная энергия | Весь доступный bandwidth, **включая бесплатные 600 в сутки** | | Скоуп для создания, изменения, удаления | `buy_energy` | `buy_bandwidth` | | Скоуп для просмотра списка и расчёта цены | `view` | `view` | **Энергия** арендуется на один час. Когда она израсходована или срок истёк, уровень падает, и правило покупает следующий час. **Bandwidth** учитывает всё, чем адрес может оплатить транзакцию: бесплатные 600 bandwidth в сутки, которые получает каждый аккаунт, плюс любой застейканный или делегированный bandwidth. Поэтому порог 600 или ниже выполняется за счёт одного лишь бесплатного лимита, пока адрес его не израсходует. ### Как выбрать значения > [!WARNING] > > **Держите `add_volume` не ниже порога.** Пополнение добавляет `add_volume` к тому, что осталось на адресе. Если `add_volume` меньше порога, одно пополнение почти пустого адреса может оставить его ниже порога — и правило будет покупать снова после каждой траты: до нескольких раз в минуту, а не раз в час. Каждое такое пополнение — полноценный заказ со своей фиксированной комиссией. В ответах с правилами этот случай отмечен флагом `volume_below_threshold: true`. Перевод USDT расходует около 65 000 энергии, если у получателя уже есть USDT, и около 131 000, если нет, плюс примерно 345 bandwidth. Например, `threshold_energy: 65000` с `add_volume: 131000` покупает запас на два перевода всякий раз, когда остаётся меньше чем на один. ### Стоимость Каждое пополнение — обычный заказ: аренда по вашей ставке плюс **фиксированная комиссия, которая берётся за каждое пополнение**. `estimated_cost_per_refill_trx` в ответах списка и создания — полная цена одного пополнения для вашего аккаунта, включая фиксированную комиссию. Чтобы узнать эту цену до создания правила, используйте эндпоинт расчёта цены: [энергия](/ru/api-reference/auto-refill/quote-energy-refill), [bandwidth](/ru/api-reference/auto-refill/quote-bandwidth-refill). Маленький `add_volume` с частыми пополнениями платит фиксированную комиссию много раз; крупный — реже. Правило, созданное с API-ключом, тарифицируется как покупка через этот API-ключ; правило, созданное на сайте, — как покупка на сайте. `estimated_cost_per_refill_trx` это уже учитывает. Если адреса ещё нет в сети, первое пополнение заодно активирует его — так же, как обычная покупка. Активация оплачивается сверх и не входит в `estimated_cost_per_refill_trx`; в заказе она указана в `activation_cost_trx`. Суточного лимита расходов нет: правило покупает всякий раз, когда уровень ниже порога и вашего баланса хватает на пополнение. ### Заказы и вебхуки Каждое пополнение появляется в истории заказов ([Список заказов](/ru/api-reference/orders/list-orders)) с `source: "autorefill"`. Чтобы получить только заказы пополнения, вызовите `GET /orders?source=autorefill`; чтобы выгрузить их файлом, используйте [отчёт](/api-reference/account/reports) `autorefill`. Правила, созданные с API-ключом, отправляют [вебхуки `order.updated`](/ru/api-reference/webhooks/overview) по своим заказам пополнения — так же, как заказы, оформленные через API. Правила, созданные без API-ключа, их не отправляют. ### Статус правила | `status` | Значение | | - | - | | `active` | Правило проверяет адрес и покупает, когда нужно | | `paused` | Правило ничего не делает, пока вы его не возобновите. Ставится вами — или нами, если пополнения раз за разом не проходят, — см. `stopped_reason` | | `stopped_insufficient_balance` | Баланса не хватило на следующее пополнение. Правило возобновится само после депозита | **Пауза после сбоев.** Деньги за неудавшееся пополнение возвращаются, как за любой неудавшийся заказ. После **5 неудачных пополнений подряд** правило ставится на паузу, а `stopped_reason` указывает причину последнего сбоя. `consecutive_failures` показывает, насколько правило близко к этому пределу; счётчик сбрасывается в 0 после успешного пополнения и при возобновлении правила. Правило на паузе никогда не возобновляется само: устраните причину, затем установите `status: "active"`. **Остановка из-за баланса.** Когда баланса не хватает на одно пополнение, правило останавливается со статусом `stopped_insufficient_balance`. Как только депозит поднимет баланс до цены одного пополнения, правило автоматически вернётся в `active`. Можно и самому установить `status: "active"`; если баланса всё ещё не хватает, правило снова остановится при следующей проверке. | `stopped_reason` | Значение | | - | - | | `insufficient_balance` | Баланса не хватило на одно пополнение | | `order_failed` | Заказы пополнения не прошли 5 раз подряд | | `activation_failed` | Активация адреса не прошла 5 раз подряд | | `invalid_params` | Объём или срок правила больше не принимаются (пауза сразу, без 5 попыток) — измените правило, затем возобновите | | `null` | Остановок не зафиксировано | Если к аккаунту привязан Telegram, вы получите сообщение при первом пополнении по правилу, а также когда правило ставится на паузу, останавливается из-за баланса или возобновляется. ### Лимиты * **Одно правило на адрес и ресурс** в аккаунте. Попытка создать второе правило для энергии (или второе правило для bandwidth) на тот же адрес вернёт `409 AUTOREFILL_ADDRESS_TAKEN` — вместо этого измените существующее правило. * **20 правил для энергии и 20 правил для bandwidth** на аккаунт. Удалённые правила не считаются. Сверх лимита: `409 AUTOREFILL_LIMIT_REACHED`. * **Адреса контрактов не принимаются**, например контракт токена USDT: TRON не позволяет делегировать им ресурсы. * **Создание правил** ограничено 10 запросами в минуту на аккаунт, для каждого ресурса отдельно. См. [Лимиты запросов](/ru/resources/rate-limits). ### Изменение и удаление Изменения действуют со следующей проверки. Пока по правилу покупается пополнение, `PATCH` и `DELETE` возвращают `409 AUTOREFILL_IN_PROGRESS` — повторите через минуту. Удаление правила не забирает уже купленные энергию или bandwidth: эти аренды действуют до конца своего срока. ### Сравнение со Smart Mode и арендой с автопродлением | | Автопополнение | [Smart Mode](/ru/api-reference/smart-mode/overview) | [Аренда с автопродлением](/ru/api-reference/bandwidth-rentals/create-rental) | | - | - | - | - | | Ресурс | Энергия или bandwidth | Энергия, плюс bandwidth по желанию | Bandwidth | | Когда доставляет | Когда уровень падает ниже вашего порога | При каждом исходящем переводе USDT | Делегируется один раз и держится, пока идёт аренда | | За что вы платите | За каждое пополнение, как за обычный заказ | Суточная подписка плюс каждый перевод USDT | Раз в сутки | | Что покрывает | Любые траты — USDT, TRX, вызовы контрактов | Переводы USDT | Постоянную потребность в bandwidth | ### Эндпоинты | Действие | Энергия | Bandwidth | | - | - | - | | Цена одного пополнения | [`GET /energy/auto-refill/quote`](/ru/api-reference/auto-refill/quote-energy-refill) | [`GET /bandwidth/auto-refill/quote`](/ru/api-reference/auto-refill/quote-bandwidth-refill) | | Создать правило | [`POST /energy/auto-refill`](/ru/api-reference/auto-refill/create-energy-rule) | [`POST /bandwidth/auto-refill`](/ru/api-reference/auto-refill/create-bandwidth-rule) | | Список правил | [`GET /energy/auto-refill`](/ru/api-reference/auto-refill/list-energy-rules) | [`GET /bandwidth/auto-refill`](/ru/api-reference/auto-refill/list-bandwidth-rules) | | Изменить, приостановить, возобновить | [`PATCH /energy/auto-refill/{rule_id}`](/ru/api-reference/auto-refill/update-energy-rule) | [`PATCH /bandwidth/auto-refill/{rule_id}`](/ru/api-reference/auto-refill/update-bandwidth-rule) | | Удалить | [`DELETE /energy/auto-refill/{rule_id}`](/ru/api-reference/auto-refill/delete-energy-rule) | [`DELETE /bandwidth/auto-refill/{rule_id}`](/ru/api-reference/auto-refill/delete-bandwidth-rule) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.