List Orders

Returns a paginated list of orders for the authenticated account. Filter by status and control pagination with limit and offset.

GET/api/v1/ordersRequires authentication

Requires view_orders permission

Query parameters

statusstringOPTIONAL

Filter orders by statusOne of: PENDINGEXECUTINGFILLEDFAILED

limitnumberOPTIONAL

Number of orders to returnDefault: 30Maximum 100

offsetnumberOPTIONAL

Number of orders to skip for paginationDefault: 0

Request examples

curl "https://merx.exchange/api/v1/orders?status=FILLED&limit=10" \
  -H "X-API-Key: your_api_key"

Response

200Paginated order list

{
  "orders": [
    {
      "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,
      "created_at": "2026-03-29T12:05:00.000Z",
      "filled_at": "2026-03-29T12:05:03.000Z"
    }
  ],
  "total": 1
}

Response fields

ordersOrder[]Array of order objects

totalnumberTotal number of orders matching the filter

401Missing or invalid API key

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}