API du marketplace d'énergie Tron

Bienvenue dans la documentation officielle de notre API du marketplace d'énergie Tron. Vous y trouverez des détails sur les endpoints publics qui vous permettent de :

  • Récupérer les paramètres actuels de la plateforme (prix de l'énergie, offre disponible, taille minimale de commande et adresse de dépôt).
  • Vérifier le statut d'une commande d'achat d'énergie spécifique par hash de dépôt.

Actuellement, deux endpoints GET sont disponibles et ne nécessitent pas d'authentification.

Aperçu des endpoints

GET https://api.tron.discount/energy/info

Renvoie les paramètres en direct de la plateforme, comme l'état d'activité du système, la quantité d'énergie disponible, le prix de l'énergie, l'adresse de dépôt, etc.

GET https://api.tron.discount/energy/order/{depositHash}

Renvoie le statut d'une commande d'achat spécifique, y compris les hash de transaction et les détails de délégation.

Endpoints détaillés

GET

/energy/info

Description

Fournit des paramètres comme le prix actuel de l'énergie, la quantité d'énergie disponible, l'adresse de dépôt et d'autres informations (par ex. l'heure du serveur, l'état d'activité du système).

Requête

curl -X GET https://api.tron.discount/energy/info

Réponse

{
  "isSystemActive": true,
  "maximumEnergyAvailable": 1335378378,
  "energyUnitPriceInSun": 50,
  "minEnergyOrderAmount": 32000,
  "depositAddress": "TSD2AWZeyvE4CFvSfYZ1wiPhKoXxWurLUe",
  "serverTime": "2025-04-05T15:24:05.785059Z"
}

Description des champs

Champ Type Description
isSystemActive Boolean Indique si le marketplace est opérationnel.
maximumEnergyAvailable Integer Nombre total d'unités d'énergie actuellement disponibles à l'achat.
energyUnitPriceInSun Integer Le coût (en SUN) par unité d'énergie. (1 TRX = 1 000 000 SUN)
minEnergyOrderAmount Integer Quantité minimale d'énergie (unités) pour une seule commande.
depositAddress String Adresse Tron à laquelle les acheteurs envoient des TRX. Le système délègue automatiquement l'énergie à l'expéditeur dès réception du paiement.
serverTime String Horodatage du serveur au format ISO.
GET

/energy/order/{depositHash}

Description

Récupère le statut d'une commande d'achat associée au hash de transaction de dépôt fourni.

Requête

curl -X GET https://api.tron.discount/energy/order/d663302b6a303053b8de9a018ea14cbaca9d0cf0e38a498cc86d04748e3bec14

Réponse

{
  "depositHash": "d663302b6a303053b8de9a018ea14cbaca9d0cf0e38a498cc86d04748e3bec14",
  "delegationHash": "b9458d06b1f05ff5d1b2448afa6efb548f7792dd6997ab9cb4e2ce6fbbd560a0",
  "refundHash": null,
  "status": "ResourcesDelegated",
  "created": "2024-06-01T14:38:32",
  "executed": "2024-06-01T14:40:10",
  "targetAddress": "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf",
  "depositAmount": 3.89,
  "energyAmount": 32416
}

Description des champs

Champ Type Description
depositHash String Hash de transaction du dépôt (TRX envoyés à la plateforme).
delegationHash String Hash de transaction de la délégation on-chain (le cas échéant).
refundHash String Hash de transaction d'un éventuel remboursement (le cas échéant, sinon null).
status String Statut de la commande (par ex. « ResourcesDelegated », « Refunded », « Pending », etc.). Voir les descriptions de statut ci-dessous.
created String Horodatage de la première détection de la commande.
executed String Horodatage du moment où le système a délégué ou traité la commande avec succès.
targetAddress String Adresse Tron qui a reçu l'énergie déléguée.
depositAmount Number Montant de TRX reçu de la transaction de dépôt.
energyAmount Integer Quantité d'unités d'énergie déléguées à l'adresse cible.

Valeurs de statut de commande

Valeurs possibles pour le champ status :
Statut Description
Created La commande a été créée mais pas encore traitée.
Pending Paiement reçu et commande en cours de traitement.
ResourcesDelegated L'énergie a été déléguée avec succès à l'adresse cible.
RefundRequested Un remboursement a été demandé mais pas encore traité.
PendingRefund Le remboursement est en cours de traitement.
Refunded Les TRX ont été remboursés à l'expéditeur.

Notes supplémentaires

Aucune authentification

Actuellement, ces endpoints sont publics. Nous pourrions introduire des clés API ou des jetons à l'avenir.

Unités d'énergie et SUN

Rappelez-vous, 1 TRX = 1 000 000 SUN. Donc si energyUnitPriceInSun vaut 50, cela signifie 0.000050 TRX par unité d'énergie.

Création implicite de commande

Une « commande » est créée automatiquement chaque fois que des TRX sont envoyés à l'adresse de dépôt. Utilisez le hash de transaction du dépôt pour suivre le statut.

Heure du serveur

Les heures sont indiquées au format ISO 8601 (UTC). Tenez compte des fuseaux horaires lors de la comparaison avec les heures locales.