v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Fetch order-book items for a market

Gets the volume of trades that are currently being processed by the order book.

get/markets/{currency}/order_book

Path parameters

currency'btcngn' | 'usdtngn' | 'ethngn' | 'xautngn' | 'usdcngn' | 'trxngn' | 'dashngn' | 'ltcngn' | 'xrpngn' | 'solngn' | 'qdxngn' | 'btcusdt' | 'ethusdt' | 'xautusdt' | 'trxusdt' | 'usdcusdt' | 'bnbusdt' | 'dogeusdt' | 'usatusdt' | 'ltcusdt' | 'linkusdt' | 'polusdt' | 'xrpusdt' | 'dotusdt' | 'aaveusdt' | 'dashusdt' | 'shibusdt' | 'xlmusdt' | 'cakeusdt' | 'adausdt' | 'bchusdt' | 'slpusdt' | 'flokiusdt' | 'solusdt' | 'cfxusdt' | 'pepeusdt' | 'bonkusdt' | 'algousdt' | 'wifusdt' | 'tonusdt' | 'rndrusdt' | 'xyousdt' | 'hypeusdt' | 'fartcoinusdt' | 'cngnngn' | 'suiusdt' | 'usdtghs' | 'lskusdt' | 'axcnhusdt' | 'axcnhngn' | 'usdtcngn' | 'qdxusdt' | 'usdtxaf' | 'usdtxof' | 'usdtzar' | 'usdtkes' | 'axsusdt' | 'filusdt' | 'babydogeusdt' | 'oneusdt' | 'xtzusdt' | 'sushiusdt' | 'zilusdt' | 'manausdt' | 'sandusdt' | 'apeusdt' | 'enjusdt' | 'lrcusdt' | 'wldusdt' | 'memeusdt' | 'ordiusdt' | 'ensusdt' | 'arbusdt' | 'myrousdt' | 'magatrumpusdt' | 'jupusdt' | 'blurusdt' | 'coqusdt' | 'fetusdt' | 'aiusdt' | 'bobusdt' | 'bomeusdt' | 'stxusdt' | 'mogusdt' | 'injusdt' | 'mntusdt' | 'beamusdt' | 'mewusdt' | 'gnousdt' | 'wavesusdt' | 'trumpusdt' | 'pnutusdt' | 'ethghs' | 'etcusdt' | 'ethbtc' | 'ltcbtc' | 'bchbtc' | 'cngnusdt' | 'watsonusdt' | 'wlfiusdt' | 'usdtusd' | 'btcghs' | 'nochillusdt' | 'katausdt' | 'slerfusdt' | 'nosusdt' | 'nearusdt' | 'strkusdt' | 'zkusdt' | 'susdt' required

Allowed Currencies 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.

Query parameters

ask_limitstring

Limit the number of returned sell orders. Type: Integer, Allowed values: 1..200. Default to 20.

bids_limitstring

Limit the number of returned buy orders. Type: Integer, Allowed values: 1..200. Default to 20.

Response

200

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Successful",
  "data": {
    "bids": [
      {
        "id": 3115264299823557600,
        "side": "buy",
        "price": "88200000.0000000000000000",
        "state": "NEW_",
        "currency": "btcngn",
        "volume": "0.0005045500000000",
        "ord_type": "LIMIT",
        "avg_price": "0.0000000000000000",
        "origin_volume": "0.0005045500000000",
        "executed_volume": "0.0000000000000000",
        "created_at": "2026-02-20T08:01:17.000Z",
        "updated_at": "2026-02-20T08:01:17.000Z"
      }
    ],
    "asks": [
      {
        "id": 3115096435321958400,
        "side": "sell",
        "price": "96935759.0000000000000000",
        "state": "NEW_",
        "currency": "btcngn",
        "volume": "0.0009248800000000",
        "ord_type": "LIMIT",
        "avg_price": "0.0000000000000000",
        "origin_volume": "0.0009248800000000",
        "executed_volume": "0.0000000000000000",
        "created_at": "2026-02-18T06:57:43.000Z",
        "updated_at": "2026-02-18T06:57:42.000Z"
      }
    ]
  }
}