Ενσωματώστε το API v2 για προσφορά, δημιουργία και παρακολούθηση παραγγελιών ενοικίασης TRON Energy μέσω προγραμματισμού. Πληρώστε on-chain ή από το υπόλοιπό σας TronBid και μειώστε το TRX που καίγεται από κλήσεις έξυπνου συμβολαίου.
Το Quick Rent API είναι ένας τρόπος αυτόματης ενοικίασης TRON Energy, χωρίς χειρωνακτική εργασία. Η ενέργεια κάνει τις μεταφορές USDT (TRC-20) και άλλες κλήσεις έξυπνων συμβολαίων φθηνότερες από την καύση TRX.
Με απλά λόγια: το πρόγραμμά σας (ένας ιστότοπος, ένα bot ή μια υπηρεσία) αγοράζει ενέργεια από μόνο του, ακριβώς όταν χρειάζεται — για παράδειγμα, πριν από κάθε μεταφορά USDT που πραγματοποιεί ο πελάτης σας.
Σκεφτείτε ένα μηχάνημα αυτόματης πώλησης: ελέγχετε την τιμή, εισάγετε χρήματα, παίρνετε το προϊόν σας. Το API είναι το ίδιο σύνολο κουμπιών — μόνο το πρόγραμμά σας τα πατάει.
Το πρόγραμμά σας ρωτά το API πόσο κοστίζει αυτή τη στιγμή το απαραίτητο πακέτο ενέργειας.
Το πρόγραμμά σας δημιουργεί μια παραγγελία και την πληρώνει — στέλνοντας TRX στη δεδομένη διεύθυνση ή χρεώνοντας το υπόλοιπό σας TronBid.
Μέσα σε λίγα δευτερόλεπτα εμφανίζεται ενέργεια στο πορτοφόλι-στόχο και το USDT μπορεί να σταλεί φθηνότερα.
Σημαντικό: το API είναι ένα εργαλείο για έναν προγραμματιστή. Για να το χρησιμοποιήσει κάποιος πρέπει να γράψει κώδικα που στέλνει τα αιτήματα.
Εάν δεν υπάρχει κανείς να γράψει κώδικα — χρησιμοποιήστε την έτοιμη αγορά ενέργειας στον ιστότοπο (Quick Rent) ή το ρομπότ Telegram @tronbid. Το ίδιο αποτέλεσμα, μόνο χειροκίνητα.
Ένα πλήρες παράδειγμα από άκρη σε άκρη για το απλούστερο σενάριο (on-chain). Τέσσερα βήματα και η ενέργεια είναι στο πορτοφόλι.
Παρακάτω είναι τι συμβαίνει σε κάθε βήμα και τι επιστρέφει το 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 οι πελάτες σας.
Η ενέργεια πωλείται σε συσκευασίες (συνήθως 65000 ή 131000 ενέργεια για 15 ή 60 λεπτά). Λάβετε τη ζωντανή λίστα από το τελικό σημείο του καταλόγου, δεν χρειάζεται εξουσιοδότηση.
Για on-chain — ένα πορτοφόλι με TRX για πληρωμή. Για πληρωμή υπολοίπου — ένας χρηματοδοτούμενος λογαριασμός TronBid και ενεργοποιημένη η λειτουργία υπολοίπου.
Το Quick Rent API επιτρέπει στην υπηρεσία σας να νοικιάζει αυτόματα το TRON Energy, έτσι οι μεταφορές USDT TRC-20 και άλλες κλήσεις έξυπνων συμβολαίων κοστίζουν λιγότερο από την εγγραφή TRX.
Όλα τα τελικά σημεία μοιράζονται ένα βασικό URL.
https://tronbid.com/api/v2/quick-rentΥπάρχουν δύο τρόποι πληρωμής για μια παραγγελία. Το On-chain είναι η προεπιλογή και δεν χρειάζεται ρύθμιση. Η πληρωμή υπολοίπου είναι προαιρετική και πρέπει να ενεργοποιηθεί για το κλειδί σας.
Χωρίς ενεργοποίηση, ένα αίτημα με λειτουργία πληρωμής: το υπόλοιπο επιστρέφει 403 BALANCE_PAYMENT_NOT_ENABLED. Για να το ενεργοποιήσετε, επικοινωνήστε με την υποστήριξη TronBid.
| Mode | Πώς να ενεργοποιήσετε | Πληρωμή |
|---|---|---|
on-chain | Προεπιλογή — παράλειψη τρόπου πληρωμής (ή "onchain") | Πληρώστε TRX από οποιοδήποτε πορτοφόλι. Το Energy ή το Bandwidth θα σταλεί στον παραλήπτη που ορίζεται στην παραγγελία. Δεν χρειάζεται επιλογή πορτοφολιού πληρωμής. amount_trx TRX → pay_address |
balance | τρόπος πληρωμής: υπόλοιπο + ενεργοποιημένο για το κλειδί σας | Χρεώθηκε από το υπόλοιπό σας TronBid TRX |
Η ποσότητα ενέργειας_και η διάρκεια_λεπτά πρέπει να αντιστοιχούν σε ένα ενεργό πακέτο Γρήγορης ενοικίασης — συνήθως 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 — ΠΑΡΕΤΕ /balance για να ελέγξετε το TRX σας. Βήμα 2 — POST /προσφορά για την τιμή. Βήμα 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 | Ακυρώθηκε πριν από την πληρωμή (on-chain) |
expired | Το παράθυρο πληρωμής στην αλυσίδα έχει παρέλθει |
failed | Σφάλμα (για το υπόλοιπο, το TRX επιστρέφεται) |
Το κλειδί idempotency (8–128 χαρακτήρες) είναι ένα μοναδικό αναγνωριστικό παραγγελίας από την πλευρά σας. Η επανάληψη POST /παραγγελιών με το ίδιο κλειδί (για τον ίδιο πελάτη API) επιστρέφει την ίδια σειρά με "διπλό": true.
Μην επαναχρησιμοποιείτε ένα κλειδί idempotency σε διαφορετικούς τρόπους πληρωμής (onchain vs υπόλοιπο) — αυτό επιστρέφει 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 και πόσο καιρό ισχύει η προσφορά (λήγει_σε_δευτ.).
/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". | 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 εάν κάτι απέτυχε. Το effect_energy_amount αντικατοπτρίζει την πραγματική ενέργεια που έχει εκχωρηθεί μετά από μειωμένη/υπερπληρωμή.
/api/v2/quick-rent/orders/:id| Παράμετρος | Type | Περιγραφή | Example |
|---|---|---|---|
id | 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"Ακυρώνει μια παραγγελία που είναι ακόμα σε εκκρεμότητα_payment (μόνο στην αλυσίδα). Μετά την ανάθεση ενέργειας, η παραγγελία δεν μπορεί πλέον να ακυρωθεί.
/api/v2/quick-rent/orders/:id/cancel| Παράμετρος | Type | Περιγραφή | Example |
|---|---|---|---|
id | 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 για να το ενεργοποιήσετε ή χρησιμοποιήστε το on-chain (η προεπιλογή).
Πάρα πολλά αιτήματα σε σύντομο χρονικό διάστημα. Μειώστε τη συχνότητα ψηφοφορίας (π.χ. μία φορά κάθε 3 δευτερόλεπτα) και δοκιμάστε ξανά αργότερα.
Με την υστέρηση/υπερπληρωμή στην αλυσίδα το τελικό ποσό αλλάζει. Ελέγξτε το effect_energy_amount στο GET /orders/:id — αυτή είναι η ενέργεια που εκχωρείται πραγματικά.
Χρειάζεστε πρόσβαση στο API, υψηλότερα όρια ή ενεργοποιημένη πληρωμή υπολοίπου; Απευθυνθείτε και θα βοηθήσουμε.