> ## 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 для адреса TRON

## Купить bandwidth

Делегирует bandwidth на указанный адрес TRON. Стоимость списывается с баланса вашего аккаунта.

### Тело запроса

<ParamField body="target_address" type="string" required>
  Целевой адрес TRON (формат T..., 34 символа)
</ParamField>

<ParamField body="volume" type="number" required>
  Количество делегируемого bandwidth (мин. 350, макс. 100 000)
</ParamField>

<ParamField body="duration" type="string" required>
  Длительность аренды: `"1h"` (1 час) или `"1d"` (24 часа). Используйте `"1d"`, а не `"24h"` или число часов.
</ParamField>

### Ответ

<ResponseField name="id" type="number">
  Уникальный идентификатор заказа
</ResponseField>

<ResponseField name="status" type="string">
  Статус заказа: `pending`, `filled`, `failed`
</ResponseField>

<ResponseField name="txid" type="string | null">
  ID on-chain транзакции после broadcast делегирования (null пока `pending`)
</ResponseField>

<ResponseField name="price_trx" type="string">
  Итоговая стоимость, списанная с баланса, в TRX
</ResponseField>

<ResponseField name="reclaim_at" type="string | null">
  ISO 8601 timestamp, когда bandwidth будет отозван
</ResponseField>

### Ценообразование

Цена = `(volume × price_sun) / 1 000 000 + 0.2 TRX` фикс. комиссия. Актуальные `price_sun_1h`, `price_sun_1d` и `fixed_fee_trx` — в `GET /v1/bandwidth/prices`.

### Пример

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.tronrental.com/v1/bandwidth/buy \
    -H "X-API-Key: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "target_address": "TYourRecipientAddress1234567890abc",
      "volume": 16000,
      "duration": "1d"
    }'
  ```

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

  resp = requests.post(
      "https://api.tronrental.com/v1/bandwidth/buy",
      headers={"X-API-Key": "your_api_key"},
      json={
          "target_address": "TYourRecipientAddress1234567890abc",
          "volume": 16000,
          "duration": "1d",
      },
  )
  print(resp.json())
  ```

  ```javascript JavaScript theme={null}
  const resp = await fetch("https://api.tronrental.com/v1/bandwidth/buy", {
    method: "POST",
    headers: {
      "X-API-Key": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target_address: "TYourRecipientAddress1234567890abc",
      volume: 16000,
      duration: "1d",
    }),
  });
  console.log(await resp.json());
  ```
</CodeGroup>

```json Response theme={null}
{
  "id": 5678,
  "price_trx": "10.28",
  "status": "filled",
  "txid": "abc123...",
  "reclaim_at": "2026-06-10T21:00:00+00:00"
}
```

<Tip>
  **350 bandwidth** хватает на один перевод USDT TRC-20, когда бесплатный дневной лимит исчерпан.
</Tip>