查詢成交紀錄

獲取用戶成交紀錄，返回結果按execTime降序排列。但是，對於經典帳戶現貨交易，返回結果按execId降序排列

統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

提示

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

信息

• 經典帳戶現貨支持查詢過去180天的成交紀錄
• 統一帳戶(linear, spot, option)支持查詢過去730天的歷史成交紀錄

HTTP 請求

GET /v5/execution/list

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 統一帳戶: spot, linear, inverse, option 經典帳戶: spot, linear, inverse
symbol	false	string	合約名稱
orderId	false	string	訂單Id
orderLinkId	false	string	用戶自定義訂單id. 經典帳戶不支持該字段查詢
baseCoin	false	string	交易幣種. 統一帳戶(反向)和經典帳戶不支持該字段查詢
startTime	false	integer	開始時間戳 (毫秒) 經典帳戶的現貨: 支持時間範圍是180天 其他: 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	訂單創建類型 統一帳戶: 僅作用於category=linear 或 inverse 經典帳戶: 總是返回"" 現貨、期權不返回該字段
> orderType	string	訂單類型. 市價單：Market,限價單：Limit
> stopOrderType	string	条件单的订单类型。如果该订单不是条件单，则可能返回""或者UNKNOWN. 經典帳戶現貨交易不支持
> execFee	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來做唯一性識別 經典帳戶下現貨交易沒有該字段
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: XXXXX
X-BAPI-TIMESTAMP: 1672283754132
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
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: 'apikey',
    secret: 'apisecret',
});

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
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672283754510
}