跳至主要内容

訂單列表

HTTP 請求

GET /spot/v3/private/open-orders

請求參數

參數是否必須類型說明
symbolfalsestring幣對名稱
orderIdfalsestring通過指定訂單ID返回比這個orderId小的訂單,可以用來分頁
limitfalsestring返回數量限制. [1, 500]. 默認: 500
orderCategoryfalseinteger訂單類型. 默認為0:普通訂單; 1止盈止損訂單,若是止盈止損則必傳

返回參數

參數類型說明
accountIdstring賬戶ID
symbolstring幣對名稱
orderLinkIdstring特殊訂單ID,用戶自己生成
orderIdstring訂單ID
orderPricestring訂單價格
orderQtystring訂單數量
execQtystring成交數量
cummulativeQuoteQtystring鎖定數量(如果為0,則說明該筆訂單的資金已完成結算)
avgPricestring訂單已成交的平均價格
statusstring訂單狀態。可能出現的值為:NEW(新訂單,無成交)、PARTIALLY_FILLED(部分成交)、FILLED(全部成交)、CANCELED(已取消)和REJECTED(訂單被拒絕).
timeInForcestring執行策略
orderTypestring訂單類型, LIMIT/MARKET/LIMIT_MAKER
sidestring買賣方向. BUY:買入, SELL:賣出 |
stopPricestring停止價
icebergQtystring請忽略
createTimenumber撮合引擎中的創建時間
updateTimenumber訂單上次更新的時間戳
isWorkingstring是否生效. 0:未生效, 1:已生效
orderCategoryinteger訂單種類. 0:普通單; 1:止盈止損單. 止盈止損單有這個字段
triggerPricestring觸發價格. 止盈止損單有這個字段
blockTradeIdstringParadigm大宗交易ID
cancelTypestringCancel type. CancelBySmp
smpTypestringSMP執行類型
smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
smpOrderIdstring觸發此SMP執行的交易對手的 orderID

請求示例

curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/open-orders?symbol=BTCUSDT' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1659081676022' \
--header 'X-BAPI-RECV-WINDOW: 5000'

響應示例

{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"accountId": "533287",
"symbol": "BTCUSDT",
"orderLinkId": "spotx004",
"orderId": "1210858291884732160",
"orderPrice": "23500",
"orderQty": "0.02",
"execQty": "0",
"cummulativeQuoteQty": "0",
"avgPrice": "0",
"status": "NEW",
"timeInForce": "GTC",
"orderType": "LIMIT_MAKER",
"side": "SELL",
"stopPrice": "0.0",
"icebergQty": "0.0",
"createTime": 1659081556722,
"updateTime": 1659081556740,
"isWorking": "1"
"blockTradeId": "",
"cancelType": "UNKNOWN"
"smpGroup": 0,
"smpOrderId": "",
"smpType": "None"
}
]
},
"retExtInfo": {},
"time": 1659081570356
}