API REST v2Documentation mise à jour le 2 août 2026

API TRON Energy Rental — Automatisez les transferts USDT TRC-20

Intégrez l'API v2 pour citer, créer et suivre les commandes de location de TRON Energy par programmation. Payez en chaîne ou à partir de votre solde TronBid et réduisez le TRX brûlé par les appels de contrat intelligent.

Devis en direct et catalogue de packages
Paiement en chaîne ou sur solde
Ordonnances idempotentes et sondages de statut

Obtenir l'accès à l'API Ouvrir le démarrage rapide Louer de l'énergie sans API Calculer les besoins énergétiques

Sur cette page

API TRON Energy Rental : présentation et cas d'utilisation

L'API Quick Rent est un moyen de louer TRON Energy automatiquement, sans travail manuel. L'énergie rend les transferts USDT (TRC-20) et autres appels de contrats intelligents moins chers que la combustion de TRX.

En termes simples : votre programme (un site, un robot ou un service) achète lui-même de l'énergie, exactement au moment où elle en a besoin, par exemple avant chaque transfert USDT effectué par votre client.

Pensez à un distributeur automatique : vous vérifiez le prix, insérez de l'argent, récupérez votre article. L'API est le même ensemble de boutons : seul votre programme appuie dessus.

1
Demandez un prix
Votre programme demande à l'API combien coûte actuellement le package énergétique nécessaire.
2
Créer une commande et payer
Votre programme crée une commande et la paie — en envoyant TRX à l'adresse indiquée ou en débitant votre solde TronBid.
3
Obtenez l'énergie
En quelques secondes, de l'énergie apparaît sur le portefeuille cible et l'USDT peut être envoyé à moindre coût.

Important : l'API est un outil pour un développeur. Pour l'utiliser, quelqu'un doit écrire du code qui envoie les requêtes.

S'il n'y a personne pour écrire le code, utilisez l'achat d'énergie prêt à l'emploi sur le site (Quick Rent) ou le bot Telegram @tronbid. Même résultat, juste fait manuellement.

Démarrage rapide : de zéro à l'énergie

Un exemple complet de bout en bout sur le scénario le plus simple (en chaîne). Quatre étapes et l'énergie est sur le portefeuille.

Vous trouverez ci-dessous ce qui se passe à chaque étape et ce que renvoie l'API. Branchez votre clé API, vos adresses et votre identifiant de commande.

1
Étape 1. Obtenez un prix — POST/devis
Envoyez la quantité d'énergie et la durée. Vous récupérez price_trx et combien de secondes il est verrouillé.
2
Étape 2. Créer une commande — POST /commandes
Envoyez le colis, votre idempotency_key et payeur_address. Vous obtenez pay_address (où payer), montant_trx (combien) et expires_at (jusqu'à quand).
3
Étape 3. Payer
Envoyez exactement montant_trx TRX à pay_address depuis votre payeur_address. C'est un simple transfert TRON.
4
Étape 4. Attendez l'énergie — GET /orders/:id
Interrogez le statut toutes les deux secondes jusqu'à ce qu'il soit délégué. Cela signifie que l’énergie est déléguée au portefeuille – c’est fait.

Réponse

json

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

Réponse (en chaîne)

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

boucle

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

Réponse

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
}

Glossaire

Brèves explications des mots utilisés dans cette documentation.

Énergie: Le « carburant » du réseau TRON pour les opérations de contrats intelligents. S'il n'y en a pas assez, le réseau brûle TRX à la place, ce qui coûte plus cher. Louer de l’énergie permet d’économiser de l’argent.
TRX: La pièce native du réseau TRON. Il prend en charge la location d'énergie et les frais de réseau.
USDT TRC-20: Un stablecoin (dollar) sur TRON. L’envoyer est un appel de contrat intelligent qui a besoin d’énergie.
Clé API: Votre mot de passe secret pour l'accès à l'API. Envoyé avec chaque demande. Conservez-le uniquement sur le serveur.
Point de terminaison: Un "bouton" d'adresse spécifique de l'API où votre programme envoie une demande (par exemple /quote - obtenir un prix).
OBTENIR/POSTER: Types de requêtes. GET signifie « il suffit de demander/lire des données » ; POST signifie « faire une action » (créer une commande, calculer un prix).
Jeton du porteur: Comment transmettre la clé API : l'en-tête indique Autorisation : Porteur YOUR_KEY.
Paiement en chaîne: Payer une commande avec un simple virement TRX à l'adresse indiquée - fonctionne immédiatement, rien à activer.
Paiement du solde: Payer en débitant le solde de votre compte TronBid. Plus rapide, mais doit d'abord être activé pour votre clé.
Délégation: Remettre temporairement l'énergie louée au portefeuille cible pour la période de location (par exemple 15 ou 60 minutes).
Sondage: Demander à nouveau l'état de la commande périodiquement (toutes les deux secondes) jusqu'à ce qu'elle soit déléguée ou se termine par une erreur.
clé_idempotence: Votre identifiant de commande unique. Si une demande est envoyée deux fois, l'API renvoie la même commande au lieu d'en créer une nouvelle — protection contre le double paiement.

