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

# बैंडविड्थ नियमों की सूची

> आपके खाते के सभी बैंडविड्थ ऑटो रिफिल नियम

## बैंडविड्थ नियमों की सूची

आपके खाते के सभी बैंडविड्थ ऑटो रिफिल नियम लौटाता है, सबसे पुराने पहले। हटाए गए नियम शामिल नहीं होते। `view` स्कोप आवश्यक है।

### रिस्पॉन्स

**rules** `array`

आपके बैंडविड्थ नियम।

**नियम ऑब्जेक्ट**

**id** `number`

नियम ID — इसे बदलने और हटाने वाले पाथ में उपयोग करें

**target\_address** `string`

वह एड्रेस जिस पर नियम आपूर्ति बनाए रखता है

**label** `string | null`

नियम के लिए आपका नाम

**threshold\_bandwidth** `number`

जब उपलब्ध बैंडविड्थ इससे नीचे होती है, नियम खरीदता है

**add\_volume** `number`

प्रति रिफिल खरीदी जाने वाली बैंडविड्थ

**duration** `string`

हर रिफिल के किराये की अवधि — `1h` या `1d`

**status** `string`

`active`, `paused` या `stopped_insufficient_balance` — देखें [नियम की स्थिति](/hi/api-reference/auto-refill/overview#नियम-की-स्थिति)

**stopped\_reason** `string | null`

नियम क्यों रोका गया या रुका: `insufficient_balance`, `order_failed`, `activation_failed` या `invalid_params`। कोई कारण न हो तो `null`।

**consecutive\_failures** `number`

लगातार विफल रिफिल। यह संख्या 5 तक पहुँचने पर नियम रोक दिया जाता है; सफल रिफिल इसे 0 पर रीसेट कर देता है।

**last\_checked\_at** `string | null`

हमने आखिरी बार एड्रेस की जाँच कब की (ISO 8601, UTC), चाहे पढ़ना सफल रहा हो या नहीं। पहली जाँच से पहले `null`।

**last\_available\_bandwidth** `number | null`

आखिरी सफल जाँच के समय एड्रेस पर उपलब्ध बैंडविड्थ, मुफ़्त बैंडविड्थ सहित। पहली सफल रीडिंग से पहले `null`।

**last\_read\_error\_at** `string | null`

आखिरी बार कब कोई जाँच एड्रेस को पढ़ने में विफल रही (ISO 8601, UTC)। आखिरी जाँच सफल रही हो तो `null`। जब तक यह सेट है, `last_available_bandwidth` किसी पिछली जाँच का है और पुराना हो सकता है। जो जाँच एड्रेस को पढ़ नहीं पाती, वह कुछ नहीं खरीदती।

**last\_refill\_at** `string | null`

आखिरी रिफिल कब हुआ। यदि अब तक कोई रिफिल नहीं हुआ तो `null`।

**refill\_count** `number`

नियम बनने के बाद से सफल रिफिल की संख्या

**total\_spent\_trx** `string`

उन रिफिल पर कुल खर्च हुए TRX

**created\_at** `string`

नियम कब बनाया गया (ISO 8601, UTC)

**estimated\_cost\_per\_refill\_trx** `string | null`

मौजूदा कीमतों पर आपके खाते के लिए एक रिफिल की पूरी कीमत, फिक्स्ड शुल्क सहित। ज़रूरत पड़ने पर एड्रेस सक्रियण का शुल्क अलग से जुड़ता है। यदि कीमत अस्थायी रूप से उपलब्ध नहीं है तो `null`।

**volume\_below\_threshold** `boolean`

`true` जब `add_volume` `threshold_bandwidth` से छोटा हो। तब एक रिफिल शायद एड्रेस को थ्रेशोल्ड से ऊपर न ला पाए, और नियम हर खर्च के बाद फिर खरीदता है — देखें [अवलोकन में चेतावनी](/hi/api-reference/auto-refill/overview#संख्याएँ-कैसे-चुनें)।

### उदाहरण

```bash cURL theme={null}
curl https://api.tronrental.com/v1/bandwidth/auto-refill \
  -H "X-API-Key: your_api_key"
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/auto-refill",
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
```

```javascript JavaScript theme={null}
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto-refill", {
  headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "rules": [
    {
      "id": 15,
      "target_address": "TYourRecipientAddress1234567890abc",
      "label": "Payouts",
      "threshold_bandwidth": 1000,
      "add_volume": 5000,
      "duration": "1h",
      "status": "active",
      "stopped_reason": null,
      "consecutive_failures": 0,
      "last_checked_at": "2026-10-14T09:41:02Z",
      "last_available_bandwidth": 3655,
      "last_read_error_at": null,
      "last_refill_at": "2026-10-14T09:12:30Z",
      "refill_count": 4,
      "total_spent_trx": "1.480000",
      "created_at": "2026-10-14T08:15:00Z",
      "estimated_cost_per_refill_trx": "0.370000",
      "volume_below_threshold": false
    }
  ]
}
```

### त्रुटियाँ

| स्थिति | कोड | कब |
| - | - | - |
| `403` | `FORBIDDEN` | API कुंजी के पास `view` स्कोप नहीं है |


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