ผสานรวม API v2 เพื่อเสนอราคา สร้าง และติดตามคำสั่งซื้อการเช่า TRON Energy โดยทางโปรแกรม ชำระเงินออนไลน์หรือจากยอดคงเหลือ TronBid ของคุณ และลด TRX ที่เกิดจากการโทรสัญญาอัจฉริยะ
Quick Rent API เป็นวิธีการเช่า TRON Energy โดยอัตโนมัติ โดยไม่ต้องอาศัยแรงงานคน พลังงานทำให้การโอน USDT (TRC-20) และการเรียกสัญญาอัจฉริยะอื่น ๆ ถูกกว่าการเผา TRX
พูดง่ายๆ ก็คือ โปรแกรมของคุณ (ไซต์ บอท หรือบริการ) จะซื้อพลังงานเองในเวลาที่จำเป็น — ตัวอย่างเช่น ก่อนที่ลูกค้าของคุณจะโอน USDT แต่ละครั้ง
ลองนึกถึงตู้จำหน่ายสินค้าอัตโนมัติ คุณตรวจสอบราคา ใส่เงิน รับสินค้า API นั้นเป็นชุดปุ่มเดียวกัน — มีเพียงโปรแกรมของคุณเท่านั้นที่กดมัน
โปรแกรมของคุณถาม API ว่าแพ็คเกจพลังงานที่จำเป็นราคาเท่าไหร่ในขณะนี้
โปรแกรมของคุณสร้างคำสั่งซื้อและชำระเงิน — โดยการส่ง TRX ไปยังที่อยู่ที่ระบุหรือโดยการเรียกเก็บเงินจากยอดคงเหลือ TronBid ของคุณ
ภายในไม่กี่วินาที พลังงานจะปรากฏบนกระเป๋าเงินเป้าหมาย และสามารถส่ง USDT ได้ถูกกว่า
สำคัญ: API เป็นเครื่องมือสำหรับนักพัฒนา หากต้องการใช้งาน ต้องมีบางคนเขียนโค้ดที่ส่งคำขอ
หากไม่มีคนเขียนโค้ด — ใช้การซื้อพลังงานสำเร็จรูปบนเว็บไซต์ (เช่าด่วน) หรือบอท Telegram @tronbid ผลลัพธ์เดียวกัน เพียงทำด้วยตนเอง
ตัวอย่างตั้งแต่ต้นจนจบในสถานการณ์ที่ง่ายที่สุด (ออนไลน์) สี่ขั้นตอนและพลังงานอยู่ในกระเป๋าเงิน
ด้านล่างนี้คือสิ่งที่เกิดขึ้นในแต่ละขั้นตอนและสิ่งที่ API ส่งคืน เสียบคีย์ API ที่อยู่ และรหัสคำสั่งซื้อของคุณ
ส่งปริมาณพลังงานและระยะเวลา คุณได้รับ price_trx คืนและจำนวนวินาทีที่ราคาถูกล็อค
ผู้รับทรัพยากร: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
ชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน ส่งจำนวนเงินที่ตรงตามที่ระบุไปยังที่อยู่ชำระเงินในคำสั่งซื้อนี้ก่อนหมดอายุ อย่าใช้ที่อยู่ชำระเงินของคำสั่งซื้อก่อนหน้าซ้ำ (amount_trx TRX → pay_address; expires_at)
สำรวจสถานะทุกๆ สองสามวินาทีจนกว่าจะได้รับมอบหมาย นั่นหมายความว่าพลังงานถูกมอบหมายให้กับกระเป๋าเงิน — เสร็จแล้ว
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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 บน Telegram — คุณจะได้รับรหัสที่เชื่อมโยงกับบัญชี TronBid ของคุณ คำขอจะไม่ผ่านหากไม่มีมัน
ตัดสินใจเลือกที่อยู่ (target_address) ที่ต้องการพลังงาน โดยปกติแล้วจะเป็นกระเป๋าเงินที่ลูกค้าของคุณส่ง USDT มา
พลังงานขายเป็นแพ็คเกจ (ปกติ 65,000 หรือ 131,000 พลังงานเป็นเวลา 15 หรือ 60 นาที) รับรายการสดจากจุดสิ้นสุดแค็ตตาล็อก ไม่จำเป็นต้องตรวจสอบสิทธิ์
สำหรับออนไลน์ — กระเป๋าเงินที่มี TRX ที่จะจ่าย สำหรับการชำระยอดคงเหลือ — บัญชี TronBid ที่ได้รับทุนและเปิดใช้งานโหมดยอดคงเหลือ
Quick Rent API ช่วยให้บริการของคุณเช่า TRON Energy โดยอัตโนมัติ ดังนั้นการโอน USDT TRC-20 และการโทรผ่านสัญญาอัจฉริยะอื่นๆ จึงมีค่าใช้จ่ายน้อยกว่าการเบิร์น TRX
จุดสิ้นสุดทั้งหมดแชร์ URL ฐานเดียว
https://tronbid.com/api/v2/quick-rentมีสองวิธีในการชำระเงินสำหรับการสั่งซื้อ On-chain เป็นค่าเริ่มต้นและไม่จำเป็นต้องตั้งค่าใดๆ การชำระยอดคงเหลือเป็นทางเลือกและต้องเปิดใช้งานสำหรับกุญแจของคุณ
หากไม่มีการเปิดใช้งาน คำขอที่มี Payment_mode: ยอดคงเหลือจะส่งคืน 403 BALANCE_PAYMENT_NOT_ENABLED หากต้องการเปิดใช้งาน โปรดติดต่อฝ่ายสนับสนุน TronBid
| Mode | วิธีการเปิดใช้งาน | การชำระเงิน |
|---|---|---|
on-chain | ค่าเริ่มต้น — ละเว้น Payment_mode (หรือ "onchain") | ชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน amount_trx TRX → pay_address |
balance | Payment_mode: ยอดคงเหลือ + เปิดใช้งานสำหรับคีย์ของคุณ | หักจากยอดคงเหลือ TronBid TRX ของคุณ |
Energy_amount และ Duration_ minutes ต้องตรงกับแพ็คเกจ Quick Rent ที่ใช้งานอยู่ — ปกติคือ 65,000 หรือ 131,000 Energy และ 15 หรือ 60 นาที
ดึงข้อมูลแคตตาล็อกปัจจุบันได้ตลอดเวลา (ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์):
curl -sS https://tronbid.com/api/public/quick-rent/skusชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. ส่งจำนวนเงินที่ตรงตามที่ระบุไปยังที่อยู่ชำระเงินในคำสั่งซื้อนี้ก่อนหมดอายุ อย่าใช้ที่อยู่ชำระเงินของคำสั่งซื้อก่อนหน้าซ้ำ
ชื่อเรียกเดิมของ target_address ซึ่งไม่จำเป็นต้องส่ง และไม่จำกัดกระเป๋าที่ใช้ชำระเงิน
ส่งจำนวนเงินที่ตรงตามที่ระบุไปยังที่อยู่ชำระเงินในคำสั่งซื้อนี้ก่อนหมดอายุ อย่าใช้ที่อยู่ชำระเงินของคำสั่งซื้อก่อนหน้าซ้ำ
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payment_mode": "onchain",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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 — GET /balance เพื่อตรวจสอบ TRX ของคุณ ขั้นตอนที่ 2 — POST /quote สำหรับราคา ขั้นตอนที่ 3 — POST / คำสั่งซื้อด้วย Payment_mode: ยอดคงเหลือในการเดบิตและเริ่มการมอบหมาย ขั้นตอนที่ 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 | ยกเลิกก่อนชำระเงิน (on-chain) |
expired | หน้าต่างการชำระเงินออนไลน์ผ่านไปแล้ว |
failed | ข้อผิดพลาด (สำหรับยอดคงเหลือ TRX จะได้รับคืน) |
idempotency_key (8–128 ตัวอักษร) เป็นรหัสคำสั่งซื้อที่ไม่ซ้ำกันทางฝั่งของคุณ การทำซ้ำ POST /orders ด้วยคีย์เดียวกัน (สำหรับไคลเอ็นต์ API เดียวกัน) จะส่งคืนลำดับเดียวกันด้วย "duplicate": true
อย่าใช้ idempotency_key หนึ่งรายการซ้ำในโหมดการชำระเงินที่แตกต่างกัน (onchain เทียบกับยอดคงเหลือ) ซึ่งส่งคืน 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH
ประมาณปริมาณพลังงานที่ที่อยู่ต้องการสำหรับการถ่ายโอน ส่งกระเป๋าเงินของผู้รับและดูว่าถือ USDT อยู่แล้วหรือไม่
/api/v2/quick-rent/calculator| พารามิเตอร์ | Type | คำอธิบาย | Example |
|---|---|---|---|
wallet_address | string | ที่อยู่ TRON ที่จะวิเคราะห์ | TXXXXXXXX...XXXX |
มี_usdt | boolean | null | ผู้รับถือ USDT อยู่แล้วหรือไม่ (ส่งผลต่อพลังงาน) จริง เท็จ หรือละเว้น | 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, Availability, save_percent และระยะเวลาที่ใบเสนอราคาใช้ได้ (expires_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}'ชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
ส่งจำนวนเงินที่ตรงตามที่ระบุไปยังที่อยู่ชำระเงินในคำสั่งซื้อนี้ก่อนหมดอายุ อย่าใช้ที่อยู่ชำระเงินของคำสั่งซื้อก่อนหน้าซ้ำ
/api/v2/quick-rent/orders| พารามิเตอร์ | Type | คำอธิบาย | Example |
|---|---|---|---|
energy_amount | int | ปริมาณพลังงานจากแค็ตตาล็อก | 131000 |
duration_minutes | int | ระยะเวลาการเช่าจากแค็ตตาล็อก | 15 |
idempotency_key | string | รหัสคำสั่งซื้อเฉพาะของคุณ (8–128 ตัวอักษร) | partner-onchain-001 |
payment_mode | string | ไม่จำเป็น "onchain" (ค่าเริ่มต้น) หรือ "สมดุล" | balance |
payer_address | string | ชื่อเรียกเดิมของ target_address ซึ่งไม่จำเป็นต้องส่ง และไม่จำกัดกระเป๋าที่ใช้ชำระเงิน | TTarget... |
target_address | string | ผู้รับทรัพยากร. ชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน | TTarget... |
{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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",
"payment_mode": "onchain",
"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 หากมีบางอย่างล้มเหลว Efficiency_energy_amount สะท้อนถึงพลังงานที่ได้รับมอบหมายจริงหลังจากการชำระเงินน้อยเกินไป/มากเกินไป
/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"ส่งคืนยอดคงเหลือ TRX ของบัญชี TronBid ที่เชื่อมโยงกับคีย์ API ของคุณ (ยอดคงเหลือในแอป ไม่ใช่กระเป๋าเงินออนไลน์) ต้องมีส่วนหัวการอนุญาต
/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 | ผู้รับทรัพยากร: pending_payment |
| 409 | ACTIVE_DELEGATION_EXISTS | เป้าหมายมีการมอบหมายการเช่าด่วนที่ใช้งานอยู่อยู่แล้ว |
| 409 | POOL_ENERGY_INSUFFICIENT | ไม่มีพลังงานสระว่ายน้ำฟรีในขณะนี้ |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | idempotency_key เดียวกันกับ Payment_mode ที่แตกต่างกัน |
| 429 | Too Many Requests | ขีดจำกัดอัตรา |
| 503 | — | บริการไม่พร้อมใช้งานชั่วคราว โปรดลองอีกครั้งในภายหลัง |
สถานการณ์ทั่วไปและสิ่งที่ต้องทำด้วยคำพูดธรรมดา
ส่งจำนวนเงินที่ตรงตามที่ระบุไปยังที่อยู่ชำระเงินในคำสั่งซื้อนี้ก่อนหมดอายุ อย่าใช้ที่อยู่ชำระเงินของคำสั่งซื้อก่อนหน้าซ้ำ ชำระ TRX จากกระเป๋าใดก็ได้ Energy หรือ Bandwidth จะถูกมอบหมายให้ผู้รับที่ระบุในคำสั่งซื้อ ไม่จำเป็นต้องเลือกกระเป๋าชำระเงิน GET /orders/:id → status
การมอบหมายไม่สำเร็จ สำหรับการชำระยอดคงเหลือ TRX จะถูกส่งคืนไปยังยอดคงเหลือของคุณโดยอัตโนมัติ สาเหตุอยู่ใน error_code และ error_message ของ GET /orders/:id คุณสามารถสร้างคำสั่งซื้อใหม่ได้
ผู้รับทรัพยากร: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
ไม่ได้เปิดใช้งานการชำระยอดคงเหลือสำหรับกุญแจของคุณ ติดต่อฝ่ายสนับสนุน TronBid เพื่อเปิดใช้งาน หรือใช้ออนไลน์ (ค่าเริ่มต้น)
คำขอมากเกินไปในเวลาอันสั้น ลดความถี่ในการโพล (เช่น ทุกๆ 3 วินาที) แล้วลองอีกครั้งในภายหลัง
หากชำระเงินน้อยเกินไป/ชำระเงินเกินออนไลน์ จำนวนเงินสุดท้ายจะเปลี่ยนแปลง ตรวจสอบ Efficiency_energy_amount ใน GET /orders/:id ซึ่งเป็นพลังงานที่ได้รับมอบหมายจริง ๆ
ต้องการการเข้าถึง API ขีดจำกัดที่สูงขึ้น หรือเปิดใช้งานการชำระยอดคงเหลือหรือไม่ ติดต่อเรามา เราจะช่วยคุณ