API del marketplace de energía Tron

Bienvenido a la documentación oficial de nuestra API del marketplace de energía Tron. Aquí encontrarás detalles sobre los endpoints públicos que te permiten:

  • Obtener los parámetros actuales de la plataforma (precio de la energía, suministro disponible, tamaño mínimo de pedido y dirección de depósito).
  • Comprobar el estado de un pedido de compra de energía específico mediante el hash de depósito.

Actualmente hay dos endpoints GET disponibles y no requieren autenticación.

Resumen de endpoints

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

Devuelve la configuración en vivo de la plataforma, como si el sistema está activo, cuánta energía hay disponible, el precio de la energía, la dirección de depósito, etc.

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

Devuelve el estado de un pedido de compra específico, incluidos los hash de transacción y los detalles de delegación.

Endpoints detallados

GET

/energy/info

Descripción

Proporciona parámetros como el precio actual de la energía, cuánta energía hay disponible, la dirección de depósito y otra información (p. ej., la hora del servidor, si el sistema está activo).

Solicitud

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

Respuesta

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

Descripción de los campos

Campo Tipo Descripción
isSystemActive Boolean Indica si el marketplace está operativo.
maximumEnergyAvailable Integer Número total de unidades de energía disponibles actualmente para comprar.
energyUnitPriceInSun Integer El coste (en SUN) por unidad de energía. (1 TRX = 1.000.000 SUN)
minEnergyOrderAmount Integer Cantidad mínima de energía (unidades) para un solo pedido.
depositAddress String Dirección Tron a la que los compradores envían TRX. El sistema delega automáticamente la energía al remitente una vez recibido el pago.
serverTime String Marca de tiempo del servidor en formato ISO.
GET

/energy/order/{depositHash}

Descripción

Recupera el estado de un pedido de compra asociado al hash de transacción de depósito proporcionado.

Solicitud

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

Respuesta

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

Descripción de los campos

Campo Tipo Descripción
depositHash String Hash de transacción del depósito (TRX enviados a la plataforma).
delegationHash String Hash de transacción de la delegación on-chain (si la hay).
refundHash String Hash de transacción de cualquier reembolso (si corresponde; de lo contrario, null).
status String Estado del pedido (p. ej., «ResourcesDelegated», «Refunded», «Pending», etc.). Consulta las descripciones de estado más abajo.
created String Marca de tiempo de cuando se detectó el pedido por primera vez.
executed String Marca de tiempo de cuando el sistema delegó o procesó el pedido correctamente.
targetAddress String Dirección Tron que recibió la energía delegada.
depositAmount Number Cantidad de TRX recibida de la transacción de depósito.
energyAmount Integer Cantidad de unidades de energía delegadas a la dirección de destino.

Valores de estado del pedido

Valores posibles para el campo status:
Estado Descripción
Created El pedido se ha creado pero aún no se ha procesado.
Pending Pago recibido y pedido en proceso.
ResourcesDelegated La energía se ha delegado correctamente a la dirección de destino.
RefundRequested Se ha solicitado un reembolso pero aún no se ha procesado.
PendingRefund El reembolso se está procesando.
Refunded Los TRX se han reembolsado al remitente.

Notas adicionales

Sin autenticación

Actualmente, estos endpoints son públicos. Es posible que introduzcamos claves API o tokens en el futuro.

Unidades de energía y SUN

Recuerda: 1 TRX = 1.000.000 SUN. Así que si energyUnitPriceInSun es 50, eso significa 0.000050 TRX por unidad de energía.

Creación implícita de pedidos

Un «pedido» se crea automáticamente cada vez que se envían TRX a la dirección de depósito. Usa el hash de transacción del depósito para hacer un seguimiento del estado.

Hora del servidor

Las horas se indican en formato ISO 8601 (UTC). Ten en cuenta las zonas horarias al compararlas con las horas locales.