API de location d’énergie TRON
Louez de l'énergie TRON par programmation au lieu de dépenser des TRX en frais : 70 à 80 % de moins par transfert TRC-20.
- Commande : indiquez adresse destinataire, quantité d'énergie et durée ; la délégation arrive en quelques secondes
- Consultation : recherchez l'état de délégation et l'expiration par identifiant de commande ou adresse
- Prix : tarif unitaire en direct et paliers pour planifier les coûts
- Webhooks : événements de délégation réussie et d'expiration, signés par HMAC
GET / POST /api/v1/energy/*
Authentification
L’API de location d’énergie s’authentifie avec votre clé API utilisateur. Ajoutez les en-têtes suivants à chaque requête :
Connectez-vous à la console → Outils et paramètres → Gestion API, puis créez et activez une clé pour obtenir X-API-Key et X-Secret-Key.
Appels signés des points d’accès facturés
La commande, la commande ponctuelle et la récupération sont facturées. Les nouvelles clés API exigent par défaut une signature (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature) ; un exemple complet de commande figure ci-dessous. La consultation accepte toujours X-API-Key + X-Secret-Key seuls. Désactiver l’exigence de signature pour les opérations facturées et données sensibles permet aussi le simple X-Secret-Key pour ces appels, mais ce n’est pas recommandé.
Vue d’ensemble
Les transferts USDT sur TRON consomment de l’énergie. Sans TRX gelés, une adresse paie environ 6.5-13 TRX de frais par transaction. Avec de l’énergie louée, le transfert utilise cette énergie au lieu de brûler des TRX ; l’économie dépend du prix de location au moment de la commande.
Transfert USDT vers une adresse ayant déjà un solde USDT : environ 65 000 d’énergie
Transfert USDT vers une adresse n’ayant jamais reçu d’USDT : environ 135 000 d’énergie
Obtenir les informations de la plateforme
GET /api/v1/energy/info
Obtenez les informations publiques du service de location : énergie disponible, paliers de prix et limites.
Consulter le solde du compte
GET /api/v1/energy/balance
Consultez le solde du compte propriétaire de cette clé. La location d’énergie implique des opérations fréquentes de faible montant et les soldes insuffisants sont courants. Vérifiez avant les commandes en lot et configurez une alerte de solde bas.
Lister les durées de location, point de terminaison
GET /api/v1/energy/periods
Renvoie les durées prises en charge. Toute valeur hors liste est rejetée avec 400, sans création de commande.
Estimation du prix
GET /api/v1/energy/price
Estimez le coût pour une durée et une quantité d’énergie données. Renvoie le prix spécifique API en TRX.
Estimer la consommation d’énergie
GET /api/v1/energy/estimate-energy
Estimez l’énergie nécessaire pour envoyer des USDT à une adresse donnée.
Créer une commande de location
POST /api/v1/energy/order
Passez une commande de location d’énergie ; les frais sont débités du solde en USD.
Champs de réponse
En cas de solde insuffisant, renvoie code: 400, message: "Insufficient account balance, please top up first"
Commande d’énergie ponctuelle
POST /api/v1/energy/order/onetime
Passez une commande selon la stratégie par transaction ; energy_amount est attribué automatiquement.
Consulter la liste des commandes
GET /api/v1/energy/orders
Consultez vos commandes de location d’énergie.
Consulter une commande
GET /api/v1/energy/order/:serial
Consultez les détails et synchronisez le dernier état.
Consulter une commande par votre numéro de transaction
GET /api/v1/energy/order/by-trade-no/:out_trade_no
Recherchez une commande avec votre out_trade_no ; notre numéro n’est pas requis.
⚠️ En cas d’expiration du délai, la création renvoie 504 et vous ne possédez que out_trade_no : notre numéro n’est pas présent dans cette réponse. Ce point de terminaison sert précisément à récupérer le résultat final avec le même out_trade_no.
Récupérer la commande
POST /api/v1/energy/order/reclaim
Récupérez à l’avance une location d’énergie non expirée.
Rappel du résultat des commandes
Pour les commandes avec callback_url (y compris les commandes ponctuelles), la plateforme transmet une seule fois le résultat à cette URL dès le premier règlement réussi (status=40) ou échoué (status=41). Quelle que soit la confirmation — notification d’état en temps réel, interrogation, rapprochement ou récupération d’une commande non enregistrée — chaque commande n’est notifiée qu’une fois, avec relance automatique des livraisons échouées. Exception : une création ayant renvoyé 504 avec un résultat inconnu (enregistrée comme un objet provisoire dont le numéro commence par LOCAL-) est résolue manuellement et jamais notifiée automatiquement ; vérifiez-la avec votre propre numéro de commande. Les rappels sont envoyés et signés par la plateforme ; l’ancien format de rappel n’est plus utilisé. Les intégrations existantes doivent adapter leur analyse et leurs vérifications de signature à cette section.
La requête est un POST avec Content-Type: application/json. Le corps est un objet JSON plat dont toutes les valeurs sont des chaînes (y compris status, energy_amount et timestamp), sans champs de prix. La plateforme ne suit pas les redirections et chaque requête expire après 10 secondes.
Vérifier la signature
L’algorithme est celui des rappels de paiement : prenez tous les champs non vides sauf sign, triez leurs noms dans l’ordre ASCII, concaténez sous la forme k1=v1&k2=v2&…, puis calculez HMAC-SHA256 en hexadécimal minuscule. La clé est la Secret Key de la clé API ayant passé la commande ; pour des identifiants d’application de paiement, utilisez son Push Secret (WebhookSecret, visible dans la console sur la page de détail — le même que pour les rappels de paiement). Les anciennes applications n’ayant jamais généré de Push Secret utilisent l’App Key.
La notification ne contient pas sign si l’assistance a créé la commande pour vous (sans clé associée), ou si la clé API ou l’application de paiement a été supprimée depuis. À réception d’une notification sans sign, confirmez l’état via le point d’accès de consultation avant d’agir.
Réponse et nouvelles tentatives
Tout statut 2xx vaut livraison réussie ; le corps de la réponse n’est pas vérifié. Un autre statut, un délai dépassé, un échec de connexion ou une redirection valent échec. La plateforme réessaie après 30 secondes, 1 minute, 2 minutes et 5 minutes, puis toutes les 10 minutes, jusqu’à 10 nouvelles tentatives (arrêt après environ 70 minutes). Le corps renvoyé reste identique, y compris notify_id et sign.
Si le réseau se coupe après votre traitement mais avant réception du 2xx par la plateforme, la même commande est notifiée à nouveau. Dédupliquez par notify_id ou serial et évitez les effets secondaires d’un double traitement. La notification n’est pas l’unique source de vérité : si elle n’arrive jamais ou échoue définitivement, vérifiez le résultat avec GET /api/v1/energy/order/:serial ou votre propre numéro de commande.
Périodes de location
Ce sont toutes les durées prises en charge actuellement, aussi disponibles via GET /api/v1/energy/periods. Toute autre valeur renvoie 400 sans création de commande.
Questions fréquentes
Combien l'API de location d'énergie fait-elle réellement économiser ?
Payer directement les frais en TRX pour un transfert USDT TRC-20 coûte généralement environ 6.5-13 TRX. Louer de l'énergie réduit ce coût de 70 à 80 %, avec un écart accru pour les transferts groupés.
Quel est le délai de délégation et puis-je viser une autre adresse ?
La délégation arrive en quelques secondes. L'adresse destinataire est celle fournie dans la requête et n'a pas à être celle du compte commanditaire ; vous pouvez alimenter en énergie vos adresses professionnelles par lots.
Pages connexes: Location d'énergie TRON · Documentation API · Paiements crypto multichaînes
Chargement…