API REST v2Dokumentasi diperbarui 2 Agustus 2026

API Penyewaan Energi TRON — Mengotomatiskan Transfer USDT TRC-20

Integrasikan API v2 untuk mengutip, membuat, dan melacak pesanan sewa TRON Energy secara terprogram. Bayar secara on-chain atau dari saldo TronBid Anda dan kurangi TRX yang dibakar oleh panggilan kontrak pintar.

Kutipan langsung dan katalog paket
Pembayaran on-chain atau saldo
Perintah idempoten dan jajak pendapat status

Dapatkan akses API Buka Mulai Cepat Sewa Energi tanpa API Hitung kebutuhan Energi

Di halaman ini

API Penyewaan Energi TRON: ikhtisar dan kasus penggunaan

Quick Rent API adalah cara menyewa TRON Energy secara otomatis, tanpa pekerjaan manual. Energi membuat transfer USDT (TRC-20) dan panggilan kontrak pintar lainnya lebih murah daripada membakar TRX.

Sederhananya: program Anda (situs, bot, atau layanan) membeli energi itu sendiri, tepat pada saat dibutuhkan — misalnya, sebelum setiap transfer USDT yang dilakukan pelanggan Anda.

Bayangkan sebuah mesin penjual otomatis: Anda memeriksa harga, memasukkan uang, mengambil barang Anda. API adalah kumpulan tombol yang sama — hanya program Anda yang menekannya.

1
Mintalah harganya
Program Anda menanyakan API berapa biaya paket energi yang dibutuhkan saat ini.
2
Buat pesanan dan bayar
Program Anda membuat pesanan dan membayarnya — dengan mengirimkan TRX ke alamat yang diberikan atau dengan menagih saldo TronBid Anda.
3
Dapatkan energinya
Dalam beberapa detik energi muncul di dompet target, dan USDT dapat dikirim lebih murah.

Penting: API adalah alat untuk pengembang. Untuk menggunakannya, seseorang harus menulis kode yang mengirimkan permintaan.

Jika tidak ada yang menulis kode — gunakan pembelian energi yang sudah jadi di situs (Quick Rent) atau bot Telegram @tronbid. Hasilnya sama, hanya dilakukan secara manual.

Mulai cepat: dari nol hingga energi

Contoh lengkap end-to-end pada skenario paling sederhana (on-chain). Empat langkah dan energi ada di dompet.

Di bawah ini adalah apa yang terjadi pada setiap langkah dan apa yang dikembalikan oleh API. Masukkan kunci API, alamat, dan id pesanan Anda.

1
Langkah 1. Dapatkan harga — POST /quote
Kirim jumlah dan durasi energi. Anda mendapatkan price_trx kembali dan berapa detik terkunci.
2
Langkah 2. Buat pesanan — POST /orders
Kirimkan paket, kunci_idempotensi, dan alamat_pembayar Anda. Anda mendapatkan pay_address (tempat membayar), amount_trx (berapa) dan expired_at (sampai kapan).
3
Langkah 3. Bayar
Kirim tepat amount_trx TRX ke pay_address dari pembayar_address Anda. Ini adalah transfer TRON biasa.
4
Langkah 4. Tunggu energi — GET /orders/:id
Jajak pendapat status setiap beberapa detik hingga didelegasikan. Itu berarti energi didelegasikan ke dompet — selesai.

Tanggapan

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

Respons (on-chain)

json

{
  "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..."
}

keriting

bash

# 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

Tanggapan

json

{
  "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
}

Glosarium

Penjelasan singkat tentang kata-kata yang digunakan dalam dokumentasi ini.

Energi: "Bahan bakar" jaringan TRON untuk operasi kontrak pintar. Jika jumlahnya tidak cukup, jaringan akan membakar TRX — yang mana biayanya lebih mahal. Menyewa energi menghemat uang.
TRX: Koin asli jaringan TRON. Ia membayar sewa energi dan biaya jaringan.
USDT TRC-20: Stablecoin (dolar) di TRON. Mengirimkannya adalah panggilan kontrak pintar yang membutuhkan energi.
Kunci API: Kata sandi rahasia Anda untuk akses API. Dikirim dengan setiap permintaan. Simpan di server saja.
Titik akhir: Alamat khusus-"tombol" API tempat program Anda mengirimkan permintaan (mis. /quote — dapatkan harga).
DAPATKAN / POSTING: Jenis permintaan. GET artinya "hanya bertanya/membaca data"; POST berarti "melakukan suatu tindakan" (membuat pesanan, menghitung harga).
Token pembawa: Bagaimana Anda meneruskan kunci API: headernya berbunyi Otorisasi: Pembawa KUNCI ANDA.
Pembayaran on-chain: Membayar pesanan dengan transfer TRX biasa ke alamat yang diberikan — langsung berfungsi, tidak ada yang diaktifkan.
Pembayaran saldo: Membayar dengan menagih saldo akun TronBid Anda. Lebih cepat, namun harus diaktifkan untuk kunci Anda terlebih dahulu.
Delegasi: Menyerahkan sementara energi sewaan ke dompet target selama periode sewa (misalnya 15 atau 60 menit).
pemungutan suara: Menanyakan ulang status pesanan secara berkala (setiap beberapa detik) hingga terdelegasi atau berakhir dengan kesalahan.
kunci_idempotensi: ID pesanan unik Anda. Jika permintaan dikirim dua kali, API akan mengembalikan pesanan yang sama alih-alih membuat pesanan baru — perlindungan terhadap pembayaran ganda.

