REST API v2Η τεκμηρίωση ενημερώθηκε στις 2 Αυγούστου 2026

TRON Energy Rental API — Αυτοματοποιήστε τις μεταφορές USDT TRC-20

Ενσωματώστε το API v2 για προσφορά, δημιουργία και παρακολούθηση παραγγελιών ενοικίασης TRON Energy μέσω προγραμματισμού. Πληρώστε on-chain ή από το υπόλοιπό σας TronBid και μειώστε το TRX που καίγεται από κλήσεις έξυπνου συμβολαίου.

Ζωντανές προσφορές και κατάλογος πακέτων
Πληρωμή στην αλυσίδα ή στο υπόλοιπο
Ανίκανες εντολές και δημοσκόπηση κατάστασης

Αποκτήστε πρόσβαση στο API Ανοίξτε τη Γρήγορη εκκίνηση Ενοικίαση ενέργειας χωρίς API Υπολογίστε τις ενεργειακές απαιτήσεις

Σε αυτή τη σελίδα

TRON Energy Rental API: επισκόπηση και περιπτώσεις χρήσης

Το Quick Rent API είναι ένας τρόπος αυτόματης ενοικίασης TRON Energy, χωρίς χειρωνακτική εργασία. Η ενέργεια κάνει τις μεταφορές USDT (TRC-20) και άλλες κλήσεις έξυπνων συμβολαίων φθηνότερες από την καύση TRX.

Με απλά λόγια: το πρόγραμμά σας (ένας ιστότοπος, ένα bot ή μια υπηρεσία) αγοράζει ενέργεια από μόνο του, ακριβώς όταν χρειάζεται — για παράδειγμα, πριν από κάθε μεταφορά USDT που πραγματοποιεί ο πελάτης σας.

Σκεφτείτε ένα μηχάνημα αυτόματης πώλησης: ελέγχετε την τιμή, εισάγετε χρήματα, παίρνετε το προϊόν σας. Το API είναι το ίδιο σύνολο κουμπιών — μόνο το πρόγραμμά σας τα πατάει.

1
Ρωτήστε για μια τιμή
Το πρόγραμμά σας ρωτά το API πόσο κοστίζει αυτή τη στιγμή το απαραίτητο πακέτο ενέργειας.
2
Δημιουργήστε μια παραγγελία και πληρώστε
Το πρόγραμμά σας δημιουργεί μια παραγγελία και την πληρώνει — στέλνοντας TRX στη δεδομένη διεύθυνση ή χρεώνοντας το υπόλοιπό σας TronBid.
3
Πάρτε την ενέργεια
Μέσα σε λίγα δευτερόλεπτα εμφανίζεται ενέργεια στο πορτοφόλι-στόχο και το USDT μπορεί να σταλεί φθηνότερα.

Σημαντικό: το API είναι ένα εργαλείο για έναν προγραμματιστή. Για να το χρησιμοποιήσει κάποιος πρέπει να γράψει κώδικα που στέλνει τα αιτήματα.

Εάν δεν υπάρχει κανείς να γράψει κώδικα — χρησιμοποιήστε την έτοιμη αγορά ενέργειας στον ιστότοπο (Quick Rent) ή το ρομπότ Telegram @tronbid. Το ίδιο αποτέλεσμα, μόνο χειροκίνητα.

Γρήγορη εκκίνηση: από το μηδέν στην ενέργεια

Ένα πλήρες παράδειγμα από άκρη σε άκρη για το απλούστερο σενάριο (on-chain). Τέσσερα βήματα και η ενέργεια είναι στο πορτοφόλι.

Παρακάτω είναι τι συμβαίνει σε κάθε βήμα και τι επιστρέφει το API. Συνδέστε το κλειδί API, τις διευθύνσεις και το αναγνωριστικό παραγγελίας.

