> ## 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.

# ऑटो बैंडविड्थ अवलोकन

> हर ट्रांसफर के लिए एड्रेस पर बैंडविड्थ बनाए रखें, और हर ट्रांसफर के बाद उसे रिन्यू करें

## ऑटो बैंडविड्थ

ऑटो बैंडविड्थ सब्सक्रिप्शन आपके TRON एड्रेस पर बैंडविड्थ की एक तय मात्रा डेलिगेट रखता है, ताकि एड्रेस के ट्रांसफर बैंडविड्थ के लिए TRX न जलाएं। जब कोई ट्रांसफर डेलिगेट की गई बैंडविड्थ खर्च कर देता है, तो हम उसे तुरंत रिन्यू कर देते हैं। कोई समाप्ति तिथि नहीं है: सब्सक्रिप्शन तब तक चलता है जब तक आप उसे रोकें या हटाएं नहीं।

### यह कैसे काम करता है

1. किसी एड्रेस के लिए सब्सक्रिप्शन बनाएं और `volume` में वहाँ रखी जाने वाली बैंडविड्थ बताएं — एक USDT ट्रांसफर के लिए यह लगभग 350 है।
2. हम एड्रेस पर `volume` बैंडविड्थ डेलिगेट करते हैं और पहले 24 घंटों का शुल्क लेते हैं।
3. हम एड्रेस की जाँच **हर मिनट एक बार** करते हैं, और उस एड्रेस से **हर आउटगोइंग USDT ट्रांसफर के तुरंत बाद**। TRX, USDD या अन्य टोकन के ट्रांसफर मिनट की जाँच में पकड़े जाते हैं।
4. जब कोई ट्रांसफर हमारी डेलिगेट की गई बैंडविड्थ खर्च कर देता है, तो हम एक ट्रांसफर शुल्क लेते हैं और `volume` फिर से डेलिगेट करते हैं।

रिन्यूअल में लगभग दो ब्लॉक (करीब 6 सेकंड) लगते हैं। रिन्यूअल पहुँचने से पहले भेजा गया दूसरा ट्रांसफर एड्रेस की मुफ़्त बैंडविड्थ से चुकाया जाता है, और वह पर्याप्त न हो तो TRX जलता है।

सब्सक्रिप्शन बनाने वाले अनुरोध में खुद कोई शुल्क नहीं लगता: हम जाँचते हैं कि आपका बैलेंस पहले दिन और एक ट्रांसफर को कवर करता है, और पहली डेलिगेशन अगली जाँच पर होती है, आमतौर पर कुछ सेकंड में।

### लागत

| शुल्क | कब लिया जाता है | रिस्पॉन्स फ़ील्ड |
| - | - | - |
| सब्सक्रिप्शन शुल्क (प्रति 24 घंटे) | पहले से, जब बैंडविड्थ डेलिगेट की जाती है, और उसके बाद हर 24 घंटे जब तक वह एड्रेस पर रहती है | `daily_trx` |
| ट्रांसफर शुल्क | हर उस डेलिगेशन के लिए एक बार जिसे कोई ट्रांसफर खर्च कर चुका हो | `transfer_trx` = `transfer_bw_trx` + `transfer_fee_trx` |

दोनों शुल्क आपके खाते के लिए `volume` के एक घंटे के बैंडविड्थ ऑर्डर की कीमत के बराबर हैं: आपकी दर पर बैंडविड्थ और साथ में फिक्स्ड शुल्क। `transfer_bw_trx` और `transfer_fee_trx` यही बंटवारा दिखाते हैं। API कुंजी से बनाए गए सब्सक्रिप्शन की कीमत उस कुंजी से की गई खरीद जैसी होती है; वेबसाइट पर बनाए गए की, वेबसाइट की खरीद जैसी। सब्सक्राइब करने से पहले कीमत देखने के लिए [ऑटो बैंडविड्थ मूल्य अनुमान](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/quote.md) का उपयोग करें।

* जो ट्रांसफर पूरी तरह एड्रेस की मुफ़्त बैंडविड्थ या उसके अपने स्टेक से चुकता है, वह हमारी बैंडविड्थ को नहीं छूता, और उसका कोई ट्रांसफर शुल्क नहीं है।
* सब्सक्रिप्शन के रुके होने (paused), बंद होने (stopped) या ऑटो-पॉज़ में होने पर कोई सब्सक्रिप्शन शुल्क नहीं लगता।
* भुगतान किए गए दिन के भीतर `volume` बढ़ाने पर उस दिन के बाकी हिस्से का अंतर लिया जाता है। घटाने पर कोई रिफंड नहीं मिलता।
* यदि एड्रेस अभी ऑन-चेन मौजूद नहीं है, तो पहली डेलिगेशन उसे सक्रिय भी करती है, और सक्रियण का शुल्क ऊपर से जुड़ता है।

### बैलेंस

