GET

Get a flash order

/api/v1/energy/flash_orders/:order_id

Fetch a single flash order by id. Poll this endpoint to learn the settled outcome of an asynchronous flash order.

Path parameters

Parameter	Type	Description
`order_id`	string	The order id returned when the flash order was created.

Response

{
  "data": {
    "order_id": "ord_9c2b7f0a",
    "status": "COMPLETED",
    "product": "TRON_ENERGY",
    "order_type": "FLASH",
    "amount": 64400,
    "duration_minutes": null,
    "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "customer_price": "1.872",
    "order_total": "2.100",
    "actual_consumed": "1.872",
    "currency": "TRX",
    "created_at": "2026-09-22T12:00:00.000Z",
    "completed_at": "2026-09-22T12:00:35.000Z",
    "failure_reason": null,
    "tx_info": {
      "delegate_tx_hash": "…",
      "reclaim_tx_hash": "…",
      "delegate_time": "…",
      "reclaim_time": "…",
      "resource_address": "T…"
    }
  },
  "request_id": "…"
}

status is one of PENDING, COMPLETED, FAILED, RECONCILIATION_REQUIRED.

Field	Type	Description
`order_total`	string	The total agreed at order time (the estimate), in TRX (decimal string, not SUN).
`actual_consumed`	string \| null	The amount actually charged after settlement, in TRX. It can be less than `order_total` (the flash order consumed less energy than requested). `null` until the order is settled.
`customer_price`	string	The settled price once `COMPLETED` (the estimate before that). In TRX (decimal string, not SUN; 1 TRX = 10^6 SUN).
`currency`	string	Always `TRX`.
`tx_info`	object \| null	Public on-chain delegation/reclaim detail. May be `null` while the order is in-flight.

The tx_info object contains only public, on-chain facts:

Field	Type	Description
`delegate_tx_hash`	string \| null	Delegation transaction hash.
`reclaim_tx_hash`	string \| null	Reclaim transaction hash.
`delegate_time`	string \| null	Delegation time (as reported by the chain).
`reclaim_time`	string \| null	Reclaim time (as reported by the chain).
`resource_address`	string \| null	The address that actually delegated the resource.

Errors

ORDER_NOT_FOUND — the order does not exist or is not yours.