查詢成交紀錄 (半年)

獲取用戶成交紀錄，返回結果按execTime降序排列

提示

• 單筆訂單可能會有多次成交
• 該接口支持查詢半年內數據

HTTP 請求

POST /unified/v3/private/execution/list

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. linear,option
symbol	false	string	合約名稱
orderId	false	string	訂單Id
orderLinkId	false	string	用戶自定義訂單id
baseCoin	false	string	交易幣種. 僅對option有效. 若不傳，則返回所有類型的交易幣種數據
startTime	false	integer	開始時間戳 (毫秒)
endTime	false	integer	結束時間戳 (毫秒)
execType	false	string	成交類型
direction	false	string	prev: 前一頁, next: 後一頁. 默認: next
limit	false	integer	每頁數量限制. [1, 100]. 默認: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
category	string	產品類型. linear,option
list	array	Object
> symbol	string	合約名稱
> orderId	string	訂單Id
> orderLinkId	string	用戶自定義訂單id
> side	string	訂單方向. Buy,Sell
> orderPrice	string	訂單價格
> orderQty	string	訂單數量
> leavesQty	string	剩餘委託未成交數量，如果訂單被取消了，則 leavesQty 會返回為 0
> orderType	string	訂單類型. 市價單: Market,限價單: Limit
> stopOrderType	string	条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
> execFee	string	交易手續費
> execId	string	成交Id
> execPrice	string	成交價格
> execQty	string	成交數量
> execType	string	交易類型
> execValue	string	成交價值
> execTime	number	成交時間（毫秒）
> feeRate	string	手續費率
> blockTradeId	string	大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
nextPageCursor	string	游標，用於翻頁

請求示例

GET /unified/v3/private/execution/list?category=linear&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672020216382
X-BAPI-RECV-WINDOW: 5000

響應示例

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "nextPageCursor": "2203%3A0%2C2203%3A0",
        "category": "option",
        "list": [
        {
            "orderType": "Market",
            "symbol": "ETH-30DEC22-700-C",
            "orderLinkId": "",
            "side": "Sell",
            "orderId": "cc8012bc-ddc1-443c-8dd9-88cfb946d3b0",
            "leavesQty": "0.0000",
            "execTime": 1672018465365,
            "execFee": "0.03656010",
            "feeRate": "0.000300",
            "execId": "f4309658-62be-5f2b-b262-852909c45bba",
            "blockTradeId": "",
            "execPrice": "498.00000000",
            "lastLiquidityInd": "TAKER",
            "orderQty": "0.1000",
            "orderPrice": "496.50000000",
            "execValue": "49.80000000",
            "execType": "Trade",
            "execQty": "0.1000"
        }
    ]
},
    "retExtInfo": {},
    "time": 1672019908409
}