API do marketplace de energia Tron

Bem-vindo à documentação oficial da nossa API do marketplace de energia Tron. Aqui você encontra detalhes sobre os endpoints públicos que permitem:

  • Obter os parâmetros atuais da plataforma (preço da energia, oferta disponível, tamanho mínimo do pedido e endereço de depósito).
  • Verificar o status de um pedido de compra de energia específico pelo hash de depósito.

Atualmente, dois endpoints GET estão disponíveis e não exigem autenticação.

Visão geral dos endpoints

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

Retorna as configurações ao vivo da plataforma, como se o sistema está ativo, quanta energia está disponível, o preço da energia, o endereço de depósito, etc.

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

Retorna o status de um pedido de compra específico, incluindo os hashes de transação e os detalhes de delegação.

Endpoints detalhados

GET

/energy/info

Descrição

Fornece parâmetros como o preço atual da energia, quanta energia está disponível, o endereço de depósito e outras informações (por ex., a hora do servidor, se o sistema está ativo).

Requisição

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

Resposta

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

Descrição dos campos

Campo Tipo Descrição
isSystemActive Boolean Indica se o marketplace está operacional.
maximumEnergyAvailable Integer Número total de unidades de energia atualmente disponíveis para compra.
energyUnitPriceInSun Integer O custo (em SUN) por unidade de energia. (1 TRX = 1.000.000 SUN)
minEnergyOrderAmount Integer Quantidade mínima de energia (unidades) para um único pedido.
depositAddress String Endereço Tron para o qual os compradores enviam TRX. O sistema delega automaticamente a energia ao remetente assim que o pagamento é recebido.
serverTime String Carimbo de data/hora do servidor no formato ISO.
GET

/energy/order/{depositHash}

Descrição

Recupera o status de um pedido de compra associado ao hash de transação de depósito fornecido.

Requisição

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

Resposta

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

Descrição dos campos

Campo Tipo Descrição
depositHash String Hash de transação do depósito (TRX enviados à plataforma).
delegationHash String Hash de transação da delegação on-chain (se houver).
refundHash String Hash de transação de qualquer reembolso (se aplicável; caso contrário, null).
status String Status do pedido (por ex., «ResourcesDelegated», «Refunded», «Pending», etc.). Veja as descrições de status abaixo.
created String Carimbo de data/hora de quando o pedido foi detectado pela primeira vez.
executed String Carimbo de data/hora de quando o sistema delegou ou processou o pedido com sucesso.
targetAddress String Endereço Tron que recebeu a energia delegada.
depositAmount Number Quantidade de TRX recebida da transação de depósito.
energyAmount Integer Quantidade de unidades de energia delegadas ao endereço de destino.

Valores de status do pedido

Valores possíveis para o campo status:
Status Descrição
Created O pedido foi criado, mas ainda não foi processado.
Pending Pagamento recebido e pedido em processamento.
ResourcesDelegated A energia foi delegada com sucesso ao endereço de destino.
RefundRequested Um reembolso foi solicitado, mas ainda não foi processado.
PendingRefund O reembolso está sendo processado.
Refunded Os TRX foram reembolsados ao remetente.

Notas adicionais

Sem autenticação

Atualmente, esses endpoints são públicos. Podemos introduzir chaves de API ou tokens no futuro.

Unidades de energia e SUN

Lembre-se: 1 TRX = 1.000.000 SUN. Então, se energyUnitPriceInSun for 50, isso significa 0.000050 TRX por unidade de energia.

Criação implícita de pedidos

Um «pedido» é criado automaticamente sempre que TRX são enviados ao endereço de depósito. Use o hash de transação do depósito para acompanhar o status.

Hora do servidor

Os horários são fornecidos no formato ISO 8601 (UTC). Considere os fusos horários ao compará-los com os horários locais.