1
Βήμα 1. Λάβετε μια τιμή — ΑΝΑΡΤΗΣΗ /προσφορά
Στείλτε την ποσότητα και τη διάρκεια ενέργειας. Παίρνετε πίσω το price_trx και για πόσα δευτερόλεπτα είναι κλειδωμένο.
2
Βήμα 2. Δημιουργήστε μια παραγγελία — ΑΝΑΡΤΗΣΗ /παραγγελίες
Στείλτε το πακέτο, idempotency_key και payer_address. Παίρνετε pay_address (πού να πληρώσετε), ποσό_trx (πόσο) και expires_at (μέχρι πότε).
3
Βήμα 3. Πληρώστε
Στείλτε ακριβώς ποσό_trx TRX στη διεύθυνση pay_address από την payer_address σας. Είναι μια απλή μεταφορά TRON.
4
Βήμα 4. Περιμένετε για ενέργεια — GET /orders/:id
Δημοσκόπηση της κατάστασης κάθε δύο δευτερόλεπτα μέχρι να γίνει ανάθεση. Αυτό σημαίνει ότι η ενέργεια μεταβιβάζεται στο πορτοφόλι — έγινε.

Απάντηση

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

Απόκριση (on-chain)

json

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

ΚΟΥΡΛ

bash

# 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

Απάντηση

json

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

Γλωσσάρι

Σύντομες επεξηγήσεις των λέξεων που χρησιμοποιούνται σε αυτήν την τεκμηρίωση.

Ενέργεια: Το «καύσιμο» του δικτύου TRON για λειτουργίες smart-contract. Αν δεν υπάρχει αρκετό, το δίκτυο καίει TRX αντ' αυτού — το οποίο είναι πιο ακριβό. Η ενοικίαση ενέργειας εξοικονομεί χρήματα.
TRX: Το εγγενές νόμισμα του δικτύου TRON. Πληρώνει για την ενοικίαση ενέργειας και τα τέλη δικτύου.
USDT TRC-20: Ένα stablecoin (δολάριο) στο TRON. Η αποστολή της είναι μια κλήση έξυπνου συμβολαίου που χρειάζεται ενέργεια.
Κλειδί API: Ο μυστικός κωδικός πρόσβασης για πρόσβαση στο API. Αποστέλλεται με κάθε αίτημα. Διατηρήστε το μόνο στον διακομιστή.
Τελικό σημείο: Μια συγκεκριμένη διεύθυνση-"κουμπί" του API όπου το πρόγραμμά σας στέλνει ένα αίτημα (π.χ. /quote — λάβετε μια τιμή).
ΛΗΨΗ / ΑΝΑΡΤΗΣΗ: Τύποι αιτημάτων. GET σημαίνει "απλώς ρωτήστε / διαβάστε δεδομένα"? POST σημαίνει "κάνω μια ενέργεια" (δημιουργία παραγγελίας, υπολογισμό τιμής).
Κουπόνι φορέα: Πώς μεταβιβάζετε το κλειδί API: η κεφαλίδα γράφει Εξουσιοδότηση: Φορέας YOUR_KEY.
Πληρωμή μέσω αλυσίδας: Η πληρωμή μιας παραγγελίας με απλή μεταφορά TRX στη δεδομένη διεύθυνση — λειτουργεί αμέσως, δεν μπορεί να ενεργοποιηθεί τίποτα.
Πληρωμή υπολοίπου: Πληρωμή με χρέωση του υπολοίπου του λογαριασμού σας TronBid. Ταχύτερη, αλλά πρέπει πρώτα να ενεργοποιηθεί για το κλειδί σας.
Αντιπροσωπεία: Προσωρινή παράδοση της ενοικιασμένης ενέργειας στο πορτοφόλι-στόχο για την περίοδο ενοικίασης (π.χ. 15 ή 60 λεπτά).
Δημοσκόπηση: Ξαναρωτάμε την κατάσταση της παραγγελίας περιοδικά (κάθε δύο δευτερόλεπτα) μέχρι να γίνει ανάθεση ή να τελειώσει με σφάλμα.
idempotency_key: Το μοναδικό αναγνωριστικό παραγγελίας σας. Εάν ένα αίτημα αποσταλεί δύο φορές, το API επιστρέφει την ίδια παραγγελία αντί να δημιουργήσει μια νέα — προστασία από διπλή πληρωμή.