Sebelum Anda mulai

Apa yang harus dipersiapkan sebelum mengajukan permintaan pertama Anda.

1
Dapatkan kunci API
Pesan @tronbid di Telegram — Anda akan mendapatkan kunci yang terikat ke akun TronBid Anda. Permintaan tidak akan lolos tanpanya.
2
Miliki dompet TRON target
Tentukan alamat (target_address) yang membutuhkan energi. Biasanya itu adalah dompet tempat pelanggan Anda mengirim USDT.
3
Pilih paket dari katalog
Energi dijual dalam bentuk paket (biasanya 65000 atau 131000 energi selama 15 atau 60 menit). Dapatkan daftar langsung dari titik akhir katalog, tidak diperlukan autentikasi.
4
Siapkan pembayaran
Untuk on-chain — dompet dengan TRX untuk membayar. Untuk pembayaran saldo — akun TronBid yang didanai dan mode saldo diaktifkan.

URL dasar API produksi

Quick Rent API memungkinkan layanan Anda menyewa TRON Energy secara otomatis, sehingga transfer USDT TRC-20 dan panggilan kontrak pintar lainnya lebih murah dibandingkan membakar TRX.

Semua titik akhir berbagi satu URL dasar.

URL Dasar (produksi)

http

https://tronbid.com/api/v2/quick-rent

Otorisasi

Setiap permintaan harus menyertakan kunci API Anda sebagai token Pembawa di header Otorisasi.

Simpan kunci di sisi server saja (backend, rahasia CI). Jangan pernah mengirimkannya dalam kode frontend atau repositori publik. Kuncinya terikat pada satu akun TronBid (dompet disetel saat akses diberikan); pembayaran saldo hanya dapat ditarik dari akun itu.

Jika Anda melebihi batas kapasitas, API akan merespons dengan HTTP 429.

http

Authorization: Bearer <API_KEY>

Mode Pembayaran

Ada dua cara untuk membayar pesanan. On-chain adalah default dan tidak memerlukan pengaturan. Pembayaran saldo bersifat opsional dan harus diaktifkan untuk kunci Anda.

Tanpa aktivasi, permintaan dengan mode_pembayaran: saldo mengembalikan 403 BALANCE_PAYMENT_NOT_ENABLED. Untuk mengaktifkannya, hubungi dukungan TronBid.

Mode	Cara mengaktifkan	Pembayaran
`on-chain`	Default — hilangkan mode_pembayaran (atau "onchain")	Kirim TRX ke alamat_bayar dari alamat_pembayar
`balance`	mode_pembayaran: saldo + diaktifkan untuk kunci Anda	Didebit dari saldo TronBid TRX Anda

Katalog Paket

jumlah_energi dan durasi_menit harus sesuai dengan paket Quick Rent yang aktif — biasanya 65.000 atau 131.000 energi dan 15 atau 60 menit.

Ambil katalog saat ini kapan saja (tidak diperlukan autentikasi):

Dapatkan katalog aktif (tanpa autentikasi)

bash

curl -sS https://tronbid.com/api/public/quick-rent/skus

Aliran On-chain

Langkah 1 — POST /quote untuk mengetahui harganya. Langkah 2 — POST /pesanan untuk membuat pesanan dan menerima alamat_bayar, jumlah_trx, dan kadaluwarsa_at. Langkah 3 — kirim jumlah_trx TRX ke alamat_bayar dari alamat_pembayar Anda. Langkah 4 — polling GET /orders/:id hingga status didelegasikan (atau gagal/kedaluwarsa/dibatalkan).

target_address bersifat opsional — jika dihilangkan, energi didelegasikan ke payer_address.

Hanya satu pesanan on-chain terbuka (pembayaran_tertunda) yang diperbolehkan per alamat_pembayar dalam satu waktu; jika tidak, Anda mendapatkan 409 PENDING_PAYMENT_INTENT_EXISTS. Jika kurang/lebih bayar, energi akhir mungkin berbeda — periksa jumlah_energi_efektif di GET /orders/:id.

Permintaan tubuh

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Tanggapan

json

