TRON Energy Rental API — โอน USDT TRC-20 อัตโนมัติ

TRON Energy Rental API: ภาพรวมและกรณีการใช้งาน

Quick Rent 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
}

อภิธานศัพท์

คำอธิบายสั้นๆ ของคำศัพท์ที่ใช้ในเอกสารนี้

ก่อนที่คุณจะเริ่ม

สิ่งที่ต้องเตรียมก่อนทำการร้องขอครั้งแรก

URL ฐาน API การผลิต

Quick Rent 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>

โหมดการชำระเงิน

มีสองวิธีในการชำระเงินสำหรับการสั่งซื้อ On-chain เป็นค่าเริ่มต้นและไม่จำเป็นต้องตั้งค่าใดๆ การชำระยอดคงเหลือเป็นทางเลือกและต้องเปิดใช้งานสำหรับกุญแจของคุณ

หากไม่มีการเปิดใช้งาน คำขอที่มี Payment_mode: ยอดคงเหลือจะส่งคืน 403 BALANCE_PAYMENT_NOT_ENABLED หากต้องการเปิดใช้งาน โปรดติดต่อฝ่ายสนับสนุน TronBid

แคตตาล็อกแพ็คเกจ

Energy_amount และ Duration_ minutes ต้องตรงกับแพ็คเกจ Quick Rent ที่ใช้งานอยู่ — ปกติคือ 65,000 หรือ 131,000 Energy และ 15 หรือ 60 นาที

ดึงข้อมูลแคตตาล็อกปัจจุบันได้ตลอดเวลา (ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์):

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

การไหลแบบออนไลน์

ขั้นตอนที่ 1 — POST /quote เพื่อเรียนรู้ราคา ขั้นตอนที่ 2 — POST /orders เพื่อสร้างคำสั่งซื้อและรับ pay_address, amount_trx และexpirs_at ขั้นตอนที่ 3 — ส่ง amount_trx TRX ไปยัง pay_address จาก payer_address ของคุณ ขั้นตอนที่ 4 — สำรวจความคิดเห็น GET /orders/:id จนกว่าสถานะจะได้รับการมอบหมาย (หรือล้มเหลว / หมดอายุ / ยกเลิก)

target_address เป็นทางเลือก — หากละเว้น พลังงานจะถูกมอบหมายให้กับ payer_address

อนุญาตให้มีคำสั่งซื้อออนไลน์ที่เปิดอยู่เพียงรายการเดียว (pending_Payment) ต่อ payer_address ในแต่ละครั้ง ไม่เช่นนั้นคุณจะได้รับ 409 PENDING_PAYMENT_INTENT_EXISTS พลังงานสุดท้ายอาจแตกต่างกันไป — ตรวจสอบ Effective_energy_amount ใน 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 — 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 เพื่อติดตาม

ความเป็นเอกภาพ

idempotency_key (8–128 ตัวอักษร) เป็นรหัสคำสั่งซื้อที่ไม่ซ้ำกันทางฝั่งของคุณ การทำซ้ำ POST /orders ด้วยคีย์เดียวกัน (สำหรับไคลเอ็นต์ API เดียวกัน) จะส่งคืนลำดับเดียวกันด้วย "duplicate": true

อย่าใช้ idempotency_key หนึ่งรายการซ้ำในโหมดการชำระเงินที่แตกต่างกัน (onchain เทียบกับยอดคงเหลือ) ซึ่งส่งคืน 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH

คำนวณข้อกำหนดการเช่า TRON Energy

ประมาณปริมาณพลังงานที่ที่อยู่ต้องการสำหรับการถ่ายโอน ส่งกระเป๋าเงินของผู้รับและดูว่าถือ 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 Energy

ส่งกลับราคาปัจจุบันของแพ็คเกจ: price_trx, Availability, 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 Energy

สร้างใบสั่งเช่า สำหรับออนไลน์ ให้ส่ง payer_address และชำระเงิน amount_trx ที่ส่งคืนไปยัง pay_address สำหรับยอดคงเหลือ ให้เพิ่ม Payment_mode: balance และบัญชีที่เชื่อมโยงจะถูกเรียกเก็บเงินทันที

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 หากมีบางอย่างล้มเหลว Efficiency_energy_amount สะท้อนถึงพลังงานที่ได้รับมอบหมายจริงหลังจากการชำระเงินน้อยเกินไป/มากเกินไป

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

เปลี่ยนผู้ชำระเงิน

เปลี่ยนกระเป๋าเงินการชำระเงินสำหรับคำสั่งซื้อออนไลน์ pending_Payment — มีประโยชน์หากลูกค้าตัดสินใจชำระเงินจากกระเป๋าเงินอื่นก่อนที่จะส่ง 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..."}'

ตรวจสอบยอดคงเหลือ API ของ TronBid

ส่งคืนยอดคงเหลือ TRX ของบัญชี TronBid ที่เชื่อมโยงกับคีย์ API ของคุณ (ยอดคงเหลือในแอป ไม่ใช่กระเป๋าเงินออนไลน์) ต้องมีส่วนหัวการอนุญาต

{ "balance_trx": "150.500000" }

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

รหัสข้อผิดพลาด

ข้อผิดพลาดส่งคืนสถานะ HTTP และฟิลด์ข้อผิดพลาด นี่คือสิ่งที่คุณอาจพบ

หากมีสิ่งผิดปกติเกิดขึ้น

สถานการณ์ทั่วไปและสิ่งที่ต้องทำด้วยคำพูดธรรมดา

รองรับการรวม TRON Energy API

ต้องการการเข้าถึง API ขีดจำกัดที่สูงขึ้น หรือเปิดใช้งานการชำระยอดคงเหลือหรือไม่ ติดต่อเรามา เราจะช่วยคุณ