跳至主要内容

查詢成交紀錄 (兩年)

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

提示

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

HTTP 請求

GET /contract/v3/private/copytrading/execution/list

請求參數

參數是否必需類型說明
symboltruestring合約名稱
orderIdfalsestring訂單ID
orderLinkIdfalsestring用戶自定義訂單iD
startTimefalseinteger開始時間戳 (毫秒)
endTimefalseinteger結束時間戳 (毫秒)
execTypefalsestring成交類型
limitfalseinteger每頁數量限制. [1, 100]. default: 50
cursorfalsestring游標,用於翻頁,需要對返回的游標字符串進行urlencode

響應參數

參數類型說明
nextPageCursorstring游標,用於翻頁
listarrayObject
> symbolstring合約名稱
> sidestringBuy,Sell
> orderIdstring訂單ID
> orderLinkIdstring用戶自定義訂單iD
> orderPricestring訂單價格
> orderQtystring訂單數量
> orderTypestring訂單類型. 市價單: Market,限價單: Limit
> execFeestring交易手續費
> execIdstring成交Id
> execPricestring成交價格
> execQtystring成交數量
> execTypestring交易類型
> execValuestring成交價值
> feeRatestring手續費率
> lastLiquidityIndstring流動性類型. AddedLiquidity, RemovedLiquidity, LiquidityIndNA
> isMakerboolean是否是maker單
> leavesQtystring剩餘委託未成交價值
> closedSizestring平倉數量
> markPricestring成交執行時,該 symbol 當時的標記價格
> execTimestring成交時間(毫秒)

請求示例

GET /contract/v3/private/copytrading/execution/list?symbol=XRPUSDT&execType=Funding HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1678788154878
X-BAPI-RECV-WINDOW: 5000

響應示例

{
"retCode": 0,
"retMsg": "success",
"result": {
"nextPageCursor": "0o+MpbbRsIrLhRXdulAiDPRZFkidzCCKmEOQR4TzFIYyq1tofpJ/bOX92Vn8uwRBSEUuSxC/9jnLZs7oFLgcMQ==",
"list": [
{
"symbol": "XRPUSDT",
"side": "Buy",
"orderId": "1678780800-XRPUSDT-1019213-Buy",
"orderLinkId": "",
"orderPrice": "0.0000",
"orderQty": "0",
"orderType": "UNKNOWN",
"execFee": "0.003679",
"execId": "73729a92-caf5-4911-8e85-5194dd2ee1c5",
"execPrice": "0.3679",
"execQty": "100",
"execType": "Funding",
"execValue": "36.79",
"feeRate": "0.0001",
"lastLiquidityInd": "LiquidityIndNA",
"isMaker": false,
"leavesQty": "0",
"closedSize": "0",
"markPrice": "0.3679",
"execTime": "1678780800000"
}
]
},
"retExtInfo": {},
"time": 1678788155282
}