Πριν ξεκινήσετε

Τι να προετοιμάσετε πριν κάνετε το πρώτο σας αίτημα.

1
Λάβετε ένα κλειδί API
Στείλτε μήνυμα @tronbid στο Telegram — θα λάβετε ένα κλειδί συνδεδεμένο στον λογαριασμό σας TronBid. Τα αιτήματα δεν θα περάσουν χωρίς αυτό.
2
Έχετε ένα πορτοφόλι στόχο TRON
Αποφασίστε τη διεύθυνση (target_address) που χρειάζεται ενέργεια. Συνήθως είναι το πορτοφόλι από το οποίο στέλνουν USDT οι πελάτες σας.
3
Επιλέξτε ένα πακέτο από τον κατάλογο
Η ενέργεια πωλείται σε συσκευασίες (συνήθως 65000 ή 131000 ενέργεια για 15 ή 60 λεπτά). Λάβετε τη ζωντανή λίστα από το τελικό σημείο του καταλόγου, δεν χρειάζεται εξουσιοδότηση.
4
Προετοιμασία πληρωμής
Για on-chain — ένα πορτοφόλι με TRX για πληρωμή. Για πληρωμή υπολοίπου — ένας χρηματοδοτούμενος λογαριασμός TronBid και ενεργοποιημένη η λειτουργία υπολοίπου.

URL βάσης API παραγωγής

Το Quick Rent API επιτρέπει στην υπηρεσία σας να νοικιάζει αυτόματα το TRON Energy, έτσι οι μεταφορές USDT TRC-20 και άλλες κλήσεις έξυπνων συμβολαίων κοστίζουν λιγότερο από την εγγραφή TRX.

Όλα τα τελικά σημεία μοιράζονται ένα βασικό URL.

URL βάσης (παραγωγή)

http

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

Εξουσιοδότηση

Κάθε αίτημα πρέπει να περιλαμβάνει το κλειδί API σας ως διακριτικό φορέα στην κεφαλίδα Εξουσιοδότηση.

Διατηρήστε το κλειδί μόνο από την πλευρά του διακομιστή (backend, μυστικά CI). Ποτέ μην το στέλνετε σε κώδικα frontend ή σε δημόσια αποθετήρια. Το κλειδί είναι συνδεδεμένο σε έναν μόνο λογαριασμό TronBid (το πορτοφόλι που ορίστηκε όταν παραχωρήθηκε η πρόσβαση). Οι πληρωμές υπολοίπου μπορούν να αντληθούν μόνο από αυτόν τον λογαριασμό.

Εάν υπερβείτε το όριο ρυθμού, το API αποκρίνεται με HTTP 429.

http

Authorization: Bearer <API_KEY>

Τρόποι πληρωμής

Υπάρχουν δύο τρόποι πληρωμής για μια παραγγελία. Το On-chain είναι η προεπιλογή και δεν χρειάζεται ρύθμιση. Η πληρωμή υπολοίπου είναι προαιρετική και πρέπει να ενεργοποιηθεί για το κλειδί σας.

Χωρίς ενεργοποίηση, ένα αίτημα με λειτουργία πληρωμής: το υπόλοιπο επιστρέφει 403 BALANCE_PAYMENT_NOT_ENABLED. Για να το ενεργοποιήσετε, επικοινωνήστε με την υποστήριξη TronBid.

