Unganisha API v2 ili kunukuu, kuunda na kufuatilia maagizo ya kukodisha ya TRON Energy kwa utaratibu. Lipa kwa mnyororo au kutoka kwa salio lako la TronBid na upunguze TRX inayochomwa na simu za mikataba mahiri.
API ya Kukodisha Haraka ni njia ya kukodisha TRON Energy kiotomatiki, bila kazi ya mikono. Nishati hufanya uhamishaji wa USDT (TRC-20) na simu zingine za mikataba mahiri kuwa nafuu kuliko kuchoma TRX.
Kwa maneno rahisi: programu yako (tovuti, bot, au huduma) hununua nishati yenyewe, haswa wakati inahitajika - kwa mfano, kabla ya kila uhamisho wa USDT mteja wako kufanya.
Fikiria mashine ya kuuza: unaangalia bei, ingiza pesa, pata bidhaa yako. API ni seti sawa ya vitufe - programu yako pekee ndiyo inayoibonyeza.
Mpango wako unauliza API ni kiasi gani cha kifurushi cha nishati kinachohitajika sasa hivi.
Mpango wako huunda agizo na kulilipa - kwa kutuma TRX kwa anwani uliyopewa au kwa kutoza salio lako la TronBid.
Ndani ya sekunde chache nishati inaonekana kwenye pochi inayolengwa, na USDT inaweza kutumwa kwa bei nafuu.
Muhimu: API ni zana ya msanidi programu. Ili kuitumia, mtu lazima aandike nambari inayotuma maombi.
Ikiwa hakuna mtu wa kuandika msimbo - tumia ununuzi wa nishati ulio tayari kufanywa kwenye tovuti (Kukodisha Haraka) au bot ya Telegram @tronbid. Matokeo sawa, yamefanywa tu kwa mikono.
Mfano kamili wa mwisho-hadi-mwisho kwenye hali rahisi zaidi (kwenye-mnyororo). Hatua nne na nishati iko kwenye mkoba.
Ifuatayo ni kile kinachotokea kwa kila hatua na kile API inarudi. Chomeka ufunguo wako wa API, anwani na kitambulisho cha agizo.
Tuma kiasi cha nishati na muda. Utarudishiwa price_trx na imefungwa kwa sekunde ngapi.
Tuma kifurushi, ufunguo_wa_itambulisho na anwani_ya_mlipaji. Unapata pay_address (mahali pa kulipa), amount_trx (kiasi gani) na inaisha_saa (hadi lini).
Tuma kiasi_trx TRX haswa ili kulipa_anwani_ya_mlipaji. Ni uhamisho wa kawaida wa TRON.
Piga kura kila baada ya sekunde kadhaa hadi iwe imekabidhiwa. Hiyo ina maana kwamba nishati imekabidhiwa kwa pochi - imekamilika.
{
"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
}Maelezo mafupi ya maneno yaliyotumika katika hati hii.
Nini cha kuandaa kabla ya kufanya ombi lako la kwanza.
Tuma ujumbe kwa @tronbid kwenye Telegram - utapata ufunguo unaounganishwa kwenye akaunti yako ya TronBid. Maombi hayatapita bila hiyo.
Amua anwani (lengwa_anwani) inayohitaji nishati. Kawaida ni mkoba ambao wateja wako hutuma USDT kutoka.
Nishati inauzwa katika vifurushi (kawaida 65000 au 131000 nishati kwa dakika 15 au 60). Pata orodha ya moja kwa moja kutoka mwisho wa katalogi, hakuna uthibitishaji unaohitajika.
Kwa mnyororo - pochi iliyo na TRX ya kulipa. Kwa malipo ya salio - akaunti inayofadhiliwa ya TronBid na hali ya salio imewashwa.
API ya Kukodisha Haraka huruhusu huduma yako kukodisha TRON Energy kiotomatiki, kwa hivyo uhamisho wa USDT TRC-20 na simu zingine za mikataba mahiri hugharimu kidogo kuliko kuchoma TRX.
Vituo vyote vya mwisho vinashiriki URL moja ya msingi.
https://tronbid.com/api/v2/quick-rentKuna njia mbili za kulipia agizo. On-chain ndio chaguo-msingi na hauhitaji kusanidi. Malipo ya salio ni ya hiari na lazima yawashwe kwa ufunguo wako.
Bila kuwezesha, ombi lenye hali_ya_malipo: salio hurejesha 403 BALANCE_PAYMENT_NOT_ENABLED. Ili kuiwasha, wasiliana na usaidizi wa TronBid.
| Mode | Jinsi ya kuwezesha | Malipo |
|---|---|---|
on-chain | Chaguo-msingi - acha njia_ya malipo (au "onchain") | Tuma TRX kwa pay_anwani kutoka kwa mlipaji_anwani |
balance | pay_mode: salio + limewezeshwa kwa ufunguo wako | Inatozwa kutoka kwa salio lako la TronBid TRX |
nishati_kiasi na muda_dakika lazima zilingane na kifurushi kinachotumika cha Kukodisha Haraka - kwa kawaida nishati 65000 au 131000 na dakika 15 au 60.
Leta katalogi ya sasa wakati wowote (hakuna uthibitisho unaohitajika):
curl -sS https://tronbid.com/api/public/quick-rent/skusHatua ya 1 — POST /nukuu ili kujifunza bei. Hatua ya 2 — POST / maagizo ili kuunda agizo na kupokea pay_address, amount_trx na expires_at. Hatua ya 3 — tuma kiasi_trx TRX haswa ili kulipa_anwani kutoka kwa mlipaji_anwani yako. Hatua ya 4 — kura ya maoni PATA /orders/:id hadi hali ikabidhiwe (au ilishindikana / kuisha muda / kughairiwa).
target_address ni ya hiari - ikiwa imeachwa, nishati hukabidhiwa kwa payer_address.
Agizo moja tu la wazi la mtandaoni (pending_payment) linaruhusiwa kwa kila anwani_ya_mlipaji kwa wakati mmoja; vinginevyo utapata 409 PENDING_PAYMENT_INTENT_EXISTS. Kwa malipo ya chini/ya ziada nishati ya mwisho inaweza kutofautiana - angalia ufanisi_energy_amount katika 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..."
}Hatua ya 1 - PATA / salio ili kuangalia TRX yako. Hatua ya 2 — POST /nukuu kwa bei. Hatua ya 3 — POST/maagizo kwa njia ya malipo: salio ili utoe na uanze kutoa kaumu. Hatua ya 4 — piga kura PATA /orders/:id hadi ikabidhiwe (kwa hitilafu ya kaumu itashindikana na TRX itarejeshwa kwenye salio lako).
payer_address haihitajiki - akaunti iliyounganishwa na ufunguo wako wa API inalipa. Kiasi_cha nishati katika jibu kinaweza kuwa kikubwa zaidi kuliko SKU iliyoagizwa ( bonasi ya matrix ya bei).
{
"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..."
}Kila agizo hupitia hali hizi. Piga kura ya GET /orders/:id ili kuifuata.
| Status | Maana |
|---|---|
pending_payment | Inasubiri malipo ya mtandaoni |
delegating | Malipo yaliyopokelewa au salio linatozwa; ujumbe ukiendelea |
delegated | Nishati imekabidhiwa |
cancelled | Imeghairiwa kabla ya malipo (kwa mnyororo) |
expired | Dirisha la malipo ya mtandaoni limepita |
failed | Hitilafu (kwa salio, TRX inarejeshwa) |
idempotency_key (chara 8–128) ni kitambulisho cha kipekee cha kuagiza kwa upande wako. Kurudia POST / maagizo kwa ufunguo sawa (kwa mteja sawa wa API) hurejesha mpangilio sawa na "duplicate": true.
Usitumie tena ufunguo mmoja wa idempotency kwenye njia tofauti za malipo (onchain vs salio) — hiyo itarejesha 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
Kadiria ni kiasi gani cha nishati ambacho anwani inahitaji kwa uhamisho. Pitisha pochi ya mpokeaji na kama tayari ina USDT.
/api/v2/quick-rent/calculator| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
mkoba_anwani | string | Anwani ya TRON ya kuchambua | TXXXXXXXX...XXXX |
ina_usdt | boolean | null | Ikiwa mpokeaji tayari ana USDT (inaathiri nishati). kweli, uongo, au kuacha. | 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}'Hurejesha bei ya sasa ya kifurushi: price_trx, upatikanaji, save_percent na muda ambao bei ni halali (expires_in_sec).
/api/v2/quick-rent/quote| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
nishati_kiasi | int | Kiasi cha nishati kutoka kwa katalogi inayotumika | 131000 |
muda_dakika | int | Muda wa kukodisha kutoka kwa katalogi | 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}'Huunda agizo la kukodisha. Kwa mnyororo, pitisha anwani_ya_ya_mlipaji na ulipe kiasi_trx kilichorejeshwa ili kulipa_anwani. Kwa salio, ongeza njia_ya malipo: salio na akaunti iliyounganishwa itatozwa mara moja.
target_address ni hiari (chaguo-msingi kwa mlipaji_anwani). Zingatia sheria za 409: agizo moja la wazi la mtandaoni kwa kila mlipaji, na hakuna ujumbe unaotumika wa Kukodisha Haraka ambao tayari umelenga lengwa (ACTIVE_DELEGATION_EXISTS).
/api/v2/quick-rent/orders| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
nishati_kiasi | int | Kiasi cha nishati kutoka kwa orodha | 131000 |
muda_dakika | int | Muda wa kukodisha kutoka kwa katalogi | 15 |
idempotency_key | string | Kitambulisho chako cha kipekee cha agizo (herufi 8–128) | partner-onchain-001 |
malipo_modi | string | Hiari. "onchain" (chaguo-msingi) au "usawa". | balance |
mlipaji_anwani | string | Kwenye mnyororo: pochi inayotuma TRX. Haihitajiki kwa usawa. | TPayer... |
anwani_lengwa | string | Hiari. Wallet inayopokea nishati (chaguo-msingi kwa anwani_ya_mlipaji). | 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..."
}'Hurejesha hali ya sasa, njia_ya_malipo, kiasi, anwani, na msimbo_wa_kosa / error_message ikiwa jambo fulani halijafaulu. ufanisi_nishati_kiasi huonyesha nishati halisi iliyokabidhiwa baada ya malipo ya chini/ya kupita kiasi.
/api/v2/quick-rent/orders/:id| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
kitambulisho | string | Kitambulisho cha agizo (kigezo cha njia) | 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"Hughairi agizo ambalo bado linasubiri_malipo (kwa mnyororo pekee). Nishati ikishakabidhiwa, agizo haliwezi kughairiwa tena.
/api/v2/quick-rent/orders/:id/cancel| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
kitambulisho | string | Kitambulisho cha agizo (kigezo cha njia) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Hubadilisha pochi ya kulipia kwa agizo la pending_payment on-chain — ni muhimu ikiwa mteja ataamua kulipa kutoka kwa pochi tofauti kabla ya kutuma TRX.
/api/v2/quick-rent/orders/:id/set-payer| Kigezo | Type | Maelezo | Example |
|---|---|---|---|
kitambulisho | string | Kitambulisho cha agizo (kigezo cha njia) | uuid |
mlipaji_anwani | string | Pochi mpya ya kulipia | 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..."}'Hurejesha salio la TRX la akaunti ya TronBid iliyounganishwa na ufunguo wako wa API (salio lako la ndani ya programu, si pochi ya mtandaoni). Inahitaji kichwa cha Uidhinishaji.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Hitilafu hurejesha hali ya HTTP na sehemu ya hitilafu. Hapa ndio unaweza kukutana nao.
| HTTP | error | Wakati |
|---|---|---|
| 400 | Invalid body | JSON au sehemu zisizo sahihi |
| 400 | INVALID_SKU / SKU_INACTIVE | Kifurushi hakipatikani |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Anwani ya TRON yenye hitilafu |
| 400 | INSUFFICIENT_BALANCE | TRX haitoshi kwenye salio (hali ya usawa) |
| 401 | Unauthorized | Ufunguo wa API haupo au batili |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Malipo ya salio hayajawezeshwa kwa ufunguo wako |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Agizo la wazi la mnyororo tayari lipo kwa mlipaji huyu |
| 409 | ACTIVE_DELEGATION_EXISTS | Lengo tayari lina ujumbe unaoendelea wa Kukodisha Haraka |
| 409 | POOL_ENERGY_INSUFFICIENT | Hakuna nishati ya bwawa bila malipo kwa sasa |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Ufunguo_uo huo wa idempotency na njia_tofauti ya malipo |
| 429 | Too Many Requests | Kiwango cha juu |
| 503 | — | Huduma haipatikani kwa sasa, jaribu tena baadaye |
Hali za kawaida na nini cha kufanya, kwa maneno wazi.
Hakikisha kuwa kiasi kilichohamishwa kinalingana kabisa na amount_trx na pesa zilienda kwa pay_address kutoka kwa anwani_ya_ya_mlipaji kamili. Uhamisho lazima ufike kabla ya kuisha_saa. Kwa kawaida hali husasishwa ndani ya dakika moja baada ya uthibitisho wa mtandao — endelea kupiga kura GET /orders/:id.
Uteuzi haukufaulu. Kwa malipo ya salio TRX inarejeshwa kiotomatiki kwenye salio lako. Sababu iko kwenye error_code na error_message ya GET /orders/:id. Unaweza kuunda agizo jipya.
Anwani hii_ya_mlipaji tayari ina agizo la mtandaoni ambalo halijalipwa. Lipe, subiri hadi muda wake uishe (expires_at), au ughairi kupitia /orders/:id/cancel, kisha uunde mpya.
Malipo ya salio hayajawezeshwa kwa ufunguo wako. Wasiliana na usaidizi wa TronBid ili kuiwasha, au tumia kwenye mnyororo (chaguo-msingi).
Maombi mengi sana kwa muda mfupi. Punguza marudio ya upigaji kura (k.m. mara moja kila sekunde 3) na ujaribu tena baadaye.
Pamoja na malipo ya chini/malipo ya ziada kwenye mnyororo kiasi cha mwisho hubadilika. Angalia effective_energy_amount katika GET /orders/:id - hiyo ndiyo nishati iliyokabidhiwa.
Je, unahitaji ufikiaji wa API, viwango vya juu zaidi, au malipo ya salio kuwashwa? Wasiliana nasi tutakusaidia.