Avant de commencer

Que préparer avant de faire votre première demande.

1
Obtenez une clé API
Envoyez un message @tronbid sur Telegram — vous recevrez une clé liée à votre compte TronBid. Les demandes ne seront pas acceptées sans cela.
2
Avoir un portefeuille TRON cible
Décidez de l'adresse (target_address) qui a besoin d'énergie. Il s'agit généralement du portefeuille à partir duquel vos clients envoient des USDT.
3
Choisissez un forfait dans le catalogue
L'énergie est vendue en forfaits (généralement 65 000 ou 131 000 énergies pour 15 ou 60 minutes). Obtenez la liste en direct à partir du point de terminaison du catalogue, aucune authentification n'est nécessaire.
4
Préparer le paiement
Pour la chaîne : un portefeuille avec TRX pour payer. Pour le paiement du solde : un compte TronBid approvisionné et le mode solde activé.

URL de base de l'API de production

L'API Quick Rent permet à votre service de louer automatiquement TRON Energy, de sorte que les transferts USDT TRC-20 et autres appels de contrat intelligent coûtent moins cher que la gravure de TRX.

Tous les points de terminaison partagent une URL de base.

URL de base (production)

http

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

Autorisation

Chaque demande doit inclure votre clé API en tant que jeton Bearer dans l'en-tête Authorization.

Conservez la clé côté serveur uniquement (backend, secrets CI). Ne l'envoyez jamais dans le code frontend ou dans des référentiels publics. La clé est liée à un seul compte TronBid (le portefeuille défini lorsque l'accès a été accordé) ; les paiements de solde ne peuvent être prélevés que sur ce compte.

Si vous dépassez la limite de débit, l'API répond avec HTTP 429.

http

Authorization: Bearer <API_KEY>

Modes de paiement

Il existe deux manières de payer une commande. En chaîne est la valeur par défaut et ne nécessite aucune configuration. Le paiement du solde est facultatif et doit être activé pour votre clé.

Sans activation, une requête avec payment_mode: balance renvoie 403 BALANCE_PAYMENT_NOT_ENABLED. Pour l'activer, contactez le support TronBid.

Mode	Comment activer	Paiement
`on-chain`	Par défaut : omettre payment_mode (ou "onchain")	Envoyer TRX à pay_address depuis pay_address
`balance`	payment_mode : solde + activé pour votre clé	Débité de votre solde TronBid TRX

Catalogue de packages

energy_amount et duration_minutes doivent correspondre à un forfait Quick Rent actif – généralement 65 000 ou 131 000 énergies et 15 ou 60 minutes.

Récupérez le catalogue actuel à tout moment (aucune authentification requise) :

