TRON انرجی رینٹل API — USDT TRC-20 ٹرانسفرز کو خودکار کریں۔

TRON انرجی رینٹل API: جائزہ اور استعمال کے معاملات

کوئیک رینٹ API بغیر کسی دستی کام کے TRON Energy کو خود بخود کرایہ پر لینے کا ایک طریقہ ہے۔ توانائی USDT (TRC-20) کی منتقلی اور دیگر سمارٹ کنٹریکٹ کالز کو TRX کو جلانے سے سستا بناتی ہے۔

صاف لفظوں میں: آپ کا پروگرام (ایک سائٹ، بوٹ، یا سروس) خود توانائی خریدتا ہے، بالکل اسی وقت جب اس کی ضرورت ہوتی ہے — مثال کے طور پر، ہر USDT منتقلی سے پہلے جو آپ کا صارف کرتا ہے۔

ایک وینڈنگ مشین کے بارے میں سوچو: آپ قیمت چیک کرتے ہیں، رقم ڈالتے ہیں، اپنی چیز حاصل کرتے ہیں۔ API بٹنوں کا ایک ہی سیٹ ہے - صرف آپ کا پروگرام انہیں دباتا ہے۔

کوئیک سٹارٹ: صفر سے توانائی تک

سادہ ترین منظر نامے پر ایک مکمل آخر سے آخر تک مثال (آن چین)۔ چار قدم اور توانائی بٹوے پر ہے۔

ذیل میں بتایا گیا ہے کہ ہر قدم پر کیا ہوتا ہے اور API کیا واپس کرتا ہے۔ اپنی API کلید، پتے اور آرڈر آئی ڈی پلگ ان کریں۔

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

لغت

اس دستاویز میں استعمال ہونے والے الفاظ کی مختصر وضاحت۔

اس سے پہلے کہ آپ شروع کریں۔

اپنی پہلی درخواست کرنے سے پہلے کیا تیاری کرنی ہے۔

پروڈکشن API کا بنیادی URL

کوئیک رینٹ API آپ کی سروس کو خود بخود TRON Energy کرایہ پر لینے دیتا ہے، لہذا USDT TRC-20 ٹرانسفرز اور دیگر سمارٹ کنٹریکٹ کالز کی قیمت TRX کو جلانے سے کم ہے۔

تمام اینڈ پوائنٹس ایک بنیادی URL کا اشتراک کرتے ہیں۔

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

اجازت

ہر درخواست میں آپ کی API کلید کو اجازت نامے کے ہیڈر میں بطور بیئرر ٹوکن شامل کرنا چاہیے۔

صرف کلیدی سرور سائیڈ رکھیں (بیک اینڈ، CI راز)۔ اسے کبھی بھی فرنٹ اینڈ کوڈ یا عوامی ذخیروں میں نہ بھیجیں۔ کلید ایک واحد TronBid اکاؤنٹ سے منسلک ہے (رسائی ملنے پر بٹوے کا سیٹ)؛ بیلنس کی ادائیگی صرف اسی اکاؤنٹ سے حاصل کی جا سکتی ہے۔

اگر آپ شرح کی حد سے تجاوز کرتے ہیں تو API HTTP 429 کے ساتھ جواب دیتا ہے۔

Authorization: Bearer <API_KEY>

ادائیگی کے طریقے

آرڈر کی ادائیگی کے دو طریقے ہیں۔ آن چین ڈیفالٹ ہے اور اسے کسی سیٹ اپ کی ضرورت نہیں ہے۔ بیلنس کی ادائیگی اختیاری ہے اور آپ کی کلید کے لیے فعال ہونا ضروری ہے۔

ایکٹیویشن کے بغیر، payment_mode کے ساتھ ایک درخواست: بیلنس 403 BALANCE_PAYMENT_NOT_ENABLED واپس کرتا ہے۔ اسے فعال کرنے کے لیے، TronBid سپورٹ سے رابطہ کریں۔

پیکیج کیٹلاگ

انرجی_ماؤنٹ اور دورانیہ_منٹ کا ایک فعال کوئیک رینٹ پیکج سے مماثل ہونا چاہیے — عام طور پر 65000 یا 131000 توانائی اور 15 یا 60 منٹ۔

موجودہ کیٹلاگ کو کسی بھی وقت حاصل کریں (کوئی تصدیق کی ضرورت نہیں):

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

آن چین فلو

