Sign in

v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Get all orders

Fetch all orders tethered to the authenticated user (/me) or a sub account (/user_id) i.e. user_id_or_reference can either be 'me' for a merchant order and for sub-account linked to a merchant, it refers to the sub-account id.

get/users/{user_id}/orders?market={market}&state={state}&order_by=desc

Path parameters

user_idstring required

The User ID. Use 'me' if fetching wallets of main authenticated user, use the user_id if fetching for Sub-account linked to the authenticated user.

marketstring required

Optional. Allowed values: qdxusdt, btcusdt, btcngn, ethngn, qdxngn, xrpngn, dashngn, ltcngn, usdtngn, btcghs, usdtghs, trxngn, dogeusdt, bnbusdt, maticusdt, safemoonusdt, aaveusdt, shibusdt, dotusdt, linkusdt, cakeusdt, xlmusdt, xrpusdt, ltcusdt, ethusdt, trxusdt, axsusdt, wsgusdt, afenusdt, blsusdt, dashusdt.

state'done' | 'wait' | 'cancel' | 'partial_active' | 'pending_cancel' | 'expired' | 'partially_filled_before_cancelled' required

Optional. Allowed values: done, wait, cancel. Defaults to done if not specified.

order_by'asc' | 'desc' required

Optional. Allowed values: asc, desc. defaults to asc if not specified.

Response

200

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Successful",
  "data": [
    {
      "id": "b16b0fed0b0f4ca09cdb72648d839259",
      "market": {
        "id": "trxusdt",
        "base_unit": "TRX",
        "quote_unit": "USDT"
      },
      "side": "buy",
      "price": {
        "unit": "TRX",
        "amount": "0.0000000000000000"
      },
      "volume": {
        "unit": "USDT",
        "amount": "0"
      },
      "status": "done",
      "user": {
        "id": "24rhpmow",
        "sn": "Qw1os7uj7",
        "email": "test123@gmail.com",
        "first_name": "test",
        "last_name": "tester",
        "display_name": "Adigun Efon Exchange",
        "created_at": "2026-02-09T13:22:14.000Z",
        "updated_at": "2026-02-13T10:45:42.000Z"
      },
      "order_type": "limit",
      "avg_price": {
        "unit": "TRX",
        "amount": "0.2803200000000000"
      },
      "origin_volume": {
        "unit": "USDT",
        "amount": "2.0000000000000000"
      },
      "executed_volume": {
        "unit": "USDT",
        "amount": "7.1347031900000000"
      },
      "trades_count": "0",
      "created_at": "2026-02-16T07:34:05.000Z",
      "updated_at": "2026-02-16T07:34:05.000Z"
    }
  ]
}