Sign in

v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Create a sell or buy order

Create a sell or buy order for the authenticated user or a subaccount tethered to authenticated user.

post/users/{user_id}/orders

Path parameters

user_idstring required

The User ID. Use 'me' for main authenticated user. Use the user_id of Sub-account linked to the authenticated user for performing activity for subaccount.

Request body

market'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. Market in which the order to be placed in. 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.

side'buy' | 'sell'

Required. Allowed values: buy, sell.

ord_type'limit' | 'market'

Optional: Allowed values: limit and market, defaults to limit if left empty.

pricestring

Required if ord_type is limit. It should be left blank for market ord_type.

volumestring

Required.

Response

200

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Successful",
  "data": {
    "id": "d74c937eda014e72b78c181f95a761c5",
    "market": {
      "id": "btcusdt",
      "base_unit": "BTC",
      "quote_unit": "USDT"
    },
    "side": "buy",
    "price": {
      "unit": "USDT",
      "amount": "61000.0000000000000000"
    },
    "volume": {
      "unit": "BTC",
      "amount": "0.0000500000000000"
    },
    "status": "wait",
    "user": {
      "id": "24rhpmow",
      "sn": "Qw1os7uj7",
      "email": "test@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": "USDT",
      "amount": "0E-16"
    },
    "origin_volume": {
      "unit": "BTC",
      "amount": "0.0000500000000000"
    },
    "executed_volume": {
      "unit": "BTC",
      "amount": "0.0000000000000000"
    },
    "trades_count": "0",
    "created_at": "2026-02-23T10:47:10.148Z",
    "updated_at": "2026-02-23T10:47:10.000Z"
  }
}