Get Order List

Request via this endpoint to get your current OCO order list. Items are paginated and sorted to show the latest first. See the Pagination section for retrieving additional entries after the first page.

HTTP REQUEST

GET /api/v3/oco/orders

Example

GET /api/v3/oco/orders?symbol=FRM-USDT&startAt=1701719853540&endAt=1702035882916&pageSize=10&currentPage=1&orderIds=6572fdd65723280007deb5e0,6572fbbea24eca0007c8aaa9

{
  "currentPage": 1,
  "pageSize": 10,
  "totalNum": 4,
  "totalPage": 1,
  "items": [
      {
          "orderId": "6572fdd65723280007deb5e0",
          "symbol": "FRM-USDT",
          "clientOid": "9a05f706a39eff673045b89foco1",
          "orderTime": 1702034902724,
          "status": "NEW"
      },
      {
          "orderId": "6572fbbea24eca0007c8aaa9",
          "symbol": "FRM-USDT",
          "clientOid": "afe2d9deeba49f5ffee1792aoco1",
          "orderTime": 1702034366305,
          "status": "NEW"
      }
  ]
}

API KEY PERMISSIONS

This endpoint requires the General permission.

REQUEST URL

This endpoint support `Spot URL``

REQUEST RATE LIMIT

Spot weight：2

PARAMETERS

Param	Type	Mandatory	Description
pageSize	String	Yes	Size per page, minimum value 10, maximum value 500
currentPage	String	Yes	Page number, minimum value 1
symbol	String	No	Only order information for the specified Symbol is returned
startAt	long	No	Start time (milliseconds)
endAt	long	No	End time (milliseconds)
orderIds	String	No	Specify orderId collection, up to 500 orders

RESPONSES

Param	Description
orderId	order id，Unique order id created by users to identify their orders
symbol	symbol, such as, ETH-BTC
clientOid	client order id
orderTime	Order placement time, milliseconds
status	Order status: NEW: New, DONE: Completed, TRIGGERED: Triggered, CANCELLED: Cancelled