查詢活動委托

HTTP 請求

GET /spot/v3/private/order

請求參數

參數	是否必須	類型	說明
orderId	false	string	訂單ID. 當orderLinkId為空時, 則必傳
orderLinkId	false	string	用戶自定義ID. 當orderId為空時, 則必傳
orderCategory	false	integer	訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

返回參數

參數	類型	說明
accountId	string	賬戶ID
symbol	string	幣對名稱
orderLinkId	string	特殊訂單ID，用戶自己生成
orderId	string	訂單ID
orderPrice	string	訂單價格
orderQty	string	訂單數量
execQty	string	成交數量
cummulativeQuoteQty	string	鎖定數量（如果為0，則說明該筆訂單的資金已完成結算）
avgPrice	string	訂單已成交的平均價格
status	string	訂單狀態。可能出現的值為：NEW(新訂單，無成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（訂單被拒絕）.
timeInForce	string	執行策略
orderType	string	訂單類型, LIMIT/MARKET/LIMIT_MAKER
side	string	訂單方向, BUY(買入做多)/SELL(賣出做空)
stopPrice	string	停止價
icebergQty	string	請忽略
createTime	string	撮合引擎中的創建時間
updateTime	string	訂單上次更新的時間戳
isWorking	string	是否生效. 0：未生效, 1：已生效
locked	string	鎖定數量（如果為0，則說明該筆訂單的資金已完成結算）
blockTradeId	string	Paradigm大宗交易ID
cancelType	string	Cancel type. CancelBySmp
smpType	string	SMP執行類型
smpGroup	integer	所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
smpOrderId	string	觸發此SMP執行的交易對手的 orderID

請求示例

Console

curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/order?orderLinkId=spotA0010' \
--header 'X-BAPI-SIGN: 828571067751622ed4191e7e8ee913defccd1f099b9dfb8332a6a05edf799eaf' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1659076396894' \
--header 'X-BAPI-RECV-WINDOW: 5000'

響應示例

Normal order

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "accountId": "533287",
        "symbol": "BTCUSDT",
        "orderLinkId": "spotA0010",
        "orderId": "1210810256551063296",
        "orderPrice": "23500",
        "orderQty": "0.01",
        "execQty": "0",
        "cummulativeQuoteQty": "0",
        "avgPrice": "0",
        "status": "NEW",
        "timeInForce": "GTC",
        "orderType": "LIMIT",
        "side": "SELL",
        "stopPrice": "0.0",
        "icebergQty": "0.0",
        "createTime": "1659075830464",
        "updateTime": "1659075830497",
        "isWorking": "1",
        "locked": "0.01",
        "blockTradeId": "",
        "cancelType": "UNKNOWN"
        "smpGroup": 0,
        "smpOrderId": "",
        "smpType": "None"
    },
    "retExtMap": {},
    "retExtInfo": {},
    "time": 1659076397365
}

Stop order

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "accountId": "533287",
        "symbol": "BTCUSDT",
        "orderLinkId": "testSpot_25",
        "orderId": "1261611660550946304",
        "orderPrice": "17000",
        "orderQty": "0.1",
        "status": "ORDER_NEW",
        "timeInForce": "GTC",
        "orderType": "LIMIT",
        "side": "BUY",
        "stopPrice": "0.0",
        "icebergQty": "0.0",
        "createTime": "1665131829743",
        "updateTime": "1665131829743",
        "isWorking": "1",
        "executedOrderId": "1261611660550946305",
        "triggerPrice": "22000",
        "orderCategory": 1
    },
    "retExtMap": {},
    "retExtInfo": {},
    "time": 1665131916562
}