Ana içeriğe atla
POST
Bandwidth satın al

Bandwidth satın al

Belirtilen TRON adresine bandwidth devreder. Maliyet hesap bakiyenizden düşülür.

İstek gövdesi

string
gerekli
Hedef TRON adresi (T… formatı, 34 karakter)
number
gerekli
Devredilecek bandwidth miktarı (min 1, maks 100.000)
string
gerekli
Kiralama süresi, şunlardan biri:
  • "1h" — 1 saat
  • "1d" — 24 saat
  • "5m" … "59m" — 5 ile 59 arasında herhangi bir tam dakika sayısı, saatlik tarifeden indirimli (bkz. Fiyatlandırma)
Dakikaları başında sıfır olmayan bir sayı ve ardından küçük harf m olarak yazın: "5m", "30m". "05m", "5M", "60m" veya "90m" 400 INVALID_DURATION ile reddedilir: bir saat "1h" olarak yazılır ve "1h" ile "1d" arasında başka bir süre yoktur. "24h" veya sayısal saat değerleri kullanmayın; "1d" kullanın.
string
İsteğe bağlı. Bu sipariş için ödemeyi kabul ettiğiniz en yüksek tutar (TRX) — kiralama ve sabit ücret birlikte. Sipariş bundan pahalıya gelecekse 409 PRICE_CHANGED ile reddedilir ve hiçbir ücret alınmaz. Bandwidth fiyatı hesapla yanıtındaki total_trx değerini gönderin. "0.58" gibi ondalık bir dize (JSON sayısı da kabul edilir), 0’dan büyük. Bu alan olmadan sipariş, eskisi gibi güncel fiyattan satın alınır.

Başlıklar

string
İsteğe bağlı, en fazla 64 karakter. Aynı anahtar ve aynı gövdeyle yapılan tekrar, yeniden satın almak yerine ilk siparişi döndürür. Başarılı bir siparişten sonra aynı anahtar farklı bir gövdeyle — farklı bir max_price_trx dahil — 422 IDEMPOTENCY_KEY_REUSED döndürür. 409 PRICE_CHANGED veya 402 INSUFFICIENT_BALANCE gibi hiçbir ücret alınmayan bir retten sonra anahtar yeniden kullanılabilir hâle gelir: aynı anahtarla ve yeni fiyatla tekrar deneyin.Anahtarla yapılan ilk istek hâlâ işlenirken yapılan bir tekrar 409 IDEMPOTENT_REQUEST_IN_PROGRESS döndürür: birkaç saniye bekleyin ve aynı anahtarla tekrar deneyin. Anahtar kontrol edilemezse istek, hiçbir şey satın alınmadan 503 IDEMPOTENCY_UNAVAILABLE ile reddedilir: aynı anahtarla tekrar deneyin. Anahtar 24 saat saklanır; bu sürenin ardından yeni bir satın alma başlatır. Tekrar denemeler Enerji Satın Al → Zaman aşımları ve tekrar denemeler bölümünde anlatıldığı gibi çalışır.

Yanıt

number
Benzersiz sipariş kimliği
string
Sipariş durumu: filled, failed veya submitted_unknown — delegasyon yayınlandı ancak henüz bir blokta onaylanmadı; birkaç dakika içinde filled olur ya da tam iadeyle failed olur: Get Order ile kontrol edin.
string | null
Delegasyon yayınlandıktan sonraki on-chain işlem kimliği
string
Bakiyeden düşülen siparişin toplam maliyeti (TRX) — kiralama ve sabit ücret
string | null
Kiralanan bandwidth geri alındığında ISO 8601 zaman damgası
string
target_address henüz etkinleştirilmemişse zincirde etkinleştirilmesi için price_trx dışında ayrıca alınan tutar. Zaten aktif bir adres için "0".

Fiyatlandırma

1h ve 1d: fiyat = volume × price_sun / 1,000,000 + sabit ücret (hesabınızın kendi ücreti yoksa 0,2 TRX); burada price_sun, Bandwidth fiyatlarını al yanıtındaki price_sun_1h veya price_sun_1d değeridir ya da hesabınızın anlaşmalı bir tarifesi varsa o tarifedir. 5m … 59m: indirimli saatlik tarife (price_sun_1h veya anlaşmalı saatlik tarifeniz). İndirim 5 dakikada en büyüktür ve 59 dakikada doğrusal olarak sıfıra iner:
İndirim yalnızca kiralamaya uygulanır — sabit ücret her süre için aynıdır. Dakikalık bir sürenin kiralama bedeli en yakın SUN’a (0,000001 TRX) yuvarlanır; tam yarımlar yukarı yuvarlanır. Güncel short_max_discount_pct değeri Bandwidth fiyatlarını al sayfasındadır. Bunların hiçbirini hesaplamanız gerekmez: Bandwidth fiyatı hesapla miktarınız, süreniz ve hesabınız için tam tutarı döndürür.

Fiyatı gösterin, sonra o fiyattan satın alın

  1. X-API-Key anahtarınızla GET /v1/bandwidth/quote çağırın ve total_trx değerini kullanıcınıza gösterin.
  2. max_price_trx değerini bu total_trx olarak ayarlayıp POST /v1/bandwidth/buy çağırın.
Fiyat teklifi, siparişi tahsil eden kodun aynısıyla hesaplanır; bu yüzden fiyat değişmediği sürece sipariş tam olarak total_trx tutarına mal olur. Arada fiyat değiştiyse satın alma, hiçbir ücret alınmadan 409 PRICE_CHANGED ile reddedilir: yeni bir fiyat teklifi alın, gösterin ve tekrar deneyin — kullanıyorsanız aynı Idempotency-Key ile.
max_price_trx yalnızca bandwidth siparişini kapsar. target_address zincirde henüz etkinleştirilmemişse etkinleştirme ücreti ayrıca alınır (activation_cost_trx) ve max_price_trx ile karşılaştırılmaz.

Örnek

Response

Örnek: fiyat teklifi alın, sonra 5 dakikalığına satın alın

Aşağıdaki değerler örnektir: price_sun_1h 400 ve short_max_discount_pct 5.
Response
Sipariş max_price_trx değerinden pahalıysa — örneğin "0.57" gönderdiniz ve sipariş 0,58 TRX tutuyorsa — hiçbir ücret alınmaz ve yanıt şöyledir:
409 PRICE_CHANGED

Hatalar

0, negatif bir sayı veya sayı olmayan bir max_price_trx değeri, çerçevenin kendi biçiminde bir 422 doğrulama hatasıdır. Diğer kodlar Hatalar sayfasında listelenmiştir.
Ücretsiz günlük bandwidth tükendiğinde 350 bandwidth bir USDT TRC-20 transferini karşılar.