> ## 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 fiyatı hesapla

> Belirli bir miktar ve süre için bandwidth siparişinin sabit ücret dahil tam fiyatı

## Bandwidth fiyatı hesapla

Bu miktar ve süredeki bir bandwidth siparişi için tam olarak tahsil edilecek tutarı döner — kiralama
ve sabit ücret birlikte, **sizin** tarifenizle. Fiyat teklifi, siparişi tahsil eden kodun aynısıyla
hesaplanır; bu yüzden fiyat değişmediği sürece satın alma tam olarak `total_trx` tutarına mal olur.

**Bu uç nokta herkese açıktır — kimlik doğrulama isteğe bağlıdır.** Kendi tarifenizi ve sabit
ücretinizi almak için API anahtarınızı gönderin; anahtarsız genel fiyat döner.

> [!TIP]
>
> `total_trx` değerini kullanıcınıza gösterin ve
> [Bandwidth satın al](https://docs.tronrental.com/tr/api-reference/bandwidth/buy-bandwidth.md) isteğine `max_price_trx` olarak
> gönderin. Fiyat, teklif ile satın alma arasında değişirse satın alma `409 PRICE_CHANGED` ile
> reddedilir ve hiçbir ücret alınmaz — yeniden fiyat teklifi alın ve tekrar deneyin.

### Sorgu parametreleri

**volume** `integer` *required*

Fiyatlandırılacak bandwidth birimi. 1 ile 100.000 arasında.

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

Kiralama süresi: `1h`, `1d` veya `5m` ile `59m` arasında tam dakika sayısı —
[Bandwidth satın al](https://docs.tronrental.com/tr/api-reference/bandwidth/buy-bandwidth.md) ile aynı değerler.

### Başlıklar

**X-API-Key** `string`

İsteğe bağlı. Geçerli bir anahtarla yanıt, anlaşmalı tarifenizi ve sabit ücretinizi yansıtır.
Anahtarın olmaması, geçersiz veya iptal edilmiş olması hata değildir — `personal_price: false` ile
genel fiyatı alırsınız.

### Yanıt

**volume** `number`

Fiyatın hesaplandığı bandwidth miktarı

**duration** `string`

Fiyatın hesaplandığı kiralama süresi

**price\_sun** `string`

1 bandwidth birimi başına SUN cinsinden tarife, gösterim için 0,01'e yuvarlanmış. Dakikalık
sürelerde indirim olduğundan tarifeleri kesirli olur ve aşağıdaki tutarlar tam tarifeden hesaplanır —
bu yuvarlanmış değeri kendiniz çarpmak yerine `total_trx` değerini kullanın.

**rental\_trx** `string`

Bu miktar ve süre için kiralama bedeli, sabit ücret hariç

**fixed\_fee\_trx** `string`

Sabit ücret; miktar ve süreden bağımsız olarak **sipariş başına bir kez** alınır. Hesabınızda özel
ücret, indirim veya muafiyet varsa burada kendi ücretiniz görünür.

**total\_trx** `string`

**Tahsil edilecek tutar**: `rental_trx + fixed_fee_trx`.
[Bandwidth satın al](https://docs.tronrental.com/tr/api-reference/bandwidth/buy-bandwidth.md) isteğine `max_price_trx` olarak
gönderin.

**personal\_price** `boolean`

Anlaşmalı tarifeniz uygulandıysa `true`, fiyat genel fiyatsa `false`. Bu alanı kontrol edin: aksi
halde unutulmuş bir `X-API-Key` başlığı normal bir yanıt gibi görünür ve müşterilerinize genel
fiyatı verirken sizden kendi fiyatınız tahsil edilir.

### Örnek

```bash cURL theme={null}
curl "https://api.tronrental.com/v1/bandwidth/quote?volume=1000&duration=5m" \
  -H "X-API-Key: your_api_key"
```

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

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/quote",
    params={"volume": 1000, "duration": "5m"},
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json()["total_trx"])
```

```javascript JavaScript theme={null}
const resp = await fetch(
  "https://api.tronrental.com/v1/bandwidth/quote?volume=1000&duration=5m",
  { headers: { "X-API-Key": "your_api_key" } }
);
const quote = await resp.json();
console.log(quote.total_trx);
```

> [!NOTE]
>
> Aşağıdaki değerler örnektir: `price_sun_1h` 400 ve `short_max_discount_pct` 5. Güncel
> tarifeler ve indirim [Bandwidth fiyatlarını al](https://docs.tronrental.com/tr/api-reference/bandwidth/get-prices.md)
> sayfasındadır.

```json Response theme={null}
{
  "volume": 1000,
  "duration": "5m",
  "price_sun": "380.00",
  "rental_trx": "0.380000",
  "fixed_fee_trx": "0.2",
  "total_trx": "0.580000",
  "personal_price": false
}
```

### Fiyat teklifinin içermedikleri

> [!WARNING]
>
> Fiyat teklifi — ve `max_price_trx` — yalnızca bandwidth siparişini kapsar. Hedef adres zincirde
> henüz etkinleştirilmemişse [Bandwidth satın al](https://docs.tronrental.com/tr/api-reference/bandwidth/buy-bandwidth.md) adresi
> etkinleştirir ve etkinleştirme ücretini ayrıca alır (yanıtındaki `activation_cost_trx`). Bu ücret
> `total_trx` tutarına dahil değildir ve `max_price_trx` ile karşılaştırılmaz.

### Başka bir hesap adına işlem: `GET /v1/bandwidth/quote/me`

`/bandwidth/quote` fiyatı **API anahtarının sahibi** için hesaplar. Anahtarınız `X-Account-Id`
başlığıyla başka bir hesap adına işlem yapıyorsa satın alma o hesabın tarifesi ve ücretiyle tahsil
edilir — fiyat teklifi tahsil edilen tutardan farklı olabilir ve ondan alınan bir `max_price_trx`
değeri `409 PRICE_CHANGED` ile reddedilebilir.

Bu durumda `GET /v1/bandwidth/quote/me` kullanın. Aynı sorgu parametrelerini alır ve aynı yanıtı
döndürür, ancak kimlik doğrulama zorunludur ve hesap, `X-Account-Id` dahil, satın almadakiyle tamamen
aynı şekilde belirlenir. `view` kapsamı gerektirir; bu kapsam her anahtarda her zaman vardır.

```bash cURL theme={null}
curl "https://api.tronrental.com/v1/bandwidth/quote/me?volume=1000&duration=5m" \
  -H "X-API-Key: your_api_key" \
  -H "X-Account-Id: 12345"
```

### Hatalar

| Kod | Anlamı |
| - | - |
| `400 INVALID_VOLUME` | Miktar 1–100.000 aralığının dışında |
| `400 INVALID_DURATION` | `1h`, `1d` veya `5m` … `59m` dışında bir süre |
| `401 INVALID_TOKEN` | Yalnızca `/quote/me`: API anahtarı eksik, bilinmiyor veya devre dışı |
| `403 FORBIDDEN` | Yalnızca `/quote/me`: anahtarınızın `X-Account-Id` içindeki hesaba etkin erişimi yok |

`/bandwidth/quote` üzerinde geçersiz veya iptal edilmiş `X-API-Key` hata **değildir**: fiyat genel
fiyatla ve `personal_price: false` ile döner.


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