> ## 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 एड्रेस पर नज़र रखता है और जब भी उसकी एनर्जी या बैंडविड्थ आपके तय किए स्तर से नीचे गिरती है, उसे टॉप-अप कर देता है। आप **थ्रेशोल्ड**, हर बार **जोड़ी जाने वाली** मात्रा और किराये की **अवधि** चुनते हैं। हर रिफिल एक सामान्य ऑर्डर है, जिसका भुगतान आपके बैलेंस से होता है।

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

1. किसी एड्रेस के लिए थ्रेशोल्ड, `add_volume` और `duration` के साथ नियम बनाएं।
2. हम जाँचते हैं कि एड्रेस पर कितनी एनर्जी (या बैंडविड्थ) उपलब्ध है — **हर मिनट एक बार**, और उस एड्रेस से **हर आउटगोइंग USDT ट्रांसफर के तुरंत बाद**।
3. यदि स्तर थ्रेशोल्ड से नीचे है, तो हम एड्रेस के लिए `add_volume` खरीदते हैं और आपकी कीमत पर आपके बैलेंस से शुल्क लेते हैं।
4. किराया अपनी अवधि पूरी होने पर समाप्त हो जाता है। जब स्तर फिर से थ्रेशोल्ड से नीचे जाता है, नियम दोबारा खरीदता है। इसी तरह नियम एड्रेस पर आपूर्ति बनाए रखता है: रिन्यूअल का कोई अलग चरण नहीं है।

यदि कोई जाँच एड्रेस को पढ़ नहीं पाती, तो वह कुछ नहीं खरीदती; नियम उसका समय `last_read_error_at` में दिखाता है, और अगली जाँच फिर से प्रयास करती है।

नियम बनाने से उसी समय कुछ नहीं खरीदा जाता। पहला रिफिल अगली जाँच पर होता है, आमतौर पर एक मिनट के भीतर। नियम बनाने वाले अनुरोध का रिस्पॉन्स बताता है कि रिफिल होगा या नहीं (`will_refill_now`) और इस समय एड्रेस पर कितना है।

> [!NOTE]
>
> ऑटो रिफिल स्तर गिरने के बाद प्रतिक्रिया करता है; यह ट्रांसफर से पहले ही पहुँचकर उसका इंतज़ार नहीं करता। थ्रेशोल्ड कम से कम उतना रखें जितना आपके अगले ट्रांज़ैक्शन को चाहिए, ताकि ट्रांज़ैक्शन भेजे जाते समय वह पहले से कवर हो।

### एनर्जी और बैंडविड्थ

दोनों संसाधनों के अपने अलग एंडपॉइंट और अपने अलग नियम हैं। एक एड्रेस पर एक ही समय में एनर्जी नियम और बैंडविड्थ नियम दोनों हो सकते हैं; हर नियम की जाँच उसके अपने थ्रेशोल्ड से होती है।

| | एनर्जी | बैंडविड्थ |
| - | - | - |
| एंडपॉइंट | `/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` |
| थ्रेशोल्ड से तुलना किया जाने वाला स्तर | उपलब्ध एनर्जी | सारी उपलब्ध बैंडविड्थ, **रोज़ाना मुफ़्त 600 सहित** |
| बनाने, बदलने, हटाने के लिए स्कोप | `buy_energy` | `buy_bandwidth` |
| सूची और मूल्य अनुमान के लिए स्कोप | `view` | `view` |

**एनर्जी** एक घंटे के लिए किराये पर ली जाती है। जब वह खत्म हो जाती है या उसकी अवधि पूरी होती है, स्तर गिरता है और नियम अगला घंटा खरीदता है।

**बैंडविड्थ** में वह सब गिना जाता है जिससे एड्रेस किसी ट्रांज़ैक्शन का भुगतान कर सकता है: हर अकाउंट को रोज़ मिलने वाली मुफ़्त 600 बैंडविड्थ, साथ ही कोई भी स्टेक की गई या डेलिगेट की गई बैंडविड्थ। इसलिए 600 या उससे कम का थ्रेशोल्ड, जब तक एड्रेस मुफ़्त कोटा खर्च नहीं कर देता, अकेले उसी से पूरा हो जाता है।

