שלב API v2 כדי לצטט, ליצור ולעקוב אחר הזמנות השכרה של TRON Energy באופן פרוגרמטי. שלם על השרשרת או מיתרת ה-TronBid שלך והפחת את ה-TRX שנשרף על ידי שיחות חוזים חכמים.
ה-Quick Rent API הוא דרך לשכור את TRON Energy באופן אוטומטי, ללא עבודה ידנית. אנרגיה הופכת העברות USDT (TRC-20) ושיחות חוזים חכמים אחרים לזולים יותר מאשר שריפת TRX.
במילים פשוטות: התוכנית שלך (אתר, בוט או שירות) קונה אנרגיה בעצמה, בדיוק מתי שהיא נחוצה - למשל, לפני כל העברה של USDT שהלקוח שלך מבצע.
תחשוב על מכונה אוטומטית: אתה בודק את המחיר, מכניס כסף, מקבל את הפריט שלך. ה-API הוא אותה קבוצה של לחצנים - רק התוכנית שלך לוחצת עליהם.
התוכנית שלך שואלת את ה-API כמה עולה חבילת האנרגיה הדרושה כרגע.
התוכנית שלך יוצרת הזמנה ומשלמת אותה - על ידי שליחת TRX לכתובת הנתונה או על ידי חיוב יתרת TronBid שלך.
תוך מספר שניות אנרגיה מופיעה על ארנק היעד, וניתן לשלוח USDT בזול יותר.
חשוב: ה-API הוא כלי למפתח. כדי להשתמש בו, מישהו צריך לכתוב קוד ששולח את הבקשות.
אם אין מי שיכתוב קוד - השתמש ברכישת האנרגיה המוכנה באתר (Quick Rent) או בבוט 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 בטלגרם - תקבל מפתח קשור לחשבון TronBid שלך. בקשות לא יעברו בלעדיו.
החלט את הכתובת (כתובת_יעד) שצריכה אנרגיה. בדרך כלל זה הארנק שממנו הלקוחות שלך שולחים USDT.
אנרגיה נמכרת באריזות (בדרך כלל 65000 או 131000 אנרגיה למשך 15 או 60 דקות). קבל את הרשימה החיה מנקודת הקצה של הקטלוג, אין צורך באישור.
לרשת - ארנק עם TRX לתשלום. לתשלום יתרה - חשבון TronBid ממומן ומצב היתרה מופעל.
ה-Quick Rent API מאפשר לשירות שלך לשכור את TRON Energy באופן אוטומטי, כך שהעברות USDT TRC-20 ושיחות חוזים חכמים אחרים עולים פחות משריפת TRX.
כל נקודות הקצה חולקות כתובת אתר בסיס אחת.
https://tronbid.com/api/v2/quick-rentישנן שתי דרכים לשלם עבור הזמנה. On-chain הוא ברירת המחדל ואינו זקוק להגדרה. תשלום היתרה הוא אופציונלי וחייב להיות מופעל עבור המפתח שלך.
ללא הפעלה, בקשה עם תשלום_מצב: יתרה מחזירה 403 BALANCE_PAYMENT_NOT_ENABLED. כדי להפעיל אותו, פנה לתמיכה של TronBid.
| Mode | כיצד להפעיל | תשלום |
|---|---|---|
on-chain | ברירת מחדל - השמט תשלום_mode (או "onchain") | אפשר לשלם TRX מכל ארנק. Energy או Bandwidth יועברו לנמען שצוין בהזמנה. אין צורך לבחור ארנק לתשלום. amount_trx TRX → pay_address |
balance | תשלום_מצב: יתרה + מופעלת עבור המפתח שלך | חויב מיתרת ה-TronBid TRX שלך |
energy_amount ו-duration_minutes חייבים להתאים לחבילת השכרה מהירה פעילה - בדרך כלל 65000 או 131000 אנרגיה ו-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 - קבל / איזון כדי לבדוק את ה-TRX שלך. שלב 2 - פרסם/הצעת מחיר עבור המחיר. שלב 3 - POST / הזמנות עם תשלום_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 | בוטל לפני התשלום (בשרשרת) |
expired | חלף חלון התשלום בשרשרת |
failed | שגיאה (עבור יתרה, TRX מוחזר) |
idempotency_key (8–128 תווים) הוא מזהה הזמנה ייחודי בצד שלך. חזרה על POST /הזמנות עם אותו מפתח (עבור אותו לקוח API) מחזירה את אותה הזמנה עם "כפול": true.
אין לעשות שימוש חוזר ב-idempotency_key אחד על פני מצבי תשלום שונים (onchain לעומת יתרה) - זה מחזיר 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
הערך כמה אנרגיה צריכה כתובת לצורך העברה. העבר את ארנק הנמען והאם הוא כבר מחזיק USDT.
/api/v2/quick-rent/calculator| פרמטר | Type | תיאור | Example |
|---|---|---|---|
ארנק_כתובת | string | כתובת TRON לניתוח | TXXXXXXXX...XXXX |
has_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, זמינות, save_percent וכמה זמן הצעת המחיר בתוקף (expires_in_sec).
/api/v2/quick-rent/quote| פרמטר | Type | תיאור | Example |
|---|---|---|---|
כמות_אנרגיה | int | כמות אנרגיה מהקטלוג הפעיל | 131000 |
duration_minutes | 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 אם משהו נכשל. כמות_יעילות_אנרגיה משקפת את האנרגיה המואצלת בפועל לאחר תשלום-יתר.
/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 | ל-Target כבר יש משלחת Quick Rent פעילה |
| 409 | POOL_ENERGY_INSUFFICIENT | אין אנרגיה פנויה לבריכה כרגע |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | אותו מפתח idempotency עם אמצעי תשלום אחר |
| 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 שניות) ונסה שוב מאוחר יותר.
עם תשלום חסר/תשלום יתר ברשת הסכום הסופי משתנה. בדוק יעיל_אנרגיה_כמות ב-GET /orders/:id — זו האנרגיה שהוקצתה בפועל.
זקוק לגישה ל-API, להגבלות גבוהות יותר או לאפשר תשלום יתרה? פנה ונעזור.