مرحلہ 1 - قیمت جاننے کے لیے پوسٹ/اقتباس کریں۔ مرحلہ 2 - آرڈر بنانے کے لیے پوسٹ/آرڈرز کریں اور پے_ایڈریس، رقم_ٹی آر ایکس اور ایکسپائر_اٹ وصول کریں۔ مرحلہ 3 — اپنے payer_address سے pay_address پر بالکل رقم_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 - اپنا TRX چیک کرنے کے لیے بیلنس حاصل کریں۔ مرحلہ 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 اس پر عمل کرنے کے لیے۔

بے حسی

idempotency_key (8–128 حروف) آپ کی طرف سے ایک منفرد آرڈر آئی ڈی ہے۔ ایک ہی کلید (اسی API کلائنٹ کے لیے) کے ساتھ POST/orders کو دہرانے سے "ڈپلیکیٹ": true کے ساتھ وہی آرڈر واپس آتا ہے۔

ادائیگی کے مختلف طریقوں (آنچین بمقابلہ بیلنس) میں ایک idempotency_key کو دوبارہ استعمال نہ کریں — جو 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH لوٹاتا ہے۔

TRON انرجی رینٹل کی ضروریات کا حساب لگائیں۔

اندازہ لگائیں کہ ایک پتہ کی منتقلی کے لیے کتنی توانائی کی ضرورت ہے۔ وصول کنندہ کے بٹوے کو پاس کریں اور آیا یہ پہلے سے USDT رکھتا ہے۔

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

TRON انرجی رینٹل کی قیمت حاصل کریں۔

پیکیج کے لیے موجودہ قیمت لوٹاتا ہے: price_trx، دستیابی، save_percent اور اقتباس کب تک درست ہے (expires_in_sec)۔

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

TRON انرجی رینٹل آرڈر بنائیں

کرایہ کا آرڈر بناتا ہے۔ آن چین کے لیے، payer_address پاس کریں اور واپس کی گئی رقم_trx کو pay_address پر ادا کریں۔ بیلنس کے لیے، payment_mode: بیلنس شامل کریں اور منسلک اکاؤنٹ سے فوری طور پر چارج کیا جائے گا۔

target_address اختیاری ہے (payer_address پر پہلے سے طے شدہ)۔ 409 اصولوں کو ذہن میں رکھیں: فی ادا کنندہ ایک اوپن آن چین آرڈر، اور کوئی فعال کوئیک رینٹ ڈیلیگیشن پہلے سے ہی ہدف پر نہیں ہے (ACTIVE_DELEGATION_EXISTS)۔

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

آرڈر کی حیثیت حاصل کریں۔

اگر کچھ ناکام ہو جاتا ہے تو موجودہ صورتحال، ادائیگی_موڈ، رقم، پتے، اور error_code / error_message لوٹاتا ہے۔ موثر_توانائی_رقم کم/زیادہ ادائیگی کے بعد اصل تفویض کردہ توانائی کی عکاسی کرتی ہے۔

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

آرڈر منسوخ کریں۔

ایک آرڈر کو منسوخ کرتا ہے جو ابھی تک زیر التواء_ادائیگی ہے (صرف آن چین)۔ ایک بار انرجی ڈیلیٹ ہو جانے کے بعد، آرڈر کو مزید منسوخ نہیں کیا جا سکتا۔

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

ادائیگی کنندہ کو تبدیل کریں۔

پینڈنگ_پیمنٹ آن چین آرڈر کے لیے ادائیگی والے والیٹ کو تبدیل کرتا ہے — مفید ہے اگر گاہک TRX بھیجنے سے پہلے کسی دوسرے بٹوے سے ادائیگی کرنے کا فیصلہ کرے۔

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 API بیلنس چیک کریں۔

آپ کی API کلید سے منسلک TronBid اکاؤنٹ کا TRX بیلنس واپس کرتا ہے (آپ کا درون ایپ بیلنس، آن چین والیٹ نہیں)۔ اجازت کے ہیڈر کی ضرورت ہے۔

{ "balance_trx": "150.500000" }

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

ایرر کوڈز

خرابیاں HTTP کی حیثیت اور غلطی کا فیلڈ لوٹاتی ہیں۔ یہاں وہ ہیں جن کا آپ سامنا کر سکتے ہیں۔

اگر کچھ غلط ہو جائے۔

عام حالات اور کیا کرنا ہے، سادہ الفاظ میں۔

TRON Energy API انٹیگریشن سپورٹ

API تک رسائی، اعلیٰ حدود، یا بیلنس ادائیگی کو فعال کرنے کی ضرورت ہے؟ رابطہ کریں اور ہم مدد کریں گے۔