Get Order List

List your current orders.

HTTP REQUEST

GET /api/v1/orders

Example

GET /api/v1/orders?status=active Submit the request to get all the active orders.

{
  "data" : {
    "totalNum" : 1,
    "currentPage" : 1,
    "pageSize" : 50,
    "totalPage" : 1,
    "items" : [
      {
        "updatedAt" : 1716819743503,
        "timeInForce" : "GTC",
        "id" : "184576812976783360",
        "symbol" : "XBTUSDTM",
        "stp" : "",
        "stopTriggered" : false,
        "remark" : null,
        "filledValue" : "138.374",
        "clientOid" : "10a27086-d6fb-4068-9037-5bc2b6b1a6a8",
        "forceHold" : false,
        "dealSize" : 2,
        "endAt" : 1716819743503,
        "dealValue" : "138.374",
        "hidden" : false,
        "reduceOnly" : false,
        "cancelExist" : false,
        "settleCurrency" : "USDT",
        "type" : "market",
        "value" : "138.3442",
        "closeOrder" : false,
        "stop" : "",
        "createdAt" : 1716819743485,
        "isActive" : false,
        "status" : "done",
        "price" : "0",
        "stopPriceType" : "",
        "leverage" : "4",
        "tags" : "",
        "size" : 2,
        "visibleSize" : 0,
        "stopPrice" : null,
        "postOnly" : false,
        "orderTime" : 1716819743485399462,
        "iceberg" : false,
        "side" : "buy",
        "filledSize" : 2,
		"marginMode": "ISOLATED" // Added field for margin mode: ISOLATED (isolated), CROSS (cross margin).
      }
    ]
  },
  "code" : "200000"
}

API KEY PERMISSIONS

This endpoint requires the General permission.

REQUEST URL

This endpoint support Futures URL

REQUEST RATE LIMIT

Futures weight：2

PARAMETERS

Param	Type	Mandatory	Description
status	String	No	active or done, done as default. Only list orders for a specific status
symbol	String	No	Symbol of the contract
side	String	No	buy or sell
type	String	No	limit, market, limit_stop or market_stop
startAt	long	No	Start time (milisecond)
endAt	long	No	End time (milisecond)
currentPage	long	No	Current request page, The default currentPage is 1
pageSize	long	No	pageSize, The default pageSize is 50, The maximum cannot exceed 1000

RESPONSES

Param	Description
id	Order ID
symbol	Symbol of the contract
type	Order type, market order or limit order
side	Transaction side
price	Order price
size	Order quantity
value	Order value
dealValue	Executed size of funds
dealSize	Executed quantity
stp	self trade prevention
stop	Stop order type (stop limit or stop market)
stopPriceType	Trigger price type of stop orders
stopTriggered	Mark to show whether the stop order is triggered
stopPrice	Trigger price of stop orders
timeInForce	Time in force policy type
postOnly	Mark of post only
hidden	Mark of the hidden order
iceberg	Mark of the iceberg order
leverage	Leverage of the order
forceHold	A mark to forcely hold the funds for an order
closeOrder	A mark to close the position
visibleSize	Visible size of the iceberg order
clientOid	Unique order id created by users to identify their orders
remark	Remark of the order
tags	tag order source
isActive	Mark of the active orders
cancelExist	Mark of the canceled orders
createdAt	Time the order created
updatedAt	last update time
endAt	End time
orderTime	Order create time in nanosecond
settleCurrency	settlement currency
status	order status: “open” or “done”
filledSize	Value of the executed orders
filledValue	Executed order quantity
reduceOnly	A mark to reduce the position size only
avgDealPrice	Average transaction price, forward contract average transaction price = sum (transaction value) / sum (transaction quantity), reverse contract average transaction price = sum (transaction quantity) / sum (transaction value). Transaction quantity = lots * multiplier
marginMode	Margin mode: ISOLATED (isolated), CROSS (cross margin).

This request is paginated.

rder Status and Settlement

Any limit order on the exchange order book is in active status. Orders removed from the order book will be marked with done status. After an order becomes done, there may be a few milliseconds latency before it’s fully settled.

You can check the orders in any status. If the status parameter is not specified, orders of done status will be returned by default.

When you query orders in active status, there is no time limit. However, when you query orders in done status, the start and end time range cannot exceed 24*7 hours. An error will occur if the specified time window exceeds the range. If you specify the end time only, the system will automatically calculate the start time as end time minus 24 hours, and vice versa.

POLLING

For high-volume trading, it is highly recommended that you maintain your own list of open orders and use one of the streaming market data feeds to keep it updated. You should poll the open orders endpoint to obtain the current state of any open order.

If you need to get your recent trade history with low latency, you may query the endpoint Get List of Orders Completed in 24h.