TRON Energy kiralama siparişlerini programlı olarak teklif etmek, oluşturmak ve takip etmek için API v2'yi entegre edin. Zincir üzerinden veya TronBid bakiyenizden ödeme yapın ve akıllı sözleşme çağrıları tarafından yakılan TRX'i azaltın.
Quick Rent API, TRON Energy'yi manuel çalışma olmadan otomatik olarak kiralamanın bir yoludur. Enerji, USDT (TRC-20) transferlerini ve diğer akıllı sözleşme çağrılarını TRX'i kullanmaktan daha ucuz hale getirir.
Basit bir ifadeyle: programınız (bir site, bot veya hizmet) tam olarak ihtiyaç duyulduğu anda, örneğin müşterinizin yaptığı her USDT transferinden önce enerjiyi kendisi satın alır.
Bir satış makinesi düşünün: Fiyatı kontrol edersiniz, parayı koyarsınız, ürününüzü alırsınız. API aynı düğme kümesinden oluşur; yalnızca sizin programınız bunlara basar.
Programınız API'ye ihtiyaç duyulan enerji paketinin şu anda ne kadara mal olduğunu soruyor.
Programınız bir sipariş oluşturur ve verilen adrese TRX göndererek veya TronBid bakiyenizden çekim yaparak bunu öder.
Birkaç saniye içinde hedef cüzdanda enerji belirir ve USDT daha ucuza gönderilebilir.
Önemli: API geliştiricilere yönelik bir araçtır. Bunu kullanmak için birisinin istekleri gönderen kodu yazması gerekir.
Kod yazacak kimse yoksa sitedeki hazır enerji satın alımını (Hızlı Kiralama) veya Telegram botu @tronbid'i kullanın. Aynı sonuç, sadece manuel olarak yapıldı.
En basit senaryoya (zincir içi) ilişkin uçtan uca tam bir örnek. Dört adım ve enerji cüzdanda.
Aşağıda her adımda ne olduğu ve API'nin ne döndürdüğü açıklanmaktadır. API anahtarınızı, adreslerinizi ve sipariş kimliğinizi girin.
Enerji miktarını ve süresini gönderin. Price_trx'i ve kaç saniye süreyle kilitlendiğini geri alırsınız.
Paketi, idempotency_key'inizi ve payer_address'inizi gönderin. pay_address (ödeme yeri), miktar_trx (ne kadar) ve expiries_at (ne zamana kadar) bilgilerini alırsınız.
Payer_address'inizden pay_address'e tam olarak miktar_trx TRX gönderin. Bu basit bir TRON transferi.
Yetki verilene kadar her birkaç saniyede bir durumu yoklayın. Bu, enerjinin cüzdana devredildiği ve tamamlandığı anlamına gelir.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}# poll every 3s until the order is done
while true; do
STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY" | jq -r .status)
echo "status: $STATUS"
case "$STATUS" in
delegated|failed|expired|cancelled) break ;;
esac
sleep 3
done{
"id": "uuid",
"status": "delegated",
"payment_mode": "onchain",
"amount_trx": "3.200000",
"energy_amount": 131000,
"effective_energy_amount": 131000,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}Bu belgede kullanılan kelimelerin kısa açıklamaları.
İlk isteğinizi yapmadan önce ne hazırlamanız gerekir?
Telegram'da @tronbid'e mesaj gönderin — TronBid hesabınıza bağlı bir anahtar alacaksınız. İstekler onsuz geçmez.
Enerjiye ihtiyaç duyan adresi (target_address) belirleyin. Genellikle müşterilerinizin USDT gönderdiği cüzdandır.
Enerji paketler halinde satılmaktadır (genellikle 15 veya 60 dakika süreyle 65000 veya 131000 enerji). Canlı listeyi kataloğun uç noktasından alın, kimlik doğrulamaya gerek yok.
Zincir üzerinde ödeme için TRX içeren bir cüzdan. Bakiye ödemesi için — fonlanmış bir TronBid hesabı ve bakiye modu etkin.
Quick Rent API, hizmetinizin TRON Energy'yi otomatik olarak kiralamasını sağlar; böylece USDT TRC-20 transferleri ve diğer akıllı sözleşme çağrıları, TRX'i yakmaktan daha az maliyetli olur.
Tüm uç noktalar tek bir temel URL'yi paylaşır.
https://tronbid.com/api/v2/quick-rentBir sipariş için ödeme yapmanın iki yolu vardır. Zincir üstü varsayılandır ve kurulum gerektirmez. Bakiye ödemesi isteğe bağlıdır ve anahtarınız için etkinleştirilmelidir.
Etkinleştirme olmadan, Payment_mode: bakiye içeren bir istek 403 BALANCE_PAYMENT_NOT_ENABLED değerini döndürür. Etkinleştirmek için TronBid desteğine başvurun.
| Mode | Nasıl etkinleştirilir | Ödeme |
|---|---|---|
on-chain | Varsayılan — ödeme_modu'nu (veya "zincir içi") atla | TRX'i payer_address adresinden pay_address'e gönderin |
balance | ödeme_modu: bakiye + anahtarınız için etkin | TronBid TRX bakiyenizden borçlandırıldı |
enerji_amount ve süre_dakikalar etkin bir Hızlı Kiralama paketiyle eşleşmelidir - genellikle 65.000 veya 131.000 enerji ve 15 veya 60 dakika.
Geçerli kataloğu istediğiniz zaman alın (kimlik doğrulama gerekmez):
curl -sS https://tronbid.com/api/public/quick-rent/skusAdım 1 – Fiyatı öğrenmek için POST /alıntı yapın. Adım 2 — Siparişi oluşturmak ve pay_address, miktar_trx ve expiries_at'i almak için POST /orders. Adım 3 — payer_address'inizden pay_address'e tam olarak miktar_trx TRX gönderin. Adım 4 — durum devredilinceye (veya başarısız olana/süresi dolana/iptal edilene kadar) GET /orders/:id'yi yoklayın.
hedef_adres isteğe bağlıdır; atlanırsa, enerji payer_address'e devredilir.
Payer_address başına aynı anda yalnızca bir açık zincir içi emre (pending_payment) izin verilir; aksi takdirde 409 PENDING_PAYMENT_INTENT_EXISTS alırsınız. Eksik/fazla ödeme durumunda nihai enerji farklılık gösterebilir - GET /orders/:id içindeki etkin_enerji_miktarını kontrol edin.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}Adım 1 — TRX'inizi kontrol etmek için GET /balance. Adım 2 — Fiyat için POST / fiyat teklifi verin. Adım 3 — Payment_mode ile POST /orders: borçlandırmaya bakiye ekleyin ve yetkilendirmeyi başlatın. Adım 4 — Yetki verilene kadar GET /orders/:id'yi yoklayın (yetki verme hatası durumunda başarısız olur ve TRX bakiyenize iade edilir).
payer_address gerekli değildir; API anahtarınıza bağlı hesap ödeme yapar. Yanıttaki enerji miktarı, sipariş edilen SKU'dan (fiyat matrisi bonusu) daha yüksek olabilir.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-balance-001",
"payment_mode": "balance",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 132310,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}Her sipariş bu durumlardan geçer. Takip etmek için GET /orders/:id anketini yapın.
| Status | Anlamı |
|---|---|
pending_payment | Zincir içi ödeme bekleniyor |
delegating | Ödeme alındı veya bakiye tahsil edildi; delegasyon sürüyor |
delegated | Devredilen enerji |
cancelled | Ödeme yapılmadan önce iptal edildi (zincir üzerinde) |
expired | Zincir içi ödeme penceresi sona erdi |
failed | Hata (bakiye için TRX iade edilir) |
idempotency_key (8–128 karakter), sizin tarafınızdan benzersiz bir sipariş kimliğidir. POST /orders'ın aynı anahtarla (aynı API istemcisi için) tekrarlanması, "duplicate": true ile aynı sırayı döndürür.
Bir idempotency_key'i farklı ödeme modlarında (zincir içi vs bakiye) yeniden kullanmayın; bu, 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH değerini döndürür.
Bir adresin aktarım için ne kadar enerjiye ihtiyacı olduğunu tahmin edin. Alıcının cüzdanını ve halihazırda USDT içerip içermediğini iletin.
/api/v2/quick-rent/calculator| Parametre | Type | Açıklama | Example |
|---|---|---|---|
cüzdan_adresi | string | Analiz edilecek TRON adresi | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Alıcının halihazırda USDT'ye sahip olup olmadığı (enerjiyi etkiler). doğru, yanlış veya atlayın. | true |
{
"wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"has_usdt": true
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'Bir paketin geçerli fiyatını döndürür: fiyat_trx, kullanılabilirlik, tasarruf_yüzdesi ve teklifin ne kadar süre geçerli olduğu (süre_içinde_saniye).
/api/v2/quick-rent/quote| Parametre | Type | Açıklama | Example |
|---|---|---|---|
enerji_miktarı | int | Aktif katalogdaki enerji miktarı | 131000 |
sure_dakika | int | Katalogdan kiralama süresi | 15 |
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}export BASE_URL="https://tronbid.com"
export API_KEY="your_api_key"
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"energy_amount":131000,"duration_minutes":15}'Kiralama siparişi oluşturur. Zincir içi için payer_address'i iletin ve iade edilen miktar_trx'i pay_address'e ödeyin. Bakiye için ödeme_mode: bakiye ekleyin; bağlı hesaptan ödeme hemen alınır.
target_address isteğe bağlıdır (varsayılan olarak payer_address'tir). 409 kuralına dikkat edin: Ödeme yapan kişi başına bir açık zincir içi sipariş ve hedefte halihazırda etkin bir Hızlı Kiralama delegasyonu yok (ACTIVE_DELEGATION_EXISTS).
/api/v2/quick-rent/orders| Parametre | Type | Açıklama | Example |
|---|---|---|---|
enerji_miktarı | int | Katalogdaki enerji miktarı | 131000 |
sure_dakika | int | Katalogdan kiralama süresi | 15 |
idempotency_key | string | Benzersiz sipariş kimliğiniz (8-128 karakter) | partner-onchain-001 |
ödeme_modu | string | İsteğe bağlı. "zincir üzerinde" (varsayılan) veya "denge". | balance |
ödeyen_adresi | string | Zincir üstü: TRX gönderen cüzdan. Denge için gerekli değildir. | TPayer... |
hedef_adres | string | İsteğe bağlı. Enerji alan cüzdan (varsayılanı payer_address'tir). | TTarget... |
{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 132310,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-onchain-001",
"payer_address": "TPayer...",
"target_address": "TTarget..."
}'curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-balance-001",
"payment_mode": "balance",
"target_address": "TTarget..."
}'Bir şey başarısız olursa mevcut durumu, ödeme_modunu, tutarları, adresleri ve hata_kodunu / hata_mesajını döndürür. etkin_enerji_miktarı, eksik/fazla ödeme sonrasında devredilen gerçek enerjiyi yansıtır.
/api/v2/quick-rent/orders/:id| Parametre | Type | Açıklama | Example |
|---|---|---|---|
kimlik | string | Sipariş kimliği (yol parametresi) | uuid |
{
"id": "uuid",
"status": "delegated",
"payment_mode": "onchain",
"amount_trx": "3.200000",
"energy_amount": 131000,
"effective_energy_amount": 131000,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY"Hala ödeme bekleyen bir siparişi iptal eder (yalnızca zincir üzerinde). Enerji devredildikten sonra sipariş artık iptal edilemez.
/api/v2/quick-rent/orders/:id/cancel| Parametre | Type | Açıklama | Example |
|---|---|---|---|
kimlik | string | Sipariş kimliği (yol parametresi) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Zincir üzerinde bekleyen_ödeme emri için ödeme yapan cüzdanı değiştirir; müşteri TRX'i göndermeden önce farklı bir cüzdandan ödeme yapmaya karar verirse kullanışlıdır.
/api/v2/quick-rent/orders/:id/set-payer| Parametre | Type | Açıklama | Example |
|---|---|---|---|
kimlik | string | Sipariş kimliği (yol parametresi) | uuid |
ödeyen_adresi | string | Yeni ödeme cüzdanı | TNewPayer... |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/set-payer" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"payer_address":"TNewPayer..."}'API anahtarınıza bağlı TronBid hesabının TRX bakiyesini (zincir içi cüzdan değil, uygulama içi bakiyeniz) döndürür. Yetkilendirme başlığını gerektirir.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Hatalar bir HTTP durumu ve bir hata alanı döndürür. İşte karşılaşabilecekleriniz.
| HTTP | error | Ne zaman |
|---|---|---|
| 400 | Invalid body | Geçersiz JSON veya alanlar |
| 400 | INVALID_SKU / SKU_INACTIVE | Paket mevcut değil |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Hatalı biçimlendirilmiş TRON adresi |
| 400 | INSUFFICIENT_BALANCE | Dengede yeterli TRX yok (denge modu) |
| 401 | Unauthorized | Eksik veya geçersiz API anahtarı |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Anahtarınız için bakiye ödemesi etkinleştirilmedi |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Bu ödeyici için açık bir zincir içi sipariş zaten mevcut |
| 409 | ACTIVE_DELEGATION_EXISTS | Hedefin zaten etkin bir Hızlı Kiralama temsilcisi var |
| 409 | POOL_ENERGY_INSUFFICIENT | Şu anda bedava havuz enerjisi yok |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Farklı bir ödeme_modu ile aynı idempotency_key |
| 429 | Too Many Requests | Oran sınırı |
| 503 | — | Hizmet geçici olarak kullanılamıyor, daha sonra tekrar deneyin |
Basit bir ifadeyle yaygın durumlar ve ne yapılması gerektiği.
Aktarılan tutarın tam olarak miktar_trx'e eşit olduğundan ve paranın tam ödeyen_adresinden pay_adresine gittiğinden emin olun. Transferin, expures_at tarihinden önce ulaşması gerekir. Durum genellikle ağ onayından sonraki bir dakika içinde güncellenir; GET /orders/:id'yi yoklamaya devam edin.
Delegasyon başarılı olamadı. Bakiye ödemelerinde TRX otomatik olarak bakiyenize iade edilir. Bunun nedeni GET /orders/:id'nin error_code ve error_message'ındadır. Yeni bir sipariş oluşturabilirsiniz.
Bu payer_address'in zaten ödenmemiş bir zincir üstü siparişi var. Ödeyin, süresinin dolmasını bekleyin (expires_at) veya /orders/:id/cancel aracılığıyla iptal edin, ardından yeni bir tane oluşturun.
Anahtarınız için bakiye ödemesi etkin değil. Etkinleştirmek için TronBid desteğine başvurun veya zincir üzerinde (varsayılan) kullanın.
Kısa sürede çok fazla istek var. Yoklama sıklığını azaltın (örneğin her 3 saniyede bir) ve daha sonra yeniden deneyin.
Zincir üzerinde eksik ödeme/fazla ödeme durumunda nihai tutar değişir. GET /orders/:id dosyasındaki active_energy_amount'u kontrol edin; bu, gerçekte devredilen enerjidir.
API erişiminin, daha yüksek limitlerin veya bakiye ödemesinin etkinleştirilmesi mi gerekiyor? Bize ulaşın, yardımcı olalım.