Mode	Πώς να ενεργοποιήσετε	Πληρωμή
`on-chain`	Προεπιλογή — παράλειψη τρόπου πληρωμής (ή "onchain")	Στείλτε TRX στη διεύθυνση pay_address από payer_address
`balance`	τρόπος πληρωμής: υπόλοιπο + ενεργοποιημένο για το κλειδί σας	Χρεώθηκε από το υπόλοιπό σας TronBid TRX

Κατάλογος πακέτων

Η ποσότητα ενέργειας_και η διάρκεια_λεπτά πρέπει να αντιστοιχούν σε ένα ενεργό πακέτο Γρήγορης ενοικίασης — συνήθως 65000 ή 131000 ενέργειας και 15 ή 60 λεπτά.

Λάβετε τον τρέχοντα κατάλογο ανά πάσα στιγμή (δεν απαιτείται εξουσιοδότηση):

Λήψη του ενεργού καταλόγου (χωρίς εξουσιοδότηση)

bash

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

Ροή επί της αλυσίδας

Βήμα 1 — ΑΝΑΡΤΗΣΗ /προσφορά για να μάθετε την τιμή. Βήμα 2 — ΑΝΑΡΤΗΣΗ /παραγγελίες για να δημιουργήσετε την παραγγελία και να λάβετε pay_address, ποσό_trx και expires_at. Βήμα 3 — στείλτε ακριβώς ποσό_trx TRX στη διεύθυνση pay_address από την payer_address σας. Βήμα 4 — δημοσκόπηση GET /orders/:id μέχρι να εκχωρηθεί η κατάσταση (ή απέτυχε / έληξε / ακυρώθηκε).

Η target_address είναι προαιρετική — εάν παραλειφθεί, η ενέργεια εκχωρείται στη payer_address.

Επιτρέπεται μόνο μία ανοιχτή παραγγελία στην αλυσίδα (εκκρεμεί_πληρωμή) ανά payer_address κάθε φορά. Διαφορετικά, λαμβάνετε 409 PENDING_PAYMENT_INTENT_EXISTS. Σε περίπτωση μειωμένης/υπερπληρωμής, η τελική ενέργεια μπορεί να διαφέρει — ελέγξτε το effect_energy_amount στο GET /orders/:id.

Σώμα αιτήματος

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Απάντηση

json