Récupérer le catalogue actif (pas d'authentification)

bash

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

Flux en chaîne

Étape 1 — POST/devis pour connaître le prix. Étape 2 — POST /orders pour créer la commande et recevoir pay_address, montant_trx et expires_at. Étape 3 : envoyez exactement montant_trx TRX à pay_address à partir de votre pay_address. Étape 4 — interrogez GET /orders/:id jusqu'à ce que le statut soit délégué (ou échoué/expiré/annulé).

target_address est facultatif — s’il est omis, l’énergie est déléguée à payeur_address.

Une seule commande ouverte en chaîne (ending_payment) est autorisée par payeur_address à la fois ; sinon vous obtenez 409 PENDING_PAYMENT_INTENT_EXISTS. En cas de sous-paiement ou de trop-payé, l'énergie finale peut différer — vérifiez effective_energy_amount dans GET /orders/:id.

Corps de la demande

json

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

Réponse

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

Flux d'équilibre

Étape 1 — OBTENEZ /balance pour vérifier votre TRX. Étape 2 — POST/devis pour le prix. Étape 3 — POST /commandes avec payment_mode : solde à débiter et démarrer la délégation. Étape 4 — interrogez GET /orders/:id jusqu'à ce qu'il soit délégué (en cas d'erreur de délégation, cela échoue et TRX est remboursé sur votre solde).

payeur_address n'est pas nécessaire — le compte lié à votre clé API paie. Le montant d'énergie dans la réponse peut être supérieur au SKU commandé (bonus de matrice de prix).

Corps de la demande

json

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

Réponse

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

Statuts des commandes

Chaque commande passe par ces statuts. Sondez GET /orders/:id pour le suivre.

Status	Signification
`pending_payment`	En attente du paiement en chaîne
`delegating`	Paiement reçu ou solde facturé ; délégation en cours
`delegated`	Énergie déléguée
`cancelled`	Annulé avant le paiement (en chaîne)
`expired`	La fenêtre de paiement en chaîne est écoulée
`failed`	Erreur (pour le solde, TRX est remboursé)

Idempotence

idempotency_key (8 à 128 caractères) est un identifiant de commande unique de votre côté. Répéter POST /orders avec la même clé (pour le même client API) renvoie la même commande avec "duplicata": true.

Ne réutilisez pas une idempotency_key dans différents modes de paiement (onchain ou solde) – cela renvoie 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Calculer les besoins de location de TRON Energy

Estimez la quantité d’énergie dont une adresse a besoin pour un transfert. Transmettez le portefeuille du destinataire et s'il contient déjà de l'USDT.

POST/api/v2/quick-rent/calculator

Paramètres

Paramètre	Type	Descriptif	Example
`adresse_portefeuille`	string	Adresse TRON à analyser	`TXXXXXXXX...XXXX`
`has_usdt`	boolean \| null	Si le destinataire détient déjà de l'USDT (affecte l'énergie). vrai, faux ou omettre.	`true`

Corps de la demande

json

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

boucle

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}'

Obtenez un devis de location TRON Energy

Renvoie le prix actuel d'un package : price_trx, disponibilité, save_percent et la durée de validité du devis (expires_in_sec).

POST/api/v2/quick-rent/quote

Paramètres

Paramètre	Type	Descriptif	Example
`montant_énergie`	int	Quantité d'énergie du catalogue actif	`131000`
`durée_minutes`	int	Durée de location du catalogue	`15`

Réponse

json

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

boucle

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}'

Créer une commande de location TRON Energy

Crée une commande de location. Pour la chaîne, transmettez pay_address et payez le montant_trx retourné à pay_address. Pour le solde, ajoutez payment_mode: balance et le compte lié est facturé immédiatement.

target_address est facultatif (par défaut, payeur_address). Attention aux règles 409 : une commande en chaîne ouverte par payeur et aucune délégation Quick Rent active déjà sur la cible (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Paramètres

Paramètre	Type	Descriptif	Example
`montant_énergie`	int	Quantité d'énergie du catalogue	`131000`
`durée_minutes`	int	Durée de location du catalogue	`15`
`clé_idempotence`	string	Votre identifiant de commande unique (8 à 128 caractères)	`partner-onchain-001`
`mode_paiement`	string	Facultatif. "onchain" (par défaut) ou "balance".	`balance`
`adresse_payeur`	string	On-chain : portefeuille qui envoie du TRX. Pas nécessaire pour l’équilibre.	`TPayer...`
`adresse_cible`	string	Facultatif. Portefeuille qui reçoit de l'énergie (par défaut, payeur_address).	`TTarget...`

Réponse (en chaîne)

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

Réponse (solde)

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 (en chaîne)

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 (solde)

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

Obtenir le statut de la commande

Renvoie l'état actuel, le mode de paiement, les montants, les adresses et le code_erreur/message_erreur en cas d'échec. effective_energy_amount reflète l'énergie réellement déléguée après un sous-paiement/un trop-payé.

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

Paramètres

Paramètre	Type	Descriptif	Example
`identifiant`	string	ID de commande (paramètre de chemin)	`uuid`

Réponse

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
}

