Auto Bandwidth
An Auto Bandwidth subscription keeps a fixed amount of bandwidth delegated to your TRON address, so that the address’s transfers do not burn TRX for bandwidth. When a transfer uses up the delegated bandwidth, we renew it right away. There is no end date: the subscription runs until you pause or delete it.How it works
- Create a subscription for an address with the
volumeof bandwidth to keep there — for one USDT transfer that is about 350. - We delegate
volumebandwidth to the address and charge the fee for the first 24 hours. - We check the address once a minute, and right after every outgoing USDT transfer from it. Transfers of TRX, USDD or other tokens are picked up by the minute check.
- When a transfer has used up the bandwidth we delegated, we charge one transfer fee and delegate
volumeagain.
Cost
Both fees equal the price of a one-hour bandwidth order of
volume for your account: the bandwidth at your rate plus the fixed fee. transfer_bw_trx and transfer_fee_trx show that split. A subscription created with an API key is priced like a purchase made with that key; one created on the website, like a website purchase. To see the price before you subscribe, use Auto Bandwidth Quote.
- A transfer paid entirely from the address’s free bandwidth or its own stake does not touch our bandwidth, and there is no transfer fee for it.
- No subscription fee is charged while the subscription is paused, stopped or on auto-pause.
- Raising
volumewithin a paid day charges the difference for the rest of that day. Lowering it is not refunded. - If the address does not exist on-chain yet, the first delegation also activates it, and the activation is charged on top.
Balance
Before every delegation your balance must cover one transfer fee, plus the subscription fee if the current day is not paid yet. When it does not, the subscription stops withstatus: "stopped_balance" and we take the bandwidth back. It resumes on its own after a deposit that covers a day and a transfer. If your Telegram account is linked, you get a message when it stops.
Creating or switching a subscription back on checks the same amount up front and returns 402 INSUFFICIENT_BALANCE when the balance is short, with the amounts in error.required_trx and error.available_trx.
Status
delivery_state shows how the last delegation went: ok, waiting_stake (bandwidth is temporarily not available to delegate — we retry, nothing is charged) or failed (the delegation did not go through — we retry).
Options
Token.token tells which token the address sends: USDT, TRX, USDD, CUSTOM (a TRC-20 token of your own, set in contract) or OWN (your own volume, optionally with a contract). It does not limit what we cover — any transfer that uses up our bandwidth is renewed. It sets the token for stop_after_transfer, and in the dashboard it suggests a volume: 350 for USDT and USDD, 300 for TRX. For a token of your own, add its contract first; the response tells how much bandwidth one transfer of it takes.
Auto-pause. With auto_pause: true we hold no bandwidth while the address’s free daily bandwidth (600 per account) is at least threshold, and the subscription shows free_bw. threshold must then be between the larger of volume and 345, and 600.
Free bandwidth notification. With notify_free_bw: true we send a message to your Telegram and email each time the address’s free bandwidth recovers to threshold after falling below it. It uses the same threshold and the same range, except that without auto-pause a volume above 600 allows threshold: 600.
Stop after the next transfer. With stop_after_transfer: true the first transfer of the subscription’s token sent after you set it pauses the subscription with stopped_reason: "transfer". That transfer is still covered.
Changing the address. Setting a new address in Update Subscription moves the subscription: we take the bandwidth back from the old address, then delegate to the new one. Until the move is done, address_change_to shows the new address.
Limits
- One subscription per address on an account. A second one for the same address returns
409 AUTO_BW_ADDRESS_TAKEN. - No limit on the number of subscriptions per account, active or paused.
- 20 token contracts in your list. Over the limit:
409 AUTO_BW_CONTRACT_LIMIT. - No contract addresses, such as the USDT token contract: TRON does not allow delegating resources to them.
- No addresses already covered by Smart Mode bandwidth or a transfer package with bandwidth:
409 AUTO_BW_ADDRESS_COVERED. - Request limits on creating and editing subscriptions and on adding contracts — see Rate Limits.
503 AUTO_BW_DISABLED. Nothing is created or changed — try again later.
Compared with Auto Refill and Smart Mode
Endpoints
Creating, editing and deleting subscriptions and contracts requires the
buy_bandwidth scope; listing and quotes require view.