查詢成交紀錄

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

支持時間範圍:

• USDT永續, 反向永續, 反向交割: 過去兩年

提示

單筆訂單可能會有多次成交

HTTP 請求

GET /contract/v3/private/execution/list

請求參數

參數	是否必需	類型	說明
symbol	true	string	合約名稱
orderId	false	string	訂單ID
startTime	false	integer	開始時間戳 (毫秒) startTime 和 endTime都不傳入, 則默認返回最近7天的數據 startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天 若不傳startTime，則查詢startTime和startTime+7天的數據 若不傳endTime，則查詢endTime-7天和endTime的數據
endTime	false	integer	結束時間戳 (毫秒)
execType	false	string	成交類型
limit	false	integer	每頁數量限制. [1, 100]. default: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
category	string	產品類型
nextPageCursor	string	游標，用於翻頁
list	array	Object
> symbol	string	合約名稱
> side	string	Buy,Sell
> orderId	string	訂單ID
> orderLinkId	string	用戶自定義訂單iD
> orderPrice	string	訂單價格
> orderQty	string	訂單數量
> orderType	string	訂單類型. 市價單: Market,限價單: Limit
> stopOrderType	string	条件单的订单类型。如果该订单不是条件单，则不会返回任何类型
> execFee	string	交易手續費
> execId	string	成交Id
> execPrice	string	成交價格
> execQty	string	成交數量
> execType	string	交易類型
> execValue	string	成交價值
> feeRate	string	手續費率
> lastLiquidityInd	string	流動性類型. AddedLiquidity, RemovedLiquidity
> isMaker	boolean	是否是maker單
> leavesQty	string	剩餘委託未成交價值
> closedSize	string	平倉數量
> iv	string	隱含波動率
> blockTradeId	string	大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
> markPrice	string	成交執行時，該 symbol 當時的標記價格
> indexPrice	string	成交執行時，該 symbol 當時的指數價格
> markIv	string	標記價格的隱含波動率
> underlyingPrice	string	成交執行時，該 symbol 當時的底層資產價格
> execTime	string	成交時間（毫秒）

請求示例

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

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "ETHUSDT",
                "execFee": "-0.08720013",
                "execId": "208751d8-f70e-4570-a5fd-d208c82af99d",
                "execPrice": "1263.77",
                "execQty": "0.69",
                "execType": "Funding",
                "execValue": "872.0013",
                "feeRate": "-0.0001",
                "lastLiquidityInd": "UNKNOWN",
                "leavesQty": "0.00",
                "orderId": "1673136000-ETHUSDT-592334-Sell",
                "orderLinkId": "",
                "orderPrice": "0.00",
                "orderQty": "0.00",
                "orderType": "UNKNOWN",
                "stopOrderType": "UNKNOWN",
                "side": "Sell",
                "execTime": "1673136000000",
                "closedSize": "0.00",
                "iv": "",
                "blockTradeId": "",
                "markPrice": "",
                "markIv": "",
                "underlyingPrice": "",
                "indexPrice": "",
                "isMaker": false
            }
        ],
        "nextPageCursor": "ZzU3NlU4M1JlLzhFTWkzeW9hemRVcitqUk4wVW9LL21KVTRWV3JPR0tYTG9uTENWSkFvUDJuWk44OVBlNnB0ZjJHTTFwdlJRV0tpZFM0Z0RzUlQ0d2FSbzVRN2lpZ0ZrZmt2UTZuRlJVSHdQSHdoYXUvdDN6aExzOEpmcDNFY2NLc2dYTnRvOXhmTmY3NVNreVgzQ2RKUFZtekptU0NQNU1rOWd5YzZRV1ZDejVFM0t0MGdlMENNc04ybzQvc2JQQ3BVRkQycHU3MFdBK3RqdFlWaVRkMTNGQmZRUUZpaVc4MkE1SnRCT09iZDRNL2FlNDVSMithdU96NTROWGFxcTFucW1MSnJSaTluM29pZm85dHVkNzJMSVQwODk4UTJLbHEybDJ0Uk9UYmtCcU5ScU9zZWRCa2Znc0dwbmNEOWJoaCtnZkRkWjlrMEl6elRmWnljeHZpYXBPWVdzZSs0UEtvdnZ4cTJHQ2JZcm1UQkU3TXFKS01yU1dmaloyT3pVS1psbmVaamh3N3Ntc0hFbEgwckxtQT09",
        "category": ""
    },
    "retExtInfo": {},
    "time": 1673150404910
}