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

> Цена одного пополнения bandwidth — ещё до создания правила

## Рассчитать цену пополнения bandwidth

Возвращает, сколько стоит вашему аккаунту одно пополнение на `add_volume` bandwidth на срок `duration`: цену, которую правило с такими настройками платит за каждое пополнение, включая фиксированную комиссию. Ничего не создаётся и не списывается. Нужен скоуп `view`.

Цена зависит от того, как вы вызываете эндпоинт. С API-ключом это цена правила, созданного с этим API-ключом; с сайта — цена правила, созданного на сайте. Это цена на момент запроса, и в неё не входит активация адреса, которого ещё нет в сети, — её добавит первое пополнение.

### Параметры запроса

**add\_volume** `number` *required*

Bandwidth за одно пополнение. От 350 до 100 000 — тот же диапазон, что при создании правила.

**duration** `string` (default: 1h)

Срок аренды для каждого пополнения: `1h` или `1d`.

### Ответ

**add\_volume** `number`

Объём, о котором вы спросили

**duration** `string`

Срок, о котором вы спросили, — `1h` или `1d`

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

Полная цена одного пополнения для вашего аккаунта, включая фиксированную комиссию

### Пример

```bash cURL theme={null}
curl "https://api.tronrental.com/v1/bandwidth/auto-refill/quote?add_volume=5000&duration=1d" \
  -H "X-API-Key: your_api_key"
```

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

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

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

```json Response theme={null}
{
  "add_volume": 5000,
  "duration": "1d",
  "estimated_cost_per_refill_trx": "0.500000"
}
```

### Ошибки

| Статус | Код | Когда |
| - | - | - |
| `403` | `FORBIDDEN` | У API-ключа нет скоупа `view` |
| `422` | — | `add_volume` отсутствует или вне диапазона 350 – 100 000, либо `duration` — не `1h` и не `1d` |
| `503` | `TEMPORARILY_UNAVAILABLE` | Цену сейчас не удалось получить — повторите запрос, подождав столько секунд, сколько указано в `Retry-After` |

```json theme={null}
{
  "detail": {
    "error": {
      "code": "TEMPORARILY_UNAVAILABLE",
      "message": "Please retry shortly"
    }
  }
}
```

Ошибка валидации приходит в формате фреймворка, где `detail` — массив:

```json theme={null}
{
  "detail": [
    {
      "type": "literal_error",
      "loc": ["query", "duration"],
      "msg": "Input should be '1h' or '1d'",
      "input": "2h",
      "ctx": {"expected": "'1h' or '1d'"}
    }
  ]
}
```


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