Get Order

Returns full details for a single order, including the fills array with on-chain transaction data and verification status for each provider execution.

GET/api/v1/orders/:idRequires authentication
Requires view_orders permission

Path parameters

idstringREQUIRED
Order UUID

Request examples

curl https://merx.exchange/api/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "X-API-Key: your_api_key"

Response

200Full order with fills
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "FILLED",
  "resource_type": "ENERGY",
  "order_type": "MARKET",
  "amount": 100000,
  "duration_sec": 86400,
  "target_address": "TKVSaJQDWeKFSEXmA5ygozDhrq1RLNqxAP",
  "max_price_sun": 40,
  "total_cost_sun": 3200000,
  "total_fee_sun": 0,
  "fills": [
    {
      "provider": "sohu",
      "amount": 100000,
      "price_sun": 32,
      "cost_sun": 3200000,
      "tx_id": "a1b2c3d4e5f6...",
      "status": "CONFIRMED",
      "verified": true,
      "tronscan_url": "https://tronscan.org/#/transaction/a1b2c3d4e5f6..."
    }
  ],
  "created_at": "2026-03-29T12:05:00.000Z",
  "filled_at": "2026-03-29T12:05:03.000Z"
}

Response fields

idstringOrder UUID
statusstringPENDING, EXECUTING, FILLED, or FAILED
resource_typestringENERGY or BANDWIDTH
order_typestringMARKET, LIMIT, PERIODIC, or BROADCAST
amountnumberRequested resource amount
duration_secnumberRental duration in seconds
target_addressstringReceiving TRON address
total_cost_sunnumber | nullTotal cost in SUN (set after fill)
total_fee_sunnumber | nullFee charged in SUN (currently 0 for all users)
fillsFill[]Array of individual provider executions
created_atstringISO 8601 creation timestamp
filled_atstring | nullISO 8601 completion timestamp

Fill object

Each entry in the fills array represents a single provider execution. For BROADCAST orders, there may be multiple fills from different providers.

Fill fields

providerstringREQUIRED
Provider that executed this fill
amountnumberREQUIRED
Resource units delivered in this fill
price_sunnumberREQUIRED
Price per unit in SUN
cost_sunnumberREQUIRED
Total cost of this fill in SUN
tx_idstringREQUIRED
On-chain transaction hash
statusstringREQUIRED
CONFIRMED or FAILED
verifiedbooleanREQUIRED
Whether delegation was verified on-chain
tronscan_urlstringREQUIRED
Direct link to the transaction on TronScan
INFO
The verified field indicates whether the delegation-verifier service has confirmed the resource delegation on-chain. Fills may briefly show verified as false while awaiting chain confirmation.
404Order not found
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Order not found"
  }
}