交易記錄

信息

• 如果不傳startTime，只能查詢最近7天的交易數據。如果要查詢一周之前的歷史交易數據，需要傳startTime
• 僅當不傳入orderId, 不傳入toTicketId，但傳入fromTicketId時，返回的結果是以ticketId從小 到大排序；否則，返回的結果以ticketId從大到小排序
• 支持查询过去180天的记录

提示

fromTradeId和toTradeId的規則：

• orderId不傳時

1. 僅fromTradeId傳入, fromTradeId不會被包含在響應中
2. 僅toTradeId傳入, toTradeId不會被包含在響應中
3. 當fromTradeId和toTradeId都傳入, fromTradeId不包含，但是toTradeId會在響應中，如果它的值是存在的tradeId

• orderId不傳時: fromTradeId和toTradeid的值會總是被包含在響應中，如果它們的值是存在的tradeId。

HTTP 請求

GET /spot/v3/private/my-trades

請求參數

參數	是否必須	類型	說明
symbol	false	string	幣對名稱
orderId	false	string	訂單ID
limit	false	string	返回數量限制. [1, 50]. 默认: 50
startTime	false	integer	起始時間戳（毫秒）
endTime	false	integer	結束時間戳（毫秒）
fromTradeId	false	string	從大於此trade ID 開始查詢
toTradeId	false	string	以小於此trade ID 為終點

返回參數

參數	類型	說明
symbol	string	幣對名稱
id	string	與 API 使用無關。 該字段反映了網站交易歷史中“交易ID”的一部分
orderId	string	訂單ID
tradeId	string	交易ID
orderPrice	string	訂單價格
orderQty	string	交易數量
execFee	string	手續費
feeTokenId	string	手續費 Token ID
creatTime	string	撮合引擎中的創建時間
isBuyer	string	0：買方, 1：賣方
isMaker	string	0：掛單, 1：吃單
matchOrderId	string	對手交易者的order_id
makerRebate	string	Maker折扣
executionTime	string	訂單完成時間
blockTradeId	string	Paradigm大宗交易ID

請求示例

curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/my-trades?symbol=BTCUSDT' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1659084253772' \
--header 'X-BAPI-RECV-WINDOW: 5000'

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "id": "1210346127973428992",
                "orderId": "1210073515485572864",
                "tradeId": "2100000000001769786",
                "orderPrice": "20500",
                "orderQty": "0.02",
                "execFee": "0.00002",
                "feeTokenId": "BTC",
                "creatTime": "1659020488738",
                "isBuyer": "0",
                "isMaker": "0",
                "matchOrderId": "1210346015893229312",
                "makerRebate": "0",
                "executionTime": "1659020502026",
                "blockTradeId": ""
            },
            {
                "symbol": "BTCUSDT",
                "id": "1208702504949264128",
                "orderId": "1208702504731160320",
                "tradeId": "2100000000001753197",
                "orderPrice": "20240",
                "orderQty": "0.009881",
                "execFee": "0.000009881",
                "feeTokenId": "BTC",
                "creatTime": "1658824566874",
                "isBuyer": "0",
                "isMaker": "1",
                "matchOrderId": "1208677465155702529",
                "makerRebate": "0",
                "executionTime": "1658824566893",
                "blockTradeId": ""
            }
        ]
    },
    "retExtMap": {},
    "retExtInfo": {},
    "time": 1659084254366
}