跳至主要内容

查詢實時委託單

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

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

HTTP 請求​

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

請求參數​

參數是否必需類型說明
symbolfalsestring合約名稱
baseCoinfalsestring交易幣種
settleCoinfalsestring結算幣種. symbol,baseCoin和settleCoin必傳其中一個. 優先級: symbol > baseCoin > settleCoin
orderIdfalsestring訂單id
orderLinkIdfalsestring用戶自定義訂單Id
orderFilterfalsestringOrder: 普通單, StopOrder: 條件單
limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
cursorfalsestring游標，用於翻頁

響應參數​

參數類型說明
categorystring產品類型
nextPageCursorstring游標，用於翻頁
listarraystring
> symbolstring合約名稱
> orderIdstring訂單ID
> orderLinkIdstring用戶自定義ID
> sidestringSide. Buy,Sell
> orderTypestring訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
> pricestring訂單價格
> ivstring隱含波動率
> qtystring訂單數量
> timeInForcestring執行策略
> orderStatusstring訂單狀態
> lastPriceOnCreatedstring下單時的市場價格
> cancelTypestring訂單被取消類型
> stopOrderTypestring條件單類型
> triggerDirectionstring1: 上升時觸發, 2: 下降時觸發
> triggerBystring觸發價格的觸發類型
> triggerPricestring觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
> cumExecValuestring訂單累計成交價值
> cumExecFeestring訂單累計成交的手續費
> cumExecQtystring訂單累計成交數量
> leavesValuestring訂單剩餘未成交的價值
> leavesQtystring訂單剩餘未成交的數量
> takeProfitstring止盈價格
> stopLossstring止損價格
> tpslModestring止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
> tpLimitPricestring觸發止盈後轉換為限價單的價格
> slLimitPricestring觸發止損後轉換為限價單的價格
> tpTriggerBystring觸發止盈的價格類型
> slTriggerBystring觸發止損的價格類型
> reduceOnlyboolean只減倉. true表明這是只減倉單
> closeOnTriggerboolean觸發後平倉委託. 什麼是觸發後平倉委託?. 該字段對期權無效，一直是""
> smpTypestringSMP執行類型
> smpGroupinteger所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
> smpOrderIdstring觸發此SMP執行的交易對手的 orderID
> createdTimestring訂單創建時間戳 (毫秒)
> updatedTimestring訂單更新時間戳 (毫秒)

請求示例​

GET /contract/v3/private/order/unfilled-orders?symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670564324211
X-BAPI-RECV-WINDOW: 5000

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                "side": "Buy",
                "orderType": "Limit",
                "stopOrderType": "UNKNOWN",
                "price": "26864.40",
                "qty": "0.003",
                "timeInForce": "PostOnly",
                "orderStatus": "New",
                "triggerPrice": "0.00",
                "orderLinkId": "YLxaWKMiHU",
                "createdTime": "1684810640078",
                "updatedTime": "1684810640080",
                "takeProfit": "0.00",
                "stopLoss": "0.00",
                "tpTriggerBy": "UNKNOWN",
                "slTriggerBy": "UNKNOWN",
                "triggerBy": "UNKNOWN",
                "reduceOnly": false,
                "leavesQty": "0.003",
                "leavesValue": "80.5932",
                "cumExecQty": "0.000",
                "cumExecValue": "0",
                "cumExecFee": "0",
                "triggerDirection": 0,
                "cancelType": "UNKNOWN",
                "lastPriceOnCreated": "",
                "iv": "",
                "closeOnTrigger": false,
                "tpslMode": "Full",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": ""
            }
        ],
        "nextPageCursor": "",
        "category": ""
    },
    "retExtInfo": {},
    "time": 1684810643363
}