{
  "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..."
}

Aliran Keseimbangan

Langkah 1 — DAPATKAN /saldo untuk memeriksa TRX Anda. Langkah 2 — POST/kutipan untuk harganya. Langkah 3 — POST /pesanan dengan mode_pembayaran: saldo ke debit dan mulai delegasi. Langkah 4 — polling GET /orders/:id hingga didelegasikan (jika terjadi kesalahan delegasi, maka gagal dan TRX dikembalikan ke saldo Anda).

payer_address tidak diperlukan — akun yang ditautkan ke kunci API Anda akan membayar. Jumlah_energi dalam respons bisa lebih tinggi dari SKU yang dipesan (bonus matriks harga).

Permintaan tubuh

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Tanggapan

json

{
  "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..."
}

Status Pesanan

Setiap pesanan bergerak melalui status ini. Jajak pendapat GET /orders/:id untuk mengikutinya.

Status	Arti
`pending_payment`	Menunggu pembayaran on-chain
`delegating`	Pembayaran diterima atau saldo dibebankan; delegasi sedang berlangsung
`delegated`	Energi didelegasikan
`cancelled`	Dibatalkan sebelum pembayaran (on-chain)
`expired`	Jendela pembayaran on-chain telah berlalu
`failed`	Error (untuk saldo, TRX dikembalikan)

Idempotensi

idempotency_key (8–128 karakter) adalah id pesanan unik di pihak Anda. Mengulangi POST /orders dengan kunci yang sama (untuk klien API yang sama) akan mengembalikan urutan yang sama dengan "duplikat": true.

Jangan gunakan kembali satu idempotency_key di mode pembayaran yang berbeda (onchain vs saldo) — yang akan menghasilkan 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Hitung kebutuhan sewa TRON Energy

Perkirakan berapa banyak energi yang dibutuhkan suatu alamat untuk transfer. Berikan dompet penerima dan apakah dompet tersebut sudah menyimpan USDT.

POST/api/v2/quick-rent/calculator

Parameter

Parameter	Type	Keterangan	Example
`dompet_alamat`	string	Alamat TRON untuk dianalisis	`TXXXXXXXX...XXXX`
`memiliki_usdt`	boolean \| null	Apakah penerima sudah memiliki USDT (mempengaruhi energi). benar, salah, atau dihilangkan.	`true`

Permintaan tubuh

json

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

keriting

bash

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}'

Dapatkan penawaran sewa TRON Energy

Mengembalikan harga saat ini untuk sebuah paket: price_trx, ketersediaan, save_percent dan berapa lama penawaran berlaku (expires_in_sec).

POST/api/v2/quick-rent/quote

Parameter

Parameter	Type	Keterangan	Example
`energi_jumlah`	int	Jumlah energi dari katalog aktif	`131000`
`durasi_menit`	int	Durasi sewa dari katalog	`15`

Tanggapan

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

keriting

bash

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}'

Buat pesanan sewa TRON Energy

Membuat pesanan sewa. Untuk on-chain, berikan alamat_pembayar dan bayar jumlah_trx yang dikembalikan ke alamat_bayar. Untuk saldo, tambahkan mode_pembayaran: saldo dan akun tertaut akan segera ditagih.

target_address bersifat opsional (defaultnya adalah payer_address). Perhatikan aturan 409: satu pesanan on-chain terbuka per pembayar, dan tidak ada delegasi Quick Rent aktif yang sudah mencapai target (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Parameter

Parameter	Type	Keterangan	Example
`energi_jumlah`	int	Jumlah energi dari katalog	`131000`
`durasi_menit`	int	Durasi sewa dari katalog	`15`
`kunci_idempotensi`	string	ID pesanan unik Anda (8–128 karakter)	`partner-onchain-001`
`mode_pembayaran`	string	Opsional. "onchain" (default) atau "keseimbangan".	`balance`
`pembayar_alamat`	string	On-chain: dompet yang mengirimkan TRX. Tidak diperlukan untuk keseimbangan.	`TPayer...`
`alamat_target`	string	Opsional. Dompet yang menerima energi (default pada alamat_pembayar).	`TTarget...`

Respons (on-chain)

json

{
  "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..."
}

Respon (keseimbangan)

json

{
  "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 (on-rantai)

bash

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..."
  }'

keriting (saldo)

bash

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..."
  }'

Dapatkan Status Pesanan

Mengembalikan status saat ini, mode_pembayaran, jumlah, alamat, dan kode_kesalahan/pesan_kesalahan jika terjadi kegagalan. jumlah_energi_efektif mencerminkan energi sebenarnya yang didelegasikan setelah kurang/lebih bayar.

GET/api/v2/quick-rent/orders/:id

Parameter

Parameter	Type	Keterangan	Example
`pengenal`	string	Id pesanan (parameter jalur)	`uuid`

