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.
Hantar pakej, kunci_ideampotensi anda dan alamat_pembayar. Anda mendapat alamat_bayar (tempat untuk membayar), jumlah_trx (berapa) dan tamat tempoh_pada (sehingga bila).
Hantar dengan tepat jumlah_trx TRX ke alamat_bayar daripada alamat_pembayar anda. Ia adalah pemindahan TRON biasa.
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_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") | Hantar TRX ke alamat_bayar dari alamat_pembayar |
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/skusLangkah 1 — POS/sebut harga untuk mengetahui harga. Langkah 2 — POS /pesanan untuk membuat pesanan dan terima alamat_bayar, jumlah_trx dan tamat tempoh_pada. Langkah 3 — hantar dengan tepat jumlah_trx TRX ke alamat_bayar daripada alamat_pembayar anda. Langkah 4 — undian GET /orders/:id sehingga status diwakilkan (atau gagal / tamat tempoh / dibatalkan).
target_address adalah pilihan — jika ditinggalkan, tenaga diwakilkan kepada pembayar_address.
Hanya satu pesanan dalam rantaian terbuka (pending_payment) dibenarkan bagi setiap alamat_pembayar pada satu masa; jika tidak, anda mendapat 409 PENDING_PAYMENT_INTENT_EXISTS. Apabila kurang/lebih bayar tenaga akhir mungkin berbeza — semak jumlah_tenaga_berkesan dalam GET /orders/:id.
{
"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..."
}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}'Membuat pesanan sewa. Untuk rantaian, hantar alamat_pembayar dan bayar jumlah_trx yang dikembalikan kepada alamat_bayar. Untuk baki, tambah payment_mode: baki dan akaun yang dipautkan dicaj serta-merta.
target_address adalah pilihan (lalai kepada pembayar_address). Perhatikan peraturan 409: satu pesanan dalam rantaian terbuka bagi setiap pembayar, dan tiada delegasi Sewa Pantas yang aktif sudah berada pada sasaran (ACTIVE_DELEGATION_EXISTS).
/api/v2/quick-rent/orders| Parameter | Type | Penerangan | Example |
|---|---|---|---|
jumlah_tenaga | int | Jumlah tenaga daripada katalog | 131000 |
tempoh_minit | int | Tempoh sewa dari katalog | 15 |
kunci_dempotensi | string | ID pesanan unik anda (8–128 aksara) | partner-onchain-001 |
mod_bayaran | string | Pilihan. "onchain" (lalai) atau "baki". | balance |
alamat_pembayar | string | On-chain: dompet yang menghantar TRX. Tidak diperlukan untuk keseimbangan. | TPayer... |
alamat_sasaran | string | Pilihan. Dompet yang menerima tenaga (lalai kepada alamat_pembayar). | 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..."
}'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"Menukar dompet pembayar untuk pesanan dalam rantaian_pending_payment — berguna jika pelanggan memutuskan untuk membayar daripada dompet lain sebelum menghantar TRX.
/api/v2/quick-rent/orders/:id/set-payer| Parameter | Type | Penerangan | Example |
|---|---|---|---|
id | string | Id pesanan (parameter laluan) | uuid |
alamat_pembayar | string | Dompet pembayaran baharu | 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..."}'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 | Pesanan dalam rantaian terbuka sudah wujud untuk pembayar ini |
| 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.
Pastikan jumlah yang dipindahkan betul-betul sama dengan amount_trx dan dana pergi ke alamat_bayar dari alamat_pembayar yang tepat. Pemindahan mesti tiba sebelum tamat_pada. Status biasanya dikemas kini dalam masa seminit selepas pengesahan rangkaian — teruskan mengundi GET /orders/:id.
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.
Alamat_pembayar ini sudah mempunyai pesanan dalam rantaian yang belum dibayar. Bayar, tunggu sehingga tamat tempoh (expires_at), atau batalkan melalui /orders/:id/cancel, kemudian buat yang baharu.
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.