Get Current Orders

Description

Get unfilled futures orders. If no request parameters are specified, you will get all open orders sorted on the creation time in chronological order.

HTTP Request

GET /v3/trade/order/opens

Request Parameters

Parameter	Required	Type	Description
side	No	String	Trade Side, Enumerate: BUY and SELL
symbol	No	String	A trading pair, consisting of two currencies: base currency and quote currency
ordId	No	String	The order ID of the order to be queried
clOrdId	No	String	Client Order ID as assigned by the client
from	No	Long	It is ordId. ID for the query starts at 0 by default.
limit	No	Integer	Pagination size defaults to 10, with a maximum limit of 100.
direct	No	String	Enumerate: PREV, NEXT, The default is NEXT

Response Parameters

Parameter	Type	Description
symbol	String	A trading pair, consisting of two currencies: base currency and quote currency
side	String	Enumerate: BUY and SELL
type	String	Order type; enumerate MARKET, LIMIT, and LIMIT_MAKER
ordId	String	Order ID
clOrdId	String	Client Order ID as assigned by the client
mgnMode	String	Margin Mode, Enumerate: ISOLATED, CROSS
px	String	Price
sz	String	Order size, specifically in Cont
state	String	Order Status: Enumerate NEW, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELED, CANCELED, and REJECTED
source	String	Order Source: Enumerate WEB, APP, API, SMART, WEB_MARGIN, APP_IOS, APP_ANDROID, APP_IOS_MARGIN, APP_ANDROID_MARGIN, API_MARGIN, SMART_MARGIN, WS, WS_MARGIN, GRID, GRID_MARGIN, SYSTEM, COPY_TRADING, TRIGGER, LIQUIDATION, ADL, TRIAL, MARGIN_FL, MARGIN_FL_OFFLINE
reduceOnly	Boolean	Reduce only
timeInForce	String	Enumerate FOK, IOC, and GTC. It is an optional field with GTC by default.
avgPx	String	Average execution price
execQty	String	Cumulative execution amount
execAmt	String	Cumulative execution value
feeCcy	String	Name of the currency used for trading fees
feeAmt	String	Cumulative amount of trading fee
deductCcy	String	Name of the currency used to deduct trading fees
deductAmt	String	Cumulative amount of trading fee deducted
stpMode	String	Enumerate - EXPIRE_TAKER - EXPIRE_MAKER - EXPIRE_BOTH Default is NONE
cTime	String	Order creation time with a UTC timestamp (MS)
uTime	String	Order update time with a UTC timestamp (MS)

Request Example

{
  "symbol": "BTC_USDT_PERP",
  "limit": "100"
}

Response Example

{
    "code": 200,
    "data": [
        {
            "avgPx": "0",
            "cTime": "1719974138337",
            "clOrdId": "11c033ce-8d86-49e2-9503-f21c61de51ee",
            "deductAmt": "0",
            "deductCcy": "0",
            "execAmt": "0",
            "execQty": "0",
            "feeAmt": "0",
            "feeCcy": "",
            "lever": "20",
            "mgnMode": "CROSS",
            "ordId": "331382472938094592",
            "px": "60000",
            "reduceOnly": false,
            "side": "SELL",
            "slPx": "0",
            "slTrgPx": "",
            "slTrgPxType": "",
            "source": "API",
            "state": "NEW",
            "stpMode": "EXPIRE_TAKER",
            "symbol": "BTC_USDT_PERP",
            "sz": "2",
            "timeInForce": "GTC",
            "tpPx": "",
            "tpTrgPx": "",
            "tpTrgPxType": "",
            "type": "LIMIT",
            "uTime": "1719974161941"
        },
        {
            "avgPx": "0",
            "cTime": "1719974138335",
            "clOrdId": "99048dd0-ba62-48a1-88e3-e567640b0414",
            "deductAmt": "0",
            "deductCcy": "0",
            "execAmt": "0",
            "execQty": "0",
            "feeAmt": "0",
            "feeCcy": "",
            "lever": "20",
            "mgnMode": "CROSS",
            "ordId": "331382472929705985",
            "px": "60000",
            "reduceOnly": false,
            "side": "SELL",
            "slPx": "0",
            "slTrgPx": "",
            "slTrgPxType": "",
            "source": "API",
            "state": "NEW",
            "stpMode": "EXPIRE_TAKER",
            "symbol": "BTC_USDT_PERP",
            "sz": "2",
            "timeInForce": "GTC",
            "tpPx": "",
            "tpTrgPx": "",
            "tpTrgPxType": "",
            "type": "LIMIT",
            "uTime": "1719974161941"
        },
        {
            "avgPx": "0",
            "cTime": "1719974138333",
            "clOrdId": "d1dac66e-6728-4f45-b0e7-c24da8456e1e",
            "deductAmt": "0",
            "deductCcy": "0",
            "execAmt": "0",
            "execQty": "0",
            "feeAmt": "0",
            "feeCcy": "",
            "lever": "20",
            "mgnMode": "CROSS",
            "ordId": "331382472921317376",
            "px": "60000",
            "reduceOnly": false,
            "side": "BUY",
            "slPx": "0",
            "slTrgPx": "",
            "slTrgPxType": "",
            "source": "API",
            "state": "NEW",
            "stpMode": "EXPIRE_TAKER",
            "symbol": "BTC_USDT_PERP",
            "sz": "2",
            "timeInForce": "GTC",
            "tpPx": "",
            "tpTrgPx": "",
            "tpTrgPxType": "",
            "type": "LIMIT",
            "uTime": "1719974161941"
        },
        {
            "avgPx": "0",
            "cTime": "1719974138330",
            "clOrdId": "55d7b1e0-fbce-4f86-abfa-d1b0e6d5b053",
            "deductAmt": "0",
            "deductCcy": "0",
            "execAmt": "0",
            "execQty": "0",
            "feeAmt": "0",
            "feeCcy": "",
            "lever": "20",
            "mgnMode": "CROSS",
            "ordId": "331382472908734464",
            "px": "60000",
            "reduceOnly": false,
            "side": "BUY",
            "slPx": "0",
            "slTrgPx": "",
            "slTrgPxType": "",
            "source": "API",
            "state": "NEW",
            "stpMode": "EXPIRE_TAKER",
            "symbol": "BTC_USDT_PERP",
            "sz": "2",
            "timeInForce": "GTC",
            "tpPx": "",
            "tpTrgPx": "",
            "tpTrgPxType": "",
            "type": "LIMIT",
            "uTime": "1719974161941"
        }
    ],
    "msg": ""
}