Tanggapan

json

{
  "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
}

keriting

bash

curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

Batalkan Pesanan

Membatalkan pesanan yang masih menunggu_pembayaran (khusus on-chain). Setelah energi didelegasikan, pesanan tidak dapat dibatalkan lagi.

POST/api/v2/quick-rent/orders/:id/cancel

Parameter

Parameter	Type	Keterangan	Example
`pengenal`	string	Id pesanan (parameter jalur)	`uuid`

keriting

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Ganti Pembayar

Mengubah dompet pembayaran untuk pesanan on-chain pending_pembayaran — berguna jika pelanggan memutuskan untuk membayar dari dompet lain sebelum mengirim TRX.

POST/api/v2/quick-rent/orders/:id/set-payer

Parameter

Parameter	Type	Keterangan	Example
`pengenal`	string	Id pesanan (parameter jalur)	`uuid`
`pembayar_alamat`	string	Dompet pembayaran baru	`TNewPayer...`

keriting

bash

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..."}'

Periksa saldo API TronBid

Mengembalikan saldo TRX dari akun TronBid yang ditautkan ke kunci API Anda (saldo dalam aplikasi Anda, bukan dompet on-chain). Membutuhkan header Otorisasi.

GET/api/v2/quick-rent/balance

Tanggapan

json

{ "balance_trx": "150.500000" }

keriting

bash

curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
  -H "Authorization: Bearer $API_KEY"

Kode Kesalahan

Kesalahan mengembalikan status HTTP dan bidang kesalahan. Inilah yang mungkin Anda temui.

HTTP	error	Kapan
400	`Invalid body`	JSON atau kolom tidak valid
400	`INVALID_SKU / SKU_INACTIVE`	Paket tidak tersedia
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Alamat TRON salah format
400	`INSUFFICIENT_BALANCE`	TRX pada saldo tidak cukup (mode keseimbangan)
401	`Unauthorized`	Kunci API tidak ada atau tidak valid
403	`BALANCE_PAYMENT_NOT_ENABLED`	Pembayaran saldo tidak diaktifkan untuk kunci Anda
409	`PENDING_PAYMENT_INTENT_EXISTS`	Pesanan on-chain terbuka sudah ada untuk pembayar ini
409	`ACTIVE_DELEGATION_EXISTS`	Target sudah memiliki delegasi Quick Rent yang aktif
409	`POOL_ENERGY_INSUFFICIENT`	Tidak ada energi kolam gratis saat ini
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Kunci_idempotensi yang sama dengan mode_pembayaran yang berbeda
429	`Too Many Requests`	Batas tarif
503	`—`	Layanan untuk sementara tidak tersedia, coba lagi nanti

Jika terjadi kesalahan

Situasi umum dan apa yang harus dilakukan, dengan kata sederhana.

Saya sudah membayar tetapi pesanan terhenti di pending_pembayaran

Pastikan jumlah yang ditransfer sama persis dengan jumlah_trx dan dana masuk ke alamat_pembayaran dari alamat_pembayar yang tepat. Transfer harus sampai sebelum expired_at. Status biasanya diperbarui dalam satu menit setelah konfirmasi jaringan — teruskan polling GET /orders/:id.

Statusnya menjadi gagal — apa itu?

Delegasi tidak berhasil. Untuk pembayaran saldo TRX otomatis dikembalikan ke saldo Anda. Alasannya ada di error_code dan error_message dari GET /orders/:id. Anda dapat membuat pesanan baru.

Kesalahan 409 PENDING_PAYMENT_INTENT_EXISTS

Alamat_pembayar ini sudah memiliki pesanan on-chain yang belum dibayar. Bayar, tunggu sampai habis masa berlakunya (expires_at), atau batalkan lewat /orders/:id/cancel, lalu buat yang baru.

Kesalahan 403 BALANCE_PAYMENT_NOT_ENABLED

Pembayaran saldo tidak diaktifkan untuk kunci Anda. Hubungi dukungan TronBid untuk mengaktifkannya, atau gunakan on-chain (default).

Kesalahan 429 Terlalu Banyak Permintaan

Terlalu banyak permintaan dalam waktu singkat. Turunkan frekuensi polling (misalnya setiap 3 detik sekali) dan coba lagi nanti.

Saya mendapat lebih sedikit energi daripada yang saya pesan

Dengan kekurangan/kelebihan pembayaran secara on-chain, jumlah akhir berubah. Periksa Effective_energy_amount di GET /orders/:id — itulah energi yang sebenarnya didelegasikan.

Dukungan integrasi TRON Energy API

Perlu akses API, batas lebih tinggi, atau pembayaran saldo diaktifkan? Hubungi kami dan kami akan membantu.

Akses API & pembayaran saldoTelegram @tronbid

E-mailsupport@tronbid.com