TRON एनर्जी रेंटल ऑर्डर को प्रोग्रामेटिक रूप से उद्धृत करने, बनाने और ट्रैक करने के लिए API v2 को एकीकृत करें। ऑन-चेन या अपने TronBid बैलेंस से भुगतान करें और स्मार्ट-कॉन्ट्रैक्ट कॉल द्वारा खर्च किए गए TRX को कम करें।
क्विक रेंट एपीआई बिना किसी मैन्युअल काम के TRON एनर्जी को स्वचालित रूप से किराए पर लेने का एक तरीका है। एनर्जी USDT (TRC-20) ट्रांसफर और अन्य स्मार्ट-कॉन्ट्रैक्ट कॉल्स को TRX बर्न करने की तुलना में सस्ता बनाती है।
स्पष्ट शब्दों में: आपका प्रोग्राम (एक साइट, बॉट, या सेवा) स्वयं ऊर्जा खरीदता है, ठीक उसी समय जब इसकी आवश्यकता होती है - उदाहरण के लिए, आपके ग्राहक द्वारा किए गए प्रत्येक यूएसडीटी हस्तांतरण से पहले।
एक वेंडिंग मशीन के बारे में सोचें: आप कीमत की जांच करते हैं, पैसे डालते हैं, अपना सामान प्राप्त करते हैं। एपीआई बटनों का एक ही सेट है - केवल आपका प्रोग्राम उन्हें दबाता है।
आपका प्रोग्राम एपीआई से पूछता है कि अभी आवश्यक ऊर्जा पैकेज की लागत कितनी है।
आपका प्रोग्राम एक ऑर्डर बनाता है और उसका भुगतान करता है - दिए गए पते पर TRX भेजकर या आपका TronBid बैलेंस चार्ज करके।
कुछ ही सेकंड में लक्ष्य वॉलेट पर ऊर्जा दिखाई देती है, और यूएसडीटी को सस्ता भेजा जा सकता है।
महत्वपूर्ण: एपीआई एक डेवलपर के लिए एक उपकरण है। इसका उपयोग करने के लिए, किसी को कोड लिखना होगा जो अनुरोध भेजता है।
यदि कोड लिखने वाला कोई नहीं है - साइट पर तैयार ऊर्जा खरीद (क्विक रेंट) या टेलीग्राम बॉट @tronbid का उपयोग करें। वही परिणाम, बस मैन्युअल रूप से किया गया।
सबसे सरल परिदृश्य (ऑन-चेन) पर एक पूर्ण एंड-टू-एंड उदाहरण। चार कदम और ऊर्जा बटुए पर है।
नीचे बताया गया है कि प्रत्येक चरण पर क्या होता है और एपीआई क्या लौटाता है। अपनी एपीआई कुंजी, पते और ऑर्डर आईडी प्लग इन करें।
ऊर्जा की मात्रा एवं अवधि भेजें. आपको Price_trx वापस मिलता है और यह कितने सेकंड के लिए लॉक है।
पैकेज, अपना idempotency_key और भुगतानकर्ता_पता भेजें। आपको pay_address (कहाँ भुगतान करना है), amount_trx (कितना) और expires_at (कब तक) मिलता है।
अपने भुगतानकर्ता पते से भुगतान पते पर बिल्कुल amount_trx TRX भेजें। यह एक सादा TRON स्थानांतरण है।
जब तक यह प्रत्यायोजित न हो जाए तब तक हर कुछ सेकंड में स्थिति का सर्वेक्षण करें। इसका मतलब है कि ऊर्जा बटुए को सौंप दी गई है - हो गया।
{
"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
}इस दस्तावेज़ में प्रयुक्त शब्दों की संक्षिप्त व्याख्या।
अपना पहला अनुरोध करने से पहले क्या तैयारी करें?
टेलीग्राम पर @tronbid संदेश भेजें - आपको अपने TronBid खाते से जुड़ी एक कुंजी मिलेगी। इसके बिना अनुरोध पारित नहीं होंगे.
वह पता (target_address) तय करें जिसके लिए ऊर्जा की आवश्यकता है। आमतौर पर यह वह वॉलेट है जिससे आपके ग्राहक यूएसडीटी भेजते हैं।
ऊर्जा पैकेजों में बेची जाती है (आमतौर पर 15 या 60 मिनट के लिए 65000 या 131000 ऊर्जा)। कैटलॉग एंडपॉइंट से लाइव सूची प्राप्त करें, किसी प्रमाणीकरण की आवश्यकता नहीं है।
ऑन-चेन के लिए - भुगतान करने के लिए टीआरएक्स वाला एक वॉलेट। शेष भुगतान के लिए - एक वित्तपोषित TronBid खाता और शेष मोड सक्षम।
क्विक रेंट एपीआई आपकी सेवा को TRON एनर्जी को स्वचालित रूप से किराए पर लेने की सुविधा देता है, इसलिए USDT TRC-20 ट्रांसफर और अन्य स्मार्ट-कॉन्ट्रैक्ट कॉल की लागत TRX को जलाने से कम होती है।
सभी समापन बिंदु एक आधार URL साझा करते हैं।
https://tronbid.com/api/v2/quick-rentकिसी ऑर्डर के लिए भुगतान करने के दो तरीके हैं। ऑन-चेन डिफ़ॉल्ट है और इसके लिए किसी सेटअप की आवश्यकता नहीं है। शेष भुगतान वैकल्पिक है और आपकी कुंजी के लिए सक्षम होना चाहिए।
सक्रियण के बिना, payment_mode: शेष राशि वाला अनुरोध 403 BALANCE_PAYMENT_NOT_ENABLED लौटाता है। इसे सक्षम करने के लिए, TronBid समर्थन से संपर्क करें।
| Mode | कैसे सक्षम करें | भुगतान |
|---|---|---|
on-chain | डिफ़ॉल्ट - payment_mode (या "ऑनचेन") को छोड़ दें | भुगतानकर्ता_पते से भुगतान पते पर टीआरएक्स भेजें |
balance | भुगतान_मोड: आपकी कुंजी के लिए शेष राशि + सक्षम | आपके TronBid TRX बैलेंस से डेबिट किया गया |
ऊर्जा_राशि और अवधि_मिनट एक सक्रिय त्वरित किराया पैकेज से मेल खाना चाहिए - आमतौर पर 65000 या 131000 ऊर्जा और 15 या 60 मिनट।
किसी भी समय वर्तमान कैटलॉग प्राप्त करें (किसी लेख की आवश्यकता नहीं):
curl -sS https://tronbid.com/api/public/quick-rent/skusचरण 1 - कीमत जानने के लिए पोस्ट/उद्धरण करें। चरण 2 - ऑर्डर बनाने और pay_address, amount_trx और expires_at प्राप्त करने के लिए POST /orders। चरण 3 - अपने भुगतानकर्ता पते से भुगतान पते पर बिल्कुल amount_trx TRX भेजें। चरण 4 - स्थिति प्रत्यायोजित (या विफल / समाप्त / रद्द) होने तक पोल GET /orders/:id करें।
target_address वैकल्पिक है - यदि छोड़ दिया जाए, तो ऊर्जा payer_address को सौंप दी जाती है।
एक समय में प्रति भुगतानकर्ता पते पर केवल एक ओपन ऑन-चेन ऑर्डर (लंबित_भुगतान) की अनुमति है; अन्यथा आपको 409 PENDING_PAYMENT_INTENT_EXISTS मिलेंगे। कम/अधिक भुगतान पर अंतिम ऊर्जा भिन्न हो सकती है - 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..."
}चरण 1 - अपना टीआरएक्स जांचने के लिए /बैलेंस प्राप्त करें। चरण 2 - मूल्य के लिए पोस्ट/उद्धरण। चरण 3 - भुगतान_मोड के साथ पोस्ट / ऑर्डर: डेबिट करने और प्रतिनिधिमंडल शुरू करने के लिए शेष। चरण 4 - प्रत्यायोजित होने तक GET /orders/:id पर मतदान करें (प्रतिनिधित्व त्रुटि पर यह विफल हो जाता है और TRX आपके शेष राशि में वापस कर दिया जाता है)।
payer_address की आवश्यकता नहीं है - आपकी API कुंजी से जुड़ा खाता भुगतान करता है। प्रतिक्रिया में ऊर्जा राशि आदेशित SKU (मूल्य-मैट्रिक्स बोनस) से अधिक हो सकती है।
{
"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..."
}प्रत्येक आदेश इन स्थितियों के माध्यम से चलता है। इसका पालन करने के लिए पोल GET /orders/:id प्राप्त करें।
| Status | मतलब |
|---|---|
pending_payment | ऑन-चेन भुगतान की प्रतीक्षा की जा रही है |
delegating | भुगतान प्राप्त हुआ या बकाया शेष; प्रतिनिधिमंडल प्रगति पर है |
delegated | ऊर्जा प्रत्यायोजित |
cancelled | भुगतान से पहले रद्द किया गया (ऑन-चेन) |
expired | ऑन-चेन भुगतान विंडो समाप्त हो गई |
failed | त्रुटि (शेष राशि के लिए, TRX वापस कर दिया गया है) |
idempotency_key (8-128 वर्ण) आपकी ओर से एक अद्वितीय ऑर्डर आईडी है। एक ही कुंजी (एक ही एपीआई क्लाइंट के लिए) के साथ POST/ऑर्डर को दोहराने से "डुप्लिकेट" के साथ एक ही ऑर्डर मिलता है: सत्य।
विभिन्न भुगतान मोड (ऑनचेन बनाम बैलेंस) में एक idempotency_key का पुन: उपयोग न करें - जो 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH लौटाता है।
अनुमान लगाएं कि किसी पते को स्थानांतरण के लिए कितनी ऊर्जा की आवश्यकता है। प्राप्तकर्ता वॉलेट को पास करें और क्या उसमें पहले से ही यूएसडीटी है।
/api/v2/quick-rent/calculator| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
बटुआ_पता | string | विश्लेषण करने के लिए TRON पता | TXXXXXXXX...XXXX |
has_usdt | boolean | null | क्या प्राप्तकर्ता के पास पहले से ही यूएसडीटी है (ऊर्जा को प्रभावित करता है)। सत्य, असत्य, या छोड़ा गया। | 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}'किसी पैकेज के लिए वर्तमान मूल्य लौटाता है: Price_trx, उपलब्धता, save_percent और कोटेशन कितने समय तक वैध है (समाप्त_in_sec)।
/api/v2/quick-rent/quote| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
ऊर्जा_राशि | int | सक्रिय कैटलॉग से ऊर्जा की मात्रा | 131000 |
अवधि_मिनट | int | कैटलॉग से किराये की अवधि | 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}'किराये का ऑर्डर बनाता है. ऑन-चेन के लिए, payer_address पास करें और pay_address पर लौटाई गई राशि_trx का भुगतान करें। शेष राशि के लिए, payment_mode: शेष राशि जोड़ें और लिंक किए गए खाते से तुरंत शुल्क लिया जाएगा।
target_address वैकल्पिक है (भुगतानकर्ता_पता पर डिफ़ॉल्ट)। 409 नियमों का ध्यान रखें: प्रति भुगतानकर्ता एक खुला ऑन-चेन ऑर्डर, और लक्ष्य पर पहले से ही कोई सक्रिय त्वरित किराया प्रतिनिधिमंडल नहीं (ACTIVE_DELEGATION_EXISTS)।
/api/v2/quick-rent/orders| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
ऊर्जा_राशि | int | कैटलॉग से ऊर्जा राशि | 131000 |
अवधि_मिनट | int | कैटलॉग से किराये की अवधि | 15 |
idempotency_key | string | आपकी अद्वितीय ऑर्डर आईडी (8-128 वर्ण) | partner-onchain-001 |
भुगतान_मोड | string | वैकल्पिक. "ऑनचेन" (डिफ़ॉल्ट) या "बैलेंस"। | balance |
भुगतानकर्ता_पता | string | ऑन-चेन: वॉलेट जो टीआरएक्स भेजता है। संतुलन के लिए आवश्यक नहीं. | TPayer... |
लक्ष्य_पता | string | वैकल्पिक. वॉलेट जो ऊर्जा प्राप्त करता है (भुगतानकर्ता_पता पर डिफ़ॉल्ट)। | 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..."
}'कुछ विफल होने पर वर्तमान स्थिति, भुगतान_मोड, राशि, पते और त्रुटि_कोड/त्रुटि_संदेश लौटाता है। प्रभावी_ऊर्जा_राशि कम/अधिक भुगतान के बाद वास्तविक प्रत्यायोजित ऊर्जा को दर्शाती है।
/api/v2/quick-rent/orders/:id| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
आईडी | string | ऑर्डर आईडी (पथ पैरामीटर) | 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"उस ऑर्डर को रद्द कर देता है जिसका भुगतान अभी भी लंबित है (केवल ऑन-चेन)। एक बार ऊर्जा प्रत्यायोजित हो जाने के बाद, आदेश को रद्द नहीं किया जा सकता।
/api/v2/quick-rent/orders/:id/cancel| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
आईडी | string | ऑर्डर आईडी (पथ पैरामीटर) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"लंबित_भुगतान ऑन-चेन ऑर्डर के लिए भुगतान वॉलेट को बदलता है - यदि ग्राहक टीआरएक्स भेजने से पहले एक अलग वॉलेट से भुगतान करने का निर्णय लेता है तो उपयोगी है।
/api/v2/quick-rent/orders/:id/set-payer| पैरामीटर | Type | विवरण | Example |
|---|---|---|---|
आईडी | string | ऑर्डर आईडी (पथ पैरामीटर) | uuid |
भुगतानकर्ता_पता | string | नया भुगतान बटुआ | 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..."}'आपकी एपीआई कुंजी से जुड़े TronBid खाते का TRX बैलेंस लौटाता है (आपका इन-ऐप बैलेंस, ऑन-चेन वॉलेट नहीं)। प्राधिकरण शीर्षलेख की आवश्यकता है.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"त्रुटियाँ एक HTTP स्थिति और एक त्रुटि फ़ील्ड लौटाती हैं। यहां वे हैं जिनसे आपका सामना हो सकता है।
| HTTP | error | कब |
|---|---|---|
| 400 | Invalid body | अमान्य JSON या फ़ील्ड |
| 400 | INVALID_SKU / SKU_INACTIVE | पैकेज अनुपलब्ध |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | विकृत TRON पता |
| 400 | INSUFFICIENT_BALANCE | बैलेंस पर पर्याप्त TRX नहीं (बैलेंस मोड) |
| 401 | Unauthorized | गुम या अमान्य API कुंजी |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | आपकी कुंजी के लिए शेष भुगतान सक्षम नहीं है |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | इस भुगतानकर्ता के लिए एक खुला ऑन-चेन ऑर्डर पहले से मौजूद है |
| 409 | ACTIVE_DELEGATION_EXISTS | लक्ष्य के पास पहले से ही एक सक्रिय त्वरित किराया प्रतिनिधिमंडल है |
| 409 | POOL_ENERGY_INSUFFICIENT | अभी कोई निःशुल्क पूल ऊर्जा नहीं है |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | भिन्न भुगतान_मोड के साथ समान idempotency_key |
| 429 | Too Many Requests | दर सीमा |
| 503 | — | सेवा अस्थायी रूप से अनुपलब्ध है, बाद में पुनः प्रयास करें |
सामान्य स्थितियाँ और क्या करें, स्पष्ट शब्दों में।
सुनिश्चित करें कि हस्तांतरित राशि बिल्कुल amount_trx के बराबर है और धनराशि सटीक भुगतानकर्ता_पते से भुगतान_पते पर गई है। स्थानांतरण समाप्ति तिथि से पहले आ जाना चाहिए। स्थिति आम तौर पर नेटवर्क पुष्टि के बाद एक मिनट के भीतर अपडेट हो जाती है - GET /orders/:id पर मतदान करते रहें।
प्रतिनिधिमंडल सफल नहीं हुआ. शेष भुगतान के लिए टीआरएक्स स्वचालित रूप से आपके शेष में वापस कर दिया जाता है। इसका कारण GET /orders/:id के error_code और error_message में है। आप एक नया ऑर्डर बना सकते हैं.
इस भुगतानकर्ता_पते पर पहले से ही एक अवैतनिक ऑन-चेन ऑर्डर है। इसका भुगतान करें, इसके समाप्त होने (expires_at) की प्रतीक्षा करें, या इसे /orders/:id/cancel के माध्यम से रद्द करें, फिर एक नया बनाएं।
आपकी कुंजी के लिए शेष भुगतान सक्षम नहीं है. इसे सक्रिय करने के लिए TronBid समर्थन से संपर्क करें, या ऑन-चेन (डिफ़ॉल्ट) का उपयोग करें।
कम समय में बहुत अधिक अनुरोध. मतदान की आवृत्ति कम करें (उदाहरण के लिए हर 3 सेकंड में एक बार) और बाद में पुनः प्रयास करें।
ऑन-चेन पर कम भुगतान/अधिक भुगतान के साथ अंतिम राशि बदल जाती है। GET /orders/:id में प्रभावशाली_ऊर्जा_राशि जांचें - यही वह ऊर्जा है जो वास्तव में सौंपी गई है।
एपीआई एक्सेस, उच्च सीमा या शेष भुगतान सक्षम करने की आवश्यकता है? पहुंचें और हम मदद करेंगे.