Integrasikan API v2 untuk memetik, mencipta dan menjejaki pesanan sewaan TRON Energy secara pemrograman. Bayar dalam rantaian atau daripada baki TronBid anda dan kurangkan TRX yang dibakar oleh panggilan kontrak pintar.
API Sewa Pantas ialah cara untuk menyewa TRON Energy secara automatik, tanpa kerja manual. Tenaga menjadikan pemindahan USDT (TRC-20) dan panggilan kontrak pintar lain lebih murah daripada membakar TRX.
Secara ringkasnya: program anda (tapak, bot atau perkhidmatan) membeli tenaga itu sendiri, tepat apabila ia diperlukan — contohnya, sebelum setiap pemindahan USDT yang dibuat pelanggan anda.
Fikirkan mesin layan diri: anda menyemak harga, memasukkan wang, dapatkan item anda. API ialah set butang yang sama — hanya program anda yang menekannya.
Program anda bertanya kepada API berapa kos pakej tenaga yang diperlukan sekarang.
Program anda membuat pesanan dan membayarnya — dengan menghantar TRX ke alamat yang diberikan atau dengan mengecaj baki TronBid anda.
Dalam masa beberapa saat tenaga muncul pada dompet sasaran, dan USDT boleh dihantar dengan lebih murah.
Penting: API ialah alat untuk pembangun. Untuk menggunakannya, seseorang perlu menulis kod yang menghantar permintaan.
Jika tiada sesiapa untuk menulis kod — gunakan pembelian tenaga siap sedia di tapak (Sewa Pantas) atau bot Telegram @tronbid. Hasil yang sama, hanya dilakukan secara manual.
Contoh hujung-ke-hujung penuh pada senario paling mudah (on-chain). Empat langkah dan tenaga ada pada dompet.
Di bawah ialah perkara yang berlaku pada setiap langkah dan apa yang dikembalikan oleh API. Palamkan kunci API, alamat dan id pesanan anda.
Hantar jumlah dan tempoh tenaga. Anda mendapat semula price_trx dan berapa saat ia dikunci.
Penerima sumber: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Bayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. Hantar jumlah tepat ke alamat pembayaran dalam pesanan ini sebelum tamat tempoh. Jangan gunakan semula alamat pembayaran pesanan terdahulu. (amount_trx TRX → pay_address; expires_at)
Tinjau status setiap beberapa saat sehingga ia diwakilkan. Ini bermakna tenaga diwakilkan kepada dompet — selesai.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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
}Penjelasan ringkas tentang perkataan yang digunakan dalam dokumentasi ini.
Apa yang perlu disediakan sebelum membuat permintaan pertama anda.
Mesej @tronbid di Telegram — anda akan mendapat kunci yang terikat pada akaun TronBid anda. Permintaan tidak akan lulus tanpanya.
Tentukan alamat (alamat_sasaran) yang memerlukan tenaga. Biasanya ia adalah dompet pelanggan anda menghantar USDT.
Tenaga dijual dalam pakej (biasanya 65000 atau 131000 tenaga selama 15 atau 60 minit). Dapatkan senarai langsung daripada titik akhir katalog, tiada pengesahan diperlukan.
Untuk on-chain — dompet dengan TRX untuk membayar. Untuk pembayaran baki — akaun TronBid yang dibiayai dan mod baki didayakan.
API Sewa Pantas membolehkan perkhidmatan anda menyewa TRON Energy secara automatik, jadi pemindahan USDT TRC-20 dan panggilan kontrak pintar lain lebih murah daripada membakar TRX.
Semua titik akhir berkongsi satu URL asas.
https://tronbid.com/api/v2/quick-rentTerdapat dua cara untuk membayar pesanan. On-chain ialah lalai dan tidak memerlukan persediaan. Pembayaran baki adalah pilihan dan mesti didayakan untuk kunci anda.
Tanpa pengaktifan, permintaan dengan payment_mode: baki mengembalikan 403 BALANCE_PAYMENT_NOT_ENABLED. Untuk mendayakannya, hubungi sokongan TronBid.
| Mode | Bagaimana untuk membolehkan | Bayaran |
|---|---|---|
on-chain | Lalai — tinggalkan payment_mode (atau "onchain") | Bayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. amount_trx TRX → pay_address |
balance | payment_mode: baki + didayakan untuk kunci anda | Didebitkan daripada baki TronBid TRX anda |
tenaga_jumlah dan tempoh_minit mesti sepadan dengan pakej Sewa Pantas yang aktif — biasanya 65000 atau 131000 tenaga dan 15 atau 60 minit.
Ambil katalog semasa pada bila-bila masa (tiada pengesahan diperlukan):
curl -sS https://tronbid.com/api/public/quick-rent/skusBayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. Hantar jumlah tepat ke alamat pembayaran dalam pesanan ini sebelum tamat tempoh. Jangan gunakan semula alamat pembayaran pesanan terdahulu.
Alias lama pilihan untuk target_address; tidak mengehadkan dompet yang digunakan untuk pembayaran.
Hantar jumlah tepat ke alamat pembayaran dalam pesanan ini sebelum tamat tempoh. Jangan gunakan semula alamat pembayaran pesanan terdahulu.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payment_mode": "onchain",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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..."
}Langkah 1 — DAPATKAN /baki untuk menyemak TRX anda. Langkah 2 — POS/sebut harga untuk harga. Langkah 3 — POS /pesanan dengan payment_mode: baki kepada debit dan mulakan delegasi. Langkah 4 — undian GET /orders/:id sehingga diwakilkan (atas ralat perwakilan ia menjadi gagal dan TRX dikembalikan kepada baki anda).
alamat_pembayar tidak diperlukan — akaun yang dipautkan kepada kunci API anda membayar. Jumlah_tenaga dalam respons boleh lebih tinggi daripada SKU yang dipesan (bonus matriks harga).
{
"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..."
}Setiap pesanan bergerak melalui status ini. Poll GET /orders/:id untuk mengikutinya.
| Status | Maknanya |
|---|---|
pending_payment | Menunggu pembayaran on-chain |
delegating | Bayaran diterima atau baki dicaj; delegasi sedang berjalan |
delegated | Tenaga diwakilkan |
cancelled | Dibatalkan sebelum pembayaran (on-chain) |
expired | Tetingkap pembayaran dalam rantai telah berlalu |
failed | Ralat (untuk baki, TRX dibayar balik) |
kunci_idempotensi (8–128 aksara) ialah id pesanan unik di sebelah anda. Mengulang POST /pesanan dengan kunci yang sama (untuk klien API yang sama) mengembalikan pesanan yang sama dengan "pendua": benar.
Jangan gunakan semula satu kunci_idempotensi merentas mod pembayaran yang berbeza (onchain vs baki) — yang mengembalikan 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
Anggarkan berapa banyak tenaga yang diperlukan oleh alamat untuk pemindahan. Lulus dompet penerima dan sama ada ia sudah memegang USDT.
/api/v2/quick-rent/calculator| Parameter | Type | Penerangan | Example |
|---|---|---|---|
alamat_dompet | string | Alamat TRON untuk dianalisis | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Sama ada penerima sudah memegang USDT (menjejaskan tenaga). benar, salah atau tidak. | 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}'Mengembalikan harga semasa untuk pakej: price_trx, ketersediaan, save_percent dan tempoh sebut harga sah (tamat tempoh_dalam_saat).
/api/v2/quick-rent/quote| Parameter | Type | Penerangan | Example |
|---|---|---|---|
jumlah_tenaga | int | Jumlah tenaga daripada katalog aktif | 131000 |
tempoh_minit | int | Tempoh sewa dari katalog | 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}'Bayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Hantar jumlah tepat ke alamat pembayaran dalam pesanan ini sebelum tamat tempoh. Jangan gunakan semula alamat pembayaran pesanan terdahulu.
/api/v2/quick-rent/orders| Parameter | Type | Penerangan | Example |
|---|---|---|---|
energy_amount | int | Jumlah tenaga daripada katalog | 131000 |
duration_minutes | int | Tempoh sewa dari katalog | 15 |
idempotency_key | string | ID pesanan unik anda (8–128 aksara) | partner-onchain-001 |
payment_mode | string | Pilihan. "onchain" (lalai) atau "baki". | balance |
payer_address | string | Alias lama pilihan untuk target_address; tidak mengehadkan dompet yang digunakan untuk pembayaran. | TTarget... |
target_address | string | Penerima sumber. Bayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. | TTarget... |
{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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",
"payment_mode": "onchain",
"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..."
}'Mengembalikan status semasa, mod_bayaran, jumlah, alamat dan kod_ralat / mesej_ralat jika sesuatu gagal. jumlah_tenaga_berkesan mencerminkan tenaga yang diwakilkan sebenar selepas kurang/lebih bayar.
/api/v2/quick-rent/orders/:id| Parameter | Type | Penerangan | Example |
|---|---|---|---|
id | string | Id pesanan (parameter laluan) | 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"Membatalkan pesanan yang masih menunggu_pembayaran (on-chain sahaja). Apabila tenaga telah diwakilkan, pesanan tidak boleh dibatalkan lagi.
/api/v2/quick-rent/orders/:id/cancel| Parameter | Type | Penerangan | Example |
|---|---|---|---|
id | string | Id pesanan (parameter laluan) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Mengembalikan baki TRX akaun TronBid yang dipautkan ke kunci API anda (baki dalam apl anda, bukan dompet dalam rantai). Memerlukan pengepala Kebenaran.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Ralat mengembalikan status HTTP dan medan ralat. Berikut adalah yang mungkin anda hadapi.
| HTTP | error | bila |
|---|---|---|
| 400 | Invalid body | JSON atau medan tidak sah |
| 400 | INVALID_SKU / SKU_INACTIVE | Pakej tidak tersedia |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Alamat TRON cacat |
| 400 | INSUFFICIENT_BALANCE | TRX pada baki tidak mencukupi (mod baki) |
| 401 | Unauthorized | Kunci API tiada atau tidak sah |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Pembayaran baki tidak didayakan untuk kunci anda |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Penerima sumber: pending_payment |
| 409 | ACTIVE_DELEGATION_EXISTS | Sasaran sudah mempunyai delegasi Sewa Pantas yang aktif |
| 409 | POOL_ENERGY_INSUFFICIENT | Tiada tenaga kolam percuma sekarang |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Kunci_idempotensi yang sama dengan mod_pembayaran yang berbeza |
| 429 | Too Many Requests | Had kadar |
| 503 | — | Perkhidmatan tidak tersedia buat sementara waktu, cuba semula kemudian |
Situasi biasa dan perkara yang perlu dilakukan, dengan kata mudah.
Hantar jumlah tepat ke alamat pembayaran dalam pesanan ini sebelum tamat tempoh. Jangan gunakan semula alamat pembayaran pesanan terdahulu. Bayar TRX daripada mana-mana dompet. Energy atau Bandwidth akan dihantar kepada penerima yang dinyatakan dalam pesanan. Tidak perlu memilih dompet pembayaran. GET /orders/:id → status
Delegasi tidak berjaya. Untuk pembayaran baki TRX dikembalikan secara automatik ke baki anda. Sebabnya adalah dalam error_code dan error_message GET /orders/:id. Anda boleh membuat pesanan baharu.
Penerima sumber: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
Pembayaran baki tidak didayakan untuk kunci anda. Hubungi sokongan TronBid untuk mengaktifkannya, atau gunakan dalam rantaian (lalai).
Terlalu banyak permintaan dalam masa yang singkat. Kurangkan kekerapan pengundian (cth. sekali setiap 3 saat) dan cuba semula kemudian.
Dengan kurang bayar/lebih bayar dalam rantaian, jumlah akhir berubah. Semak effective_energy_amount dalam GET /orders/:id — itulah tenaga yang sebenarnya diwakilkan.
Perlukan akses API, had yang lebih tinggi atau pembayaran baki didayakan? Hubungi kami dan kami akan membantu.