हर डेलिगेशन से पहले आपका बैलेंस एक ट्रांसफर शुल्क को कवर करना चाहिए, और यदि मौजूदा दिन का भुगतान नहीं हुआ है तो सब्सक्रिप्शन शुल्क को भी। जब ऐसा नहीं होता, सब्सक्रिप्शन `status: "stopped_balance"` के साथ रुक जाता है और हम बैंडविड्थ वापस ले लेते हैं। एक दिन और एक ट्रांसफर को कवर करने वाले डिपॉज़िट के बाद यह अपने-आप फिर शुरू हो जाता है। यदि आपका Telegram अकाउंट लिंक है, तो रुकने पर आपको संदेश मिलता है।

सब्सक्रिप्शन बनाना या उसे वापस चालू करना यही राशि पहले ही जाँच लेता है और बैलेंस कम होने पर `402 INSUFFICIENT_BALANCE` लौटाता है, राशियाँ `error.required_trx` और `error.available_trx` में होती हैं।

### स्थिति

| `status` | अर्थ |
| - | - |
| `active` | हम एड्रेस पर बैंडविड्थ बनाए रखते हैं और हर ट्रांसफर के बाद उसे रिन्यू करते हैं |
| `free_bw` | ऑटो-पॉज़: एड्रेस के पास कम से कम `threshold` मुफ़्त बैंडविड्थ है, इसलिए हम कुछ नहीं रखते और कुछ नहीं लेते। मुफ़्त बैंडविड्थ `threshold` से नीचे जाते ही हम फिर डेलिगेट करते हैं |
| `paused` | बंद किया गया — आपके द्वारा, किसी ट्रांसफर द्वारा (देखें `stop_after_transfer`), या सपोर्ट द्वारा। कुछ रखा या लिया नहीं जाता |
| `stopped_balance` | आपका बैलेंस अगली डेलिगेशन को कवर नहीं कर पाया। डिपॉज़िट के बाद अपने-आप फिर शुरू होता है |

| `stopped_reason` | अर्थ |
| - | - |
| `insufficient_balance` | बैलेंस के कारण रुका |
| `transfer` | सब्सक्रिप्शन के टोकन के ट्रांसफर से रोका गया, क्योंकि `stop_after_transfer` चालू था |
| `admin` | सपोर्ट ने बंद किया; आप इसे खुद फिर से चालू नहीं कर सकते — हमसे संपर्क करें |
| `null` | कोई रुकावट दर्ज नहीं, या आपने रोका |

`delivery_state` बताता है कि आखिरी डेलिगेशन कैसी रही: `ok`, `waiting_stake` (बैंडविड्थ अभी डेलिगेट करने के लिए उपलब्ध नहीं है — हम फिर प्रयास करते हैं, कुछ नहीं लिया जाता) या `failed` (डेलिगेशन पूरी नहीं हुई — हम फिर प्रयास करते हैं)।

### विकल्प

**टोकन।** `token` बताता है कि एड्रेस कौन सा टोकन भेजता है: `USDT`, `TRX`, `USDD`, `CUSTOM` (आपका अपना TRC-20 टोकन, जिसे `contract` में दिया जाता है) या `OWN` (आपका अपना `volume`, वैकल्पिक रूप से `contract` के साथ)। यह सीमित नहीं करता कि हम क्या कवर करते हैं — हमारी बैंडविड्थ खर्च करने वाला हर ट्रांसफर रिन्यू होता है। यह `stop_after_transfer` के लिए टोकन तय करता है, और डैशबोर्ड में `volume` सुझाता है: USDT और USDD के लिए 350, TRX के लिए 300। अपने टोकन के लिए पहले [उसका कॉन्ट्रैक्ट जोड़ें](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/add-contract.md); रिस्पॉन्स बताता है कि उसके एक ट्रांसफर में कितनी बैंडविड्थ लगती है।

**ऑटो-पॉज़।** `auto_pause: true` के साथ, जब तक एड्रेस की रोज़ाना मुफ़्त बैंडविड्थ (प्रति अकाउंट 600) कम से कम `threshold` है, हम कोई बैंडविड्थ नहीं रखते, और सब्सक्रिप्शन `free_bw` दिखाता है। तब `threshold` `volume` और 345 में से जो बड़ा हो, उससे लेकर 600 तक होना चाहिए।

**मुफ़्त बैंडविड्थ सूचना।** `notify_free_bw: true` के साथ, जब भी एड्रेस की मुफ़्त बैंडविड्थ `threshold` से नीचे जाकर फिर उस तक लौटती है, हम आपके Telegram और ईमेल पर संदेश भेजते हैं। यह वही `threshold` और वही सीमा इस्तेमाल करता है, सिवाय इसके कि ऑटो-पॉज़ के बिना 600 से ऊपर का `volume` `threshold: 600` की अनुमति देता है।

