Isama ang API v2 upang mag-quote, gumawa at subaybayan ang mga order sa pagpaparenta ng TRON Energy sa pamamagitan ng program. Magbayad on-chain o mula sa iyong balanse sa TronBid at bawasan ang TRX na nasunog ng mga smart-contract na tawag.
Ang Quick Rent API ay isang paraan para awtomatikong magrenta ng TRON Energy, nang walang manual na trabaho. Ginagawa ng Energy na mas mura ang USDT (TRC-20) transfer at iba pang smart-contract na tawag kaysa sa pagsunog ng TRX.
Sa madaling salita: ang iyong programa (isang site, bot, o serbisyo) ay bumibili ng enerhiya mismo, nang eksakto kung kinakailangan — halimbawa, bago ang bawat paglipat ng USDT na gagawin ng iyong customer.
Mag-isip ng isang vending machine: tingnan mo ang presyo, magpasok ng pera, kunin ang iyong item. Ang API ay ang parehong hanay ng mga button — ang iyong program lang ang pumipindot sa kanila.
Ang iyong programa ay nagtatanong sa API kung magkano ang kailangan ng pakete ng enerhiya sa ngayon.
Lumilikha ang iyong programa ng isang order at binabayaran ito — sa pamamagitan ng pagpapadala ng TRX sa ibinigay na address o sa pamamagitan ng pagsingil sa iyong balanse sa TronBid.
Sa loob ng ilang segundo ay lalabas ang enerhiya sa target na pitaka, at ang USDT ay maaaring ipadala nang mas mura.
Mahalaga: ang API ay isang tool para sa isang developer. Upang magamit ito, kailangang magsulat ng code na nagpapadala ng mga kahilingan.
Kung walang magsusulat ng code — gamitin ang handa na pagbili ng enerhiya sa site (Mabilis na Pagrenta) o ang Telegram bot @tronbid. Parehong resulta, ginawa lamang nang manu-mano.
Isang buong end-to-end na halimbawa sa pinakasimpleng senaryo (on-chain). Apat na hakbang at enerhiya ang nasa wallet.
Nasa ibaba kung ano ang nangyayari sa bawat hakbang at kung ano ang ibinabalik ng API. Isaksak ang iyong API key, mga address at order id.
Ipadala ang dami at tagal ng enerhiya. Ibabalik mo ang price_trx at kung ilang segundo ito naka-lock.
Ipadala ang package, ang iyong idempotency_key at payer_address. Makakakuha ka ng pay_address (kung saan magbabayad), amount_trx (magkano) at mag-e-expire_sa (hanggang kailan).
Magpadala ng eksaktong amount_trx TRX sa pay_address mula sa iyong payer_address. Isa itong simpleng paglipat ng TRON.
I-poll ang status bawat ilang segundo hanggang sa ito ay maitalaga. Iyon ay nangangahulugan na ang enerhiya ay itinalaga sa wallet - tapos na.
{
"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
}Maikling paliwanag ng mga salitang ginamit sa dokumentasyong ito.
Ano ang dapat ihanda bago gawin ang iyong unang kahilingan.
Mensahe @tronbid sa Telegram — makakakuha ka ng key na nakatali sa iyong TronBid account. Ang mga kahilingan ay hindi lilipas kung wala ito.
Magpasya sa address (target_address) na nangangailangan ng enerhiya. Kadalasan ito ang wallet na pinagpapadala ng iyong mga customer ng USDT.
Ang enerhiya ay ibinebenta sa mga pakete (karaniwang 65000 o 131000 na enerhiya sa loob ng 15 o 60 minuto). Kunin ang live na listahan mula sa endpoint ng catalog, hindi kailangan ng auth.
Para sa on-chain — isang wallet na may TRX na babayaran. Para sa balanseng pagbabayad — isang pinondohan na TronBid account at pinagana ang mode ng balanse.
Hinahayaan ng Quick Rent API ang iyong serbisyo na awtomatikong magrenta ng TRON Energy, kaya ang USDT TRC-20 transfers at iba pang smart-contract na tawag ay mas mura kaysa sa pagsunog ng TRX.
Ang lahat ng mga endpoint ay nagbabahagi ng isang base URL.
https://tronbid.com/api/v2/quick-rentMayroong dalawang paraan upang magbayad para sa isang order. Ang on-chain ang default at hindi nangangailangan ng setup. Ang pagbabayad ng balanse ay opsyonal at dapat na pinagana para sa iyong susi.
Nang walang pag-activate, ang isang kahilingan na may payment_mode: ang balanse ay nagbabalik ng 403 BALANCE_PAYMENT_NOT_ENABLED. Upang paganahin ito, makipag-ugnayan sa suporta ng TronBid.
| Mode | Paano paganahin | Pagbabayad |
|---|---|---|
on-chain | Default — alisin ang payment_mode (o "onchain") | Ipadala ang TRX sa pay_address mula sa payer_address |
balance | payment_mode: balanse + pinagana para sa iyong susi | Na-debit mula sa iyong balanseng TronBid TRX |
energy_amount at duration_minutes ay dapat tumugma sa isang aktibong Quick Rent package — karaniwang 65000 o 131000 na enerhiya at 15 o 60 minuto.
Kunin ang kasalukuyang catalog anumang oras (walang auth na kailangan):
curl -sS https://tronbid.com/api/public/quick-rent/skusHakbang 1 — POST / quote para malaman ang presyo. Hakbang 2 — I-POST /order para gawin ang order at makatanggap ng pay_address, amount_trx at expires_at. Hakbang 3 — magpadala ng eksaktong amount_trx TRX sa pay_address mula sa iyong payer_address. Hakbang 4 — poll GET /orders/:id hanggang sa maitalaga ang status (o nabigo / nag-expire / nakansela).
Ang target_address ay opsyonal — kung aalisin, ang enerhiya ay delegado sa payer_address.
Isang bukas na on-chain order lamang (pending_payment) ang pinapayagan sa bawat payer_address sa isang pagkakataon; kung hindi, makakakuha ka ng 409 PENDING_PAYMENT_INTENT_EXISTS. Sa under/overpayment ang huling enerhiya ay maaaring mag-iba — tingnan ang effective_energy_amount sa 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..."
}Hakbang 1 — KUMUHA /balanse para suriin ang iyong TRX. Hakbang 2 — POST / quote para sa presyo. Hakbang 3 — POST /mga order na may payment_mode: balanse sa debit at simulan ang delegasyon. Hakbang 4 — poll GET /orders/:id hanggang sa ma-delegate (sa isang error sa delegasyon, ito ay nabigo at ang TRX ay na-refund sa iyong balanse).
hindi kailangan ang payer_address — magbabayad ang account na naka-link sa iyong API key. Ang energy_amount sa tugon ay maaaring mas mataas kaysa sa iniutos na SKU (price-matrix bonus).
{
"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..."
}Ang bawat order ay gumagalaw sa mga katayuang ito. Poll GET /orders/:id para sundin ito.
| Status | Ibig sabihin |
|---|---|
pending_payment | Naghihintay para sa on-chain na pagbabayad |
delegating | Natanggap na bayad o nasingil ang balanse; kasalukuyang delegasyon |
delegated | Na-delegate ang enerhiya |
cancelled | Kinansela bago magbayad (on-chain) |
expired | Lumipas ang on-chain na palugit ng pagbabayad |
failed | Error (para sa balanse, na-refund ang TRX) |
Ang idempotency_key (8–128 chars) ay isang natatanging order id sa iyong panig. Ang paulit-ulit na POST /order na may parehong key (para sa parehong API client) ay nagbabalik ng parehong order na may "duplicate": true.
Huwag muling gumamit ng isang idempotency_key sa iba't ibang paraan ng pagbabayad (onchain vs balanse) — na nagbabalik ng 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
Tantyahin kung gaano karaming enerhiya ang kailangan ng isang address para sa paglipat. Ipasa ang tatanggap na wallet at kung mayroon na itong USDT.
/api/v2/quick-rent/calculator| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
wallet_address | string | TRON address na susuriin | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Kung hawak na ng tatanggap ang USDT (nakakaapekto sa enerhiya). totoo, mali, o hindi. | 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}'Ibinabalik ang kasalukuyang presyo para sa isang package: price_trx, availability, save_percent at kung gaano katagal valid ang quote (expires_in_sec).
/api/v2/quick-rent/quote| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
dami_ng enerhiya | int | Halaga ng enerhiya mula sa aktibong catalog | 131000 |
tagal_minuto | int | Tagal ng pagrenta mula sa catalog | 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}'Gumagawa ng order sa pagrenta. Para sa on-chain, ipasa ang payer_address at bayaran ang ibinalik na halaga_trx sa pay_address. Para sa balanse, magdagdag ng payment_mode: balanse at agad na sisingilin ang naka-link na account.
Ang target_address ay opsyonal (default sa payer_address). Isipin ang 409 na panuntunan: isang bukas na on-chain na order bawat nagbabayad, at walang aktibong Quick Rent delegation na nasa target na (ACTIVE_DELEGATION_EXISTS).
/api/v2/quick-rent/orders| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
dami_ng enerhiya | int | Halaga ng enerhiya mula sa catalog | 131000 |
tagal_minuto | int | Tagal ng pagrenta mula sa catalog | 15 |
idempotency_key | string | Ang iyong natatanging order id (8–128 character) | partner-onchain-001 |
payment_mode | string | Opsyonal. "onchain" (default) o "balanse". | balance |
nagbabayad_address | string | On-chain: wallet na nagpapadala ng TRX. Hindi kailangan para sa balanse. | TPayer... |
target_address | string | Opsyonal. Wallet na tumatanggap ng enerhiya (default sa payer_address). | 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..."
}'Ibinabalik ang kasalukuyang status, payment_mode, mga halaga, address, at error_code / error_message kung may nabigo. Sinasalamin ng effective_energy_amount ang aktwal na nakalaang enerhiya pagkatapos ng under/overpayment.
/api/v2/quick-rent/orders/:id| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
id | string | Order id (parameter ng path) | 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"Kinakansela ang isang order na nakabinbin pa rin ang_pagbabayad (on-chain lang). Kapag na-delegate na ang enerhiya, hindi na maaaring kanselahin ang order.
/api/v2/quick-rent/orders/:id/cancel| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
id | string | Order id (parameter ng path) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Binabago ang nagbabayad na wallet para sa isang pending_payment on-chain order — kapaki-pakinabang kung ang customer ay nagpasya na magbayad mula sa ibang wallet bago magpadala ng TRX.
/api/v2/quick-rent/orders/:id/set-payer| Parameter | Type | Paglalarawan | Example |
|---|---|---|---|
id | string | Order id (parameter ng path) | uuid |
nagbabayad_address | string | Bagong nagbabayad na wallet | 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..."}'Ibinabalik ang balanse ng TRX ng TronBid account na naka-link sa iyong API key (iyong in-app na balanse, hindi isang on-chain wallet). Nangangailangan ng header ng Authorization.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Ang mga error ay nagbabalik ng HTTP status at isang error field. Narito ang mga maaaring makaharap mo.
| HTTP | error | kailan |
|---|---|---|
| 400 | Invalid body | Di-wastong JSON o mga field |
| 400 | INVALID_SKU / SKU_INACTIVE | Hindi available ang package |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Maling porma ng TRON address |
| 400 | INSUFFICIENT_BALANCE | Hindi sapat ang TRX sa balanse (balance mode) |
| 401 | Unauthorized | Nawawala o di-wastong API key |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Hindi pinagana ang pagbabayad ng balanse para sa iyong susi |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Mayroon nang bukas na on-chain na order para sa nagbabayad na ito |
| 409 | ACTIVE_DELEGATION_EXISTS | Ang Target ay mayroon nang aktibong delegasyon ng Mabilis na Rent |
| 409 | POOL_ENERGY_INSUFFICIENT | Walang libreng pool energy sa ngayon |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Parehong idempotency_key na may ibang payment_mode |
| 429 | Too Many Requests | Hangganan ng rate |
| 503 | — | Pansamantalang hindi available ang serbisyo, subukang muli sa ibang pagkakataon |
Mga karaniwang sitwasyon at kung ano ang gagawin, sa simpleng salita.
Tiyaking eksaktong katumbas ng amount_trx ang nailipat na halaga at napunta ang mga pondo sa pay_address mula sa eksaktong payer_address. Dapat dumating ang paglipat bago mag-expire_at. Karaniwang nag-a-update ang status sa loob ng isang minuto pagkatapos ng kumpirmasyon ng network — ipagpatuloy ang pagboto GET /orders/:id.
Hindi nagtagumpay ang delegasyon. Para sa mga pagbabayad sa balanse ang TRX ay awtomatikong ibinabalik sa iyong balanse. Ang dahilan ay nasa error_code at error_message ng GET /orders/:id. Maaari kang lumikha ng isang bagong order.
Ang payer_address na ito ay mayroon nang hindi nabayarang on-chain order. Bayaran ito, hintayin itong mag-expire (expires_at), o kanselahin ito sa pamamagitan ng /orders/:id/cancel, pagkatapos ay gumawa ng bago.
Ang pagbabayad ng balanse ay hindi pinagana para sa iyong susi. Makipag-ugnayan sa suporta ng TronBid para i-activate ito, o gamitin ang on-chain (ang default).
Masyadong maraming kahilingan sa maikling panahon. Ibaba ang dalas ng botohan (hal. isang beses bawat 3 segundo) at subukang muli sa ibang pagkakataon.
Sa underpayment/overpayment on-chain, nagbabago ang huling halaga. Suriin ang effective_energy_amount sa GET /orders/:id — iyon ang aktwal na nakalaang enerhiya.
Kailangan ba ng API access, mas mataas na limitasyon, o balanseng pagbabayad? Umabot at tutulungan namin.