{
  "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 — ΠΑΡΕΤΕ /balance για να ελέγξετε το TRX σας. Βήμα 2 — POST /προσφορά για την τιμή. Βήμα 3 — ΔΗΜΟΣΙΕΥΣΗ /παραγγελίες με τρόπο πληρωμής: υπόλοιπο για χρέωση και έναρξη ανάθεσης. Βήμα 4 — δημοσκόπηση GET /orders/:id έως ότου γίνει ανάθεση (σε περίπτωση σφάλματος ανάθεσης αποτυγχάνει και το TRX επιστρέφεται στο υπόλοιπό σας).

Δεν απαιτείται payer_address — ο λογαριασμός που είναι συνδεδεμένος με το κλειδί API σας πληρώνει. Το ποσό ενέργειας_ στην απόκριση μπορεί να είναι υψηλότερο από το παραγγελθέν SKU (μπόνους μήτρας τιμής).

Σώμα αιτήματος

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Απάντηση

json

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

Υπολογίστε τις απαιτήσεις ενοικίασης ενέργειας TRON

Υπολογίστε πόση ενέργεια χρειάζεται μια διεύθυνση για μια μεταφορά. Περάστε το πορτοφόλι του παραλήπτη και εάν κατέχει ήδη USDT.

POST/api/v2/quick-rent/calculator

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`πορτοφόλι_διεύθυνση`	string	Διεύθυνση TRON για ανάλυση	`TXXXXXXXX...XXXX`
`has_usdt`	boolean \| null	Εάν ο παραλήπτης κατέχει ήδη USDT (επηρεάζει την ενέργεια). αληθινό, ψευδές ή παράλειψη.	`true`

Σώμα αιτήματος

json

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

ΚΟΥΡΛ

bash

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, διαθεσιμότητα, save_percent και πόσο καιρό ισχύει η προσφορά (λήγει_σε_δευτ.).

POST/api/v2/quick-rent/quote

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`ενέργεια_ποσό`	int	Ποσότητα ενέργειας από τον ενεργό κατάλογο	`131000`
`διάρκεια_λεπτά`	int	Διάρκεια ενοικίασης από τον κατάλογο	`15`

Απάντηση

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

ΚΟΥΡΛ

bash

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

Δημιουργεί μια παραγγελία ενοικίασης. Για on-chain, περάστε payer_address και πληρώστε το επιστρεφόμενο ποσό_trx στο pay_address. Για υπόλοιπο, προσθέστε pay_mode: balance και ο συνδεδεμένος λογαριασμός χρεώνεται αμέσως.

Η target_address είναι προαιρετική (προεπιλογή σε payer_address). Λάβετε υπόψη τους 409 κανόνες: μία ανοιχτή παραγγελία στην αλυσίδα ανά πληρωτή και καμία ενεργή αντιπροσωπεία γρήγορης ενοικίασης ήδη στον στόχο (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`ενέργεια_ποσό`	int	Ποσότητα ενέργειας από τον κατάλογο	`131000`
`διάρκεια_λεπτά`	int	Διάρκεια ενοικίασης από τον κατάλογο	`15`
`idempotency_key`	string	Το μοναδικό αναγνωριστικό παραγγελίας σας (8–128 χαρακτήρες)	`partner-onchain-001`
`τρόπος πληρωμής`	string	Προαιρετικό. "onchain" (προεπιλογή) ή "balance".	`balance`
`payer_address`	string	On-chain: πορτοφόλι που στέλνει TRX. Δεν χρειάζεται για ισορροπία.	`TPayer...`
`target_address`	string	Προαιρετικό. Πορτοφόλι που λαμβάνει ενέργεια (προεπιλογή σε payer_address).	`TTarget...`

Απόκριση (on-chain)

json

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

Απόκριση (υπόλοιπο)

json

{
  "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 (στην αλυσίδα)

bash

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 (υπόλοιπο)

bash

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 αντικατοπτρίζει την πραγματική ενέργεια που έχει εκχωρηθεί μετά από μειωμένη/υπερπληρωμή.

GET/api/v2/quick-rent/orders/:id

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`id`	string	Αναγνωριστικό παραγγελίας (παράμετρος διαδρομής)	`uuid`

Απάντηση

json

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

ΚΟΥΡΛ

bash

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

Ακύρωση παραγγελίας

Ακυρώνει μια παραγγελία που είναι ακόμα σε εκκρεμότητα_payment (μόνο στην αλυσίδα). Μετά την ανάθεση ενέργειας, η παραγγελία δεν μπορεί πλέον να ακυρωθεί.

POST/api/v2/quick-rent/orders/:id/cancel

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`id`	string	Αναγνωριστικό παραγγελίας (παράμετρος διαδρομής)	`uuid`

ΚΟΥΡΛ

bash

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

Αλλαγή πληρωτή

Αλλάζει το πορτοφόλι πληρωμής για μια παραγγελία pending_payment on-chain — χρήσιμο εάν ο πελάτης αποφασίσει να πληρώσει από διαφορετικό πορτοφόλι πριν στείλει το TRX.

POST/api/v2/quick-rent/orders/:id/set-payer

Παράμετροι

Παράμετρος	Type	Περιγραφή	Example
`id`	string	Αναγνωριστικό παραγγελίας (παράμετρος διαδρομής)	`uuid`
`payer_address`	string	Νέο πορτοφόλι πληρωμής	`TNewPayer...`

ΚΟΥΡΛ

bash

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 (το υπόλοιπό σας εντός της εφαρμογής, όχι ένα πορτοφόλι στην αλυσίδα). Απαιτεί την κεφαλίδα Εξουσιοδότηση.

GET/api/v2/quick-rent/balance

Απάντηση

json

{ "balance_trx": "150.500000" }

ΚΟΥΡΛ

bash

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`	Υπάρχει ήδη μια ανοιχτή παραγγελία στην αλυσίδα για αυτόν τον πληρωτή
409	`ACTIVE_DELEGATION_EXISTS`	Το Target έχει ήδη μια ενεργή αντιπροσωπεία Quick Rent
409	`POOL_ENERGY_INSUFFICIENT`	Δεν υπάρχει δωρεάν ενέργεια πισίνας αυτή τη στιγμή
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Το ίδιο κλειδί idempotency με διαφορετικό τρόπο πληρωμής
429	`Too Many Requests`	Όριο ποσοστού
503	`—`	Η υπηρεσία δεν είναι διαθέσιμη προσωρινά, δοκιμάστε ξανά αργότερα

Αν κάτι πάει στραβά

Συνήθεις καταστάσεις και τι να κάνεις, με απλά λόγια.

Πλήρωσα αλλά η παραγγελία έχει κολλήσει στο pending_payment

Βεβαιωθείτε ότι το μεταφερόμενο ποσό ισούται ακριβώς με το ποσό_trx και τα χρήματα πήγαν στη διεύθυνση pay_address από την ακριβή διεύθυνση_πληρωτή. Η μεταφορά πρέπει να φτάσει πριν από την ημερομηνία λήξης. Η κατάσταση συνήθως ενημερώνεται μέσα σε ένα λεπτό μετά την επιβεβαίωση δικτύου — συνεχίστε να ψηφίζετε GET /orders/:id.

Η κατάσταση έγινε αποτυχημένη — τι είναι;

Η αντιπροσωπεία δεν πέτυχε. Για πληρωμές υπολοίπου το TRX επιστρέφεται αυτόματα στο υπόλοιπό σας. Ο λόγος είναι στο error_code και στο error_message του GET /orders/:id. Μπορείτε να δημιουργήσετε μια νέα παραγγελία.

Σφάλμα 409 PENDING_PAYMENT_INTENT_EXISTS

Αυτή η payer_address έχει ήδη μια απλήρωτη παραγγελία on-chain. Πληρώστε το, περιμένετε να λήξει (expires_at) ή ακυρώστε το μέσω /orders/:id/cancel και, στη συνέχεια, δημιουργήστε ένα νέο.

Σφάλμα 403 BALANCE_PAYMENT_NOT_ENABLED

Η πληρωμή υπολοίπου δεν είναι ενεργοποιημένη για το κλειδί σας. Επικοινωνήστε με την υποστήριξη TronBid για να το ενεργοποιήσετε ή χρησιμοποιήστε το on-chain (η προεπιλογή).

Σφάλμα 429 Πάρα πολλά αιτήματα

Πάρα πολλά αιτήματα σε σύντομο χρονικό διάστημα. Μειώστε τη συχνότητα ψηφοφορίας (π.χ. μία φορά κάθε 3 δευτερόλεπτα) και δοκιμάστε ξανά αργότερα.

Πήρα λιγότερη ενέργεια από ό,τι παρήγγειλα

Με την υστέρηση/υπερπληρωμή στην αλυσίδα το τελικό ποσό αλλάζει. Ελέγξτε το effect_energy_amount στο GET /orders/:id — αυτή είναι η ενέργεια που εκχωρείται πραγματικά.

Υποστήριξη ενοποίησης TRON Energy API

Χρειάζεστε πρόσβαση στο API, υψηλότερα όρια ή ενεργοποιημένη πληρωμή υπολοίπου; Απευθυνθείτε και θα βοηθήσουμε.

Πρόσβαση στο API και πληρωμή υπολοίπουΤηλεγράφημα @tronbid

Emailsupport@tronbid.com