OKX AI LogoOKX AI API
Documentation
Trade

Order List

INFO

Primarily query unfilled or partially filled orders in real-time.

HTTP Request

POST /v1/trade/order-list

NOTE

Don't include trailing slash / at the end of the endpoint. Doing so can result in a “not found” error.

Request Parameters

ParameterRequiredTypeComments
coinfalsestringValues:
  • BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT 1000PEPEUSDT, WLDUSDT, DOGEUSDT,
  • STPTUSDT, SUIUSDT, ADAUSDT, ARBUSDT, XLMUSDT, HIVEUSDT, ONDOUSDT
limitfalseintegerLImit for data size per page. [1, 50]. Default: 10
pagefalseintegerRefer to the next page request parameter

Response Parameters

ParameterTypeComments
statusCodenumber200
resultstringSuccess
messagestringOrder placed successfully

Request Example

GET /v1/trade/order-list  HTTP/1.1
Host: api.okxai.net
X-OKXAI-SIGN: XXXXX
X-OKXAI-API-KEY: XXXXX
Content-Type: application/json

Response Example

{
  "statusCode": 200,
  "result": {
    "data": [
      {
        "id": 8,
        "coin": "BTCUSDT",
        "leverage": "1.00",
        "orderType": "limit",
        "side": "long",
        "entryPrice": "80155.89000000",
        "marginMode": "Isolated",
        "exitPrice": "80155.89000000",
        "size": "0.01300000",
        "tradeType": "open",
        "createdTime": "2025-03-19 15:41:12"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "totalRecords": 1,
      "totalPages": 1
    }
  },
  "message": "OK"
}

Previous

Position List

Next

Market Candle

On this page