boucle

bash

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

Annuler la commande

Annule une commande qui est toujours en attente de paiement (en chaîne uniquement). Une fois l’énergie déléguée, la commande ne peut plus être annulée.

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

Paramètres

Paramètre	Type	Descriptif	Example
`identifiant`	string	ID de commande (paramètre de chemin)	`uuid`

boucle

bash

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

Changer de payeur

Modifie le portefeuille de paiement pour une commande en chaîne en attente de paiement – utile si le client décide de payer à partir d'un autre portefeuille avant d'envoyer TRX.

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

Paramètres

Paramètre	Type	Descriptif	Example
`identifiant`	string	ID de commande (paramètre de chemin)	`uuid`
`adresse_payeur`	string	Nouveau portefeuille payant	`TNewPayer...`

boucle

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

Vérifiez le solde de l'API TronBid

Renvoie le solde TRX du compte TronBid lié à votre clé API (votre solde dans l'application, pas un portefeuille en chaîne). Nécessite l’en-tête Authorization.

GET/api/v2/quick-rent/balance

Réponse

json

{ "balance_trx": "150.500000" }

boucle

bash

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

Codes d'erreur

Les erreurs renvoient un statut HTTP et un champ d'erreur. Voici ceux que vous pourriez rencontrer.

HTTP	error	Quand
400	`Invalid body`	JSON ou champs invalides
400	`INVALID_SKU / SKU_INACTIVE`	Forfait indisponible
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Adresse TRON mal formée
400	`INSUFFICIENT_BALANCE`	Pas assez de TRX sur la balance (mode balance)
401	`Unauthorized`	Clé API manquante ou invalide
403	`BALANCE_PAYMENT_NOT_ENABLED`	Le paiement du solde n'est pas activé pour votre clé
409	`PENDING_PAYMENT_INTENT_EXISTS`	Une commande ouverte en chaîne existe déjà pour ce payeur
409	`ACTIVE_DELEGATION_EXISTS`	Target dispose déjà d’une délégation Quick Rent active
409	`POOL_ENERGY_INSUFFICIENT`	Pas d'énergie de piscine gratuite pour le moment
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Même idempotency_key avec un payment_mode différent
429	`Too Many Requests`	Limite de taux
503	`—`	Service temporairement indisponible, réessayez plus tard

Si quelque chose ne va pas

Situations courantes et que faire, en termes simples.

J'ai payé mais la commande est bloquée dans ending_payment

Assurez-vous que le montant transféré est exactement égal à montant_trx et que les fonds sont allés à pay_address à partir de l'adresse exacte du payeur. Le transfert doit arriver avant expires_at. Le statut est généralement mis à jour dans la minute qui suit la confirmation du réseau – continuez à interroger GET /orders/:id.

Le statut est devenu un échec : qu'est-ce que c'est ?

La délégation n'a pas réussi. Pour les paiements de solde, le TRX est automatiquement renvoyé sur votre solde. La raison est dans error_code et error_message de GET /orders/:id. Vous pouvez créer une nouvelle commande.

Erreur 409 PENDING_PAYMENT_INTENT_EXISTS

Cette adresse_payeur a déjà une commande en chaîne impayée. Payez-le, attendez qu'il expire (expires_at), ou annulez-le via /orders/:id/cancel, puis créez-en un nouveau.

Erreur 403 BALANCE_PAYMENT_NOT_ENABLED

Le paiement du solde n'est pas activé pour votre clé. Contactez le support TronBid pour l'activer ou utilisez-le en chaîne (par défaut).

Erreur 429 Trop de demandes

Trop de demandes en peu de temps. Réduisez la fréquence d’interrogation (par exemple une fois toutes les 3 secondes) et réessayez plus tard.

J'ai eu moins d'énergie que ce que j'avais commandé

En cas de sous-paiement/trop-paiement en chaîne, le montant final change. Vérifiez effective_energy_amount dans GET /orders/:id — c'est l'énergie réellement déléguée.

Prise en charge de l'intégration de l'API TRON Energy

Besoin d'un accès API, de limites plus élevées ou d'un paiement du solde activé ? Contactez-nous et nous vous aiderons.

Accès API et paiement du soldeTélégramme @tronbid

Courrielsupport@tronbid.com