**अगले ट्रांसफर के बाद रोकें।** `stop_after_transfer: true` के साथ, इसे सेट करने के बाद भेजा गया सब्सक्रिप्शन के टोकन का पहला ट्रांसफर सब्सक्रिप्शन को `stopped_reason: "transfer"` के साथ रोक देता है। वह ट्रांसफर फिर भी कवर होता है।

**एड्रेस बदलना।** [सब्सक्रिप्शन अपडेट करें](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/update-subscription.md) में नया `address` सेट करने से सब्सक्रिप्शन स्थानांतरित होता है: हम पुराने एड्रेस से बैंडविड्थ वापस लेते हैं, फिर नए पर डेलिगेट करते हैं। स्थानांतरण पूरा होने तक `address_change_to` नया एड्रेस दिखाता है।

### सीमाएं

* खाते पर **प्रति एड्रेस एक सब्सक्रिप्शन**। उसी एड्रेस के लिए दूसरा बनाने पर `409 AUTO_BW_ADDRESS_TAKEN` मिलता है।
* प्रति खाता **सब्सक्रिप्शन की संख्या असीमित** है — सक्रिय और रोके गए दोनों।
* आपकी सूची में **20 टोकन कॉन्ट्रैक्ट**। सीमा से ऊपर: `409 AUTO_BW_CONTRACT_LIMIT`।
* **कॉन्ट्रैक्ट एड्रेस नहीं**, जैसे USDT टोकन कॉन्ट्रैक्ट: TRON उन्हें संसाधन डेलिगेट करने की अनुमति नहीं देता।
* **ऐसे एड्रेस नहीं जिन्हें Smart Mode बैंडविड्थ या बैंडविड्थ वाला ट्रांसफर पैकेज पहले से कवर करता है**: `409 AUTO_BW_ADDRESS_COVERED`।
* सब्सक्रिप्शन बनाने और बदलने तथा कॉन्ट्रैक्ट जोड़ने पर **अनुरोध सीमाएं** — देखें [रेट लिमिट](https://docs.tronrental.com/hi/resources/rate-limits.md)।

यदि ऑटो बैंडविड्थ अस्थायी रूप से बंद है, तो सब्सक्रिप्शन बनाना, उसे चालू करना और कॉन्ट्रैक्ट जोड़ना `503 AUTO_BW_DISABLED` लौटाते हैं। कुछ बनाया या बदला नहीं जाता — कुछ देर बाद पुनः प्रयास करें।

### ऑटो रिफिल और Smart Mode से तुलना

| | ऑटो बैंडविड्थ | [बैंडविड्थ ऑटो रिफिल](https://docs.tronrental.com/hi/api-reference/auto-refill/overview.md) | [Smart Mode](https://docs.tronrental.com/hi/api-reference/smart-mode/overview.md) |
| - | - | - | - |
| संसाधन | बैंडविड्थ | बैंडविड्थ (या एनर्जी) | एनर्जी, साथ में वैकल्पिक बैंडविड्थ |
| कब डिलीवर करता है | एड्रेस पर बनी रहती है, उसे खर्च करने वाले हर ट्रांसफर के बाद रिन्यू होती है | जब स्तर आपके थ्रेशोल्ड से नीचे गिरता है | हर आउटगोइंग USDT ट्रांसफर पर |
| आप किसका भुगतान करते हैं | प्रति 24 घंटे एक शुल्क और हर खर्च हुई डेलिगेशन पर एक शुल्क | हर रिफिल का, सामान्य ऑर्डर की तरह | दैनिक सब्सक्रिप्शन और साथ में हर USDT ट्रांसफर |

### एंडपॉइंट

| कार्रवाई | एंडपॉइंट |
| - | - |
| एक दिन और एक ट्रांसफर की कीमत | [`GET /bandwidth/auto/quote`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/quote) |
| सब्सक्रिप्शन बनाएं | [`POST /bandwidth/auto`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/create-subscription) |
| सब्सक्रिप्शन की सूची | [`GET /bandwidth/auto`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/list-subscriptions) |
| बदलें, रोकें, फिर से शुरू करें, एड्रेस बदलें | [`PATCH /bandwidth/auto/{sub_id}`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/update-subscription) |
| हटाएं | [`DELETE /bandwidth/auto/{sub_id}`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/delete-subscription) |
| आपके टोकन कॉन्ट्रैक्ट | [`GET /bandwidth/auto/contracts`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/list-contracts) |
| टोकन कॉन्ट्रैक्ट जोड़ें | [`POST /bandwidth/auto/contracts`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/add-contract) |
| टोकन कॉन्ट्रैक्ट हटाएं | [`DELETE /bandwidth/auto/contracts/{address}`](https://docs.tronrental.com/hi/api-reference/auto-bandwidth/delete-contract) |

सब्सक्रिप्शन और कॉन्ट्रैक्ट बनाने, बदलने और हटाने के लिए `buy_bandwidth` स्कोप आवश्यक है; सूची और मूल्य अनुमान के लिए `view`।


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