### संख्याएँ कैसे चुनें

> [!WARNING]
>
> **`add_volume` को थ्रेशोल्ड के बराबर या उससे ऊपर रखें।** रिफिल एड्रेस पर बची हुई मात्रा में `add_volume` जोड़ता है। यदि `add_volume` थ्रेशोल्ड से छोटा है, तो लगभग खाली एड्रेस पर एक रिफिल के बाद भी स्तर थ्रेशोल्ड से नीचे रह सकता है, और नियम हर खर्च के बाद फिर खरीदेगा — घंटे में एक बार नहीं, बल्कि मिनट में कई बार तक। इनमें से हर रिफिल अपने फिक्स्ड शुल्क के साथ एक पूरा ऑर्डर है। नियम के रिस्पॉन्स इस स्थिति को `volume_below_threshold: true` से चिह्नित करते हैं।

एक USDT ट्रांसफर में लगभग 65,000 एनर्जी लगती है जब प्राप्तकर्ता के पास पहले से USDT हो, और लगभग 131,000 जब न हो, साथ ही करीब 345 बैंडविड्थ। उदाहरण के लिए, `threshold_energy: 65000` के साथ `add_volume: 131000` दो ट्रांसफर जितनी एनर्जी तब खरीदता है जब एक ट्रांसफर से कम बची हो।

### लागत

हर रिफिल एक सामान्य ऑर्डर है: आपकी दर पर किराया और साथ में **फिक्स्ड शुल्क, जो हर रिफिल पर लिया जाता है**। सूची और नियम बनाने के रिस्पॉन्स में `estimated_cost_per_refill_trx` आपके खाते के लिए एक रिफिल की पूरी कीमत है, फिक्स्ड शुल्क सहित। नियम बनाने से पहले यह कीमत देखने के लिए मूल्य अनुमान एंडपॉइंट का उपयोग करें: [एनर्जी](/hi/api-reference/auto-refill/quote-energy-refill), [बैंडविड्थ](/hi/api-reference/auto-refill/quote-bandwidth-refill)। बार-बार रिफिल होने वाला छोटा `add_volume` फिक्स्ड शुल्क कई बार चुकाता है; बड़ा वाला उसे कम बार चुकाता है।

API कुंजी से बनाए गए नियम की कीमत उस API कुंजी से की गई खरीद जैसी होती है; वेबसाइट पर बनाए गए नियम की कीमत वेबसाइट पर की गई खरीद जैसी। `estimated_cost_per_refill_trx` में यह पहले से शामिल है।

यदि एड्रेस अभी ऑन-चेन मौजूद नहीं है, तो पहला रिफिल उसे सक्रिय भी करता है, बिल्कुल सामान्य खरीद की तरह। सक्रियण का शुल्क अलग से जुड़ता है और `estimated_cost_per_refill_trx` का हिस्सा नहीं है; ऑर्डर इसे `activation_cost_trx` में दिखाता है।

खर्च की कोई दैनिक सीमा नहीं है: जब तक स्तर थ्रेशोल्ड से नीचे है और आपका बैलेंस एक रिफिल को कवर करता है, नियम खरीदता रहता है।

### ऑर्डर और वेबहुक

हर रिफिल आपके ऑर्डर इतिहास ([ऑर्डर सूची](/hi/api-reference/orders/list-orders)) में `source: "autorefill"` के साथ दिखता है। केवल रिफिल ऑर्डर की सूची पाने के लिए `GET /orders?source=autorefill` कॉल करें; उन्हें फ़ाइल के रूप में एक्सपोर्ट करने के लिए `autorefill` [रिपोर्ट](/api-reference/account/reports) का उपयोग करें।

API कुंजी से बनाए गए नियम अपने रिफिल ऑर्डर के लिए [`order.updated` वेबहुक](/hi/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 अकाउंट लिंक है, तो आपको किसी नियम के पहले रिफिल पर संदेश मिलता है, और तब भी जब नियम रोका जाता है, बैलेंस के कारण रुकता है या फिर से शुरू होता है।

### सीमाएं

* खाते पर **प्रति एड्रेस और संसाधन एक नियम**। उसी एड्रेस के लिए दूसरा एनर्जी नियम (या दूसरा बैंडविड्थ नियम) बनाने पर `409 AUTOREFILL_ADDRESS_TAKEN` मिलता है — इसके बजाय मौजूदा नियम बदलें।
* प्रति खाता **20 एनर्जी नियम और 20 बैंडविड्थ नियम**। हटाए गए नियम नहीं गिने जाते। सीमा से ऊपर: `409 AUTOREFILL_LIMIT_REACHED`।
* **कॉन्ट्रैक्ट एड्रेस नहीं**, जैसे USDT टोकन कॉन्ट्रैक्ट: TRON उन्हें संसाधन डेलिगेट करने की अनुमति नहीं देता।
* **नियम बनाना** हर संसाधन के लिए प्रति खाता 10 अनुरोध प्रति मिनट तक सीमित है। देखें [रेट लिमिट](/hi/resources/rate-limits)।

### बदलना और हटाना

बदलाव अगली जाँच से लागू होते हैं। जब नियम के लिए रिफिल खरीदा जा रहा हो, तब `PATCH` और `DELETE` `409 AUTOREFILL_IN_PROGRESS` लौटाते हैं — एक मिनट में फिर प्रयास करें। नियम हटाने से पहले से खरीदी गई एनर्जी या बैंडविड्थ वापस नहीं ली जाती; वे किराये अपनी अवधि के अंत तक चलते हैं।

### Smart Mode और ऑटो-रिन्यू रेंटल से तुलना

| | ऑटो रिफिल | [Smart Mode](/hi/api-reference/smart-mode/overview) | [ऑटो-रिन्यू रेंटल](/hi/api-reference/bandwidth-rentals/create-rental) |
| - | - | - | - |
| संसाधन | एनर्जी या बैंडविड्थ | एनर्जी, साथ में वैकल्पिक बैंडविड्थ | बैंडविड्थ |
| कब डिलीवर करता है | जब स्तर आपके थ्रेशोल्ड से नीचे गिरता है | हर आउटगोइंग USDT ट्रांसफर पर | एक बार डेलिगेट होता है और रेंटल चलने तक बना रहता है |
| आप किसका भुगतान करते हैं | हर रिफिल का, सामान्य ऑर्डर की तरह | दैनिक सब्सक्रिप्शन और साथ में हर USDT ट्रांसफर | दिन में एक बार |
| क्या कवर करता है | कोई भी खर्च — USDT, TRX, कॉन्ट्रैक्ट कॉल | USDT ट्रांसफर | बैंडविड्थ की स्थिर ज़रूरत |

### एंडपॉइंट

| कार्रवाई | एनर्जी | बैंडविड्थ |
| - | - | - |
| एक रिफिल की कीमत | [`GET /energy/auto-refill/quote`](/hi/api-reference/auto-refill/quote-energy-refill) | [`GET /bandwidth/auto-refill/quote`](/hi/api-reference/auto-refill/quote-bandwidth-refill) |
| नियम बनाएं | [`POST /energy/auto-refill`](/hi/api-reference/auto-refill/create-energy-rule) | [`POST /bandwidth/auto-refill`](/hi/api-reference/auto-refill/create-bandwidth-rule) |
| नियमों की सूची | [`GET /energy/auto-refill`](/hi/api-reference/auto-refill/list-energy-rules) | [`GET /bandwidth/auto-refill`](/hi/api-reference/auto-refill/list-bandwidth-rules) |
| बदलें, रोकें, फिर से शुरू करें | [`PATCH /energy/auto-refill/{rule_id}`](/hi/api-reference/auto-refill/update-energy-rule) | [`PATCH /bandwidth/auto-refill/{rule_id}`](/hi/api-reference/auto-refill/update-bandwidth-rule) |
| हटाएं | [`DELETE /energy/auto-refill/{rule_id}`](/hi/api-reference/auto-refill/delete-energy-rule) | [`DELETE /bandwidth/auto-refill/{rule_id}`](/hi/api-reference/auto-refill/delete-bandwidth-rule) |


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