跳至主要内容

查詢實時委託單

實時查詢未成交或部分成交的訂單信息. 若需要查詢更久的訂單紀錄，請使用查詢歷史訂單接口.

提示
  • 當orderId和orderLinkId不傳時，最多返回500條紀錄
  • 返回的結果將以createdTime從新到舊排序.

HTTP 請求​

GET /unified/v3/private/order/unfilled-orders

請求參數​

參數是否必需類型說明
categorytruestring產品類型. linear, option
symbolfalsestring合約名稱
baseCoinfalsestring交易幣種. 若category=option，不傳時，默認返回BTC相關數據
orderIdfalsestring訂單id
orderLinkIdfalsestring用戶自定義訂單Id
orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
directionfalsestring翻頁方向. prev: 向前翻頁, next: 向後翻頁. 默認: next
limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
cursorfalsestring游標，用於翻頁

響應參數​

參數類型說明
categorystring產品類型
nextPageCursorstring游標，用於翻頁
listarrayObject
> orderIdstring訂單Id
> orderLinkIdstring用戶自定義ID
> blockTradeIdstringParadigm大宗交易ID
> symbolstring合約名稱
> ivstring隱含波動率. linear沒有該字段
> pricestring訂單價格
> qtystring訂單數量
> sidestring方向. Buy,Sell
> orderStatusstring訂單狀態
> orderTypestring訂單類型. Market,Limit
> stopOrderTypestring條件單類型. option沒有該字段
> cumExecValuestring訂單累計成交價值
> cumExecFeestring訂單累計成交的手續費
> cumExecQtystring訂單累計成交數量
> tpTriggerBystring觸發止盈的價格類型. option沒有該字段
> slTriggerBystring觸發止損的價格類型. option沒有該字段
> timeInForcestring執行策略
> basePricestring當前市價，用於條件單
> triggerBystring觸發價格的觸發類型. option沒有該字段
> triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格. option沒有該字段
> leavesQtystring訂單剩餘未成交的數量
> reduceOnlyboolean只減倉. true表明這是只減倉單
> closeOnTriggerboolean觸發後平倉委託. option沒有該字段
> takeProfitstring止盈價格. option沒有該字段
> stopLossstring止損價格. option沒有該字段
> orderIMstring訂單初始保證金. 組合保證金模式下，該字段返回空字符串
> createdTimenumber創建訂單的時間戳 (毫秒)
> updatedTimenumber訂單更新的時間戳 (毫秒)

請求示例​

GET /unified/v3/private/order/unfilled-orders?category=option&baseCoin=BTC HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1673079658059
X-BAPI-RECV-WINDOW: 5000

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417%2Cd00b5b7b-4e05-4a12-a81c-8afb6ddf76bc%3A1673079539417",
        "category": "linear",
        "list": [
            {
                "symbol": "MATICUSDT",
                "orderType": "Limit",
                "orderLinkId": "",
                "orderId": "d00b5b7b-4e05-4a12-a81c-8afb6ddf76bc",
                "stopOrderType": "UNKNOWN",
                "orderStatus": "New",
                "takeProfit": "",
                "cumExecValue": "0.00000000",
                "blockTradeId": "",
                "price": "1.00000000",
                "createdTime": 1673079539417,
                "tpTriggerBy": "UNKNOWN",
                "timeInForce": "PostOnly",
                "basePrice": "",
                "updatedTime": 1673079539426,
                "side": "Sell",
                "triggerPrice": "",
                "cumExecFee": "0.00000000",
                "slTriggerBy": "UNKNOWN",
                "leavesQty": "500.0000",
                "closeOnTrigger": true,
                "cumExecQty": "0.00000000",
                "reduceOnly": true,
                "qty": "500.0000",
                "stopLoss": "",
                "triggerBy": "UNKNOWN",
                "orderIM": ""
            }
        ]
    },
    "retExtInfo": {},
    "time": 1673079551691
}