查詢成交紀錄

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

提示

• 儅execTime相同時,返回會有排序問題，此問題已在優化中, 目前建議依照execId+OrderId+leavesQty進行排序, 如果您想獲取實時成交信息建議使用websocket stream.
• 單筆訂單可能會有多次成交.
• 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢。如果您使用多字段組合，系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin. orderId 和 orderLinkId 優先權較高，只要輸入參數中有這兩個參數，其他輸入參數將被忽略。

HTTP 請求

GET /v5/execution/list

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 spot, linear, inverse, option
symbol	false	string	合約名稱
orderId	false	string	訂單Id
orderLinkId	false	string	用戶自定義訂單id
baseCoin	false	string	交易幣種
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]. 默認: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
category	string	產品類型
list	array	Object
> symbol	string	合約名稱
> orderId	string	訂單Id
> orderLinkId	string	用戶自定義訂單id
> side	string	訂單方向.買： Buy,賣：Sell
> orderPrice	string	訂單價格
> orderQty	string	訂單數量
> leavesQty	string	剩餘委託未成交數量
> createType	string	訂單創建類型 現貨、期權不返回該字段
> orderType	string	訂單類型. 市價單：Market,限價單：Limit
> stopOrderType	string	条件单的订单类型。如果该订单不是条件单，则可能返回""或者UNKNOWN.
> execFee	string	交易手續費. 您可以從這裡了解現貨手續費幣種信息
> execFeeV2	string	價差交易下現貨單腿的交易手續費
> execId	string	成交Id
> execPrice	string	成交價格
> execQty	string	成交數量
> execType	string	交易類型
> execValue	string	成交價值.
> execTime	string	成交時間（毫秒）
> feeCurrency	string	手續費幣種
> isMaker	Bool	是否是 Maker 訂單,true 為 maker 訂單，false 為 taker 訂單
> feeRate	string	手續費率
> tradeIv	string	隱含波動率，僅期權有效
> markIv	string	標記價格的隱含波動率，僅期權有效
> markPrice	string	成交執行時，該 symbol 當時的標記價格
> indexPrice	string	成交執行時，該 symbol 當時的指數價格 僅期權業務有效
> underlyingPrice	string	成交執行時，該 symbol 當時的底層資產價格 僅期權有效
> blockTradeId	string	大宗交易的订单 ID ，使用 paradigm 进行大宗交易时生成的 ID
> closedSize	string	平倉數量
> seq	long	序列號, 用於關聯成交和倉位的更新 同一時間有多筆成交, seq相同 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
> extraFees	string	交易費率。目前，僅針對kyc=Indian用戶或在印尼網站的現貨訂單或在歐盟站的現貨法定貨幣訂單返回此數據。在其他情況下，傳回空字串。字段枚舉: feeType, subFeeType
nextPageCursor	string	游標，用於翻頁

---

請求示例

HTTP

GET /v5/execution/list?category=linear&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672283754132
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_executions(
    category="linear",
    limit=1,
))

Java

import com.bybit.api.client.config.BybitApiConfig;
import com.bybit.api.client.domain.trade.request.TradeOrderRequest;
import com.bybit.api.client.domain.*;
import com.bybit.api.client.domain.trade.*;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET", BybitApiConfig.TESTNET_DOMAIN).newTradeRestClient();
var tradeHistoryRequest = TradeOrderRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").execType(ExecType.Trade).limit(100).build();
System.out.println(client.getTradeHistory(tradeHistoryRequest));

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'xxxxxxxxxxxxxxxxxx',
    secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

client
    .getExecutionList({
        category: 'linear',
        symbol: 'BTCUSDT',
        margin: '10',
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "132766%3A2%2C132766%3A2",
        "category": "linear",
        "list": [
            {
                "symbol": "ETHPERP",
                "orderType": "Market",
                "underlyingPrice": "",
                "orderLinkId": "",
                "side": "Buy",
                "indexPrice": "",
                "orderId": "8c065341-7b52-4ca9-ac2c-37e31ac55c94",
                "stopOrderType": "UNKNOWN",
                "leavesQty": "0",
                "execTime": "1672282722429",
                "feeCurrency": "",
                "isMaker": false,
                "execFee": "0.071409",
                "feeRate": "0.0006",
                "execId": "e0cbe81d-0f18-5866-9415-cf319b5dab3b",
                "tradeIv": "",
                "blockTradeId": "",
                "markPrice": "1183.54",
                "execPrice": "1190.15",
                "markIv": "",
                "orderQty": "0.1",
                "orderPrice": "1236.9",
                "execValue": "119.015",
                "execType": "Trade",
                "execQty": "0.1",
                "closedSize": "0.1",
                "seq": 4688002127,
                "extraFees":""
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672283754510
}