查詢成交紀錄

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

經典帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

提示

• 單筆訂單可能會有多次成交.
• 您可以通過指定symbol, baseCoin, orderId 字段來查詢。如果您使用多字段組合，系統的查詢優先級如下: orderId > symbol.

HTTP 請求

GET /cloud/trade/v3/execution/list

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 經典帳戶: spot, linear, inverse
symbol	false	string	合約名稱
orderId	false	string	訂單Id
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
> side	string	訂單方向.買： Buy,賣：Sell
> orderPrice	string	訂單價格
> orderQty	string	訂單數量
> leavesQty	string	創建委託未成交數量，現貨交易不支持
> createType	string	訂單創建類型：現貨不返回該欄位
> orderType	string	訂單類型. 市價單：Market,限價單：Limit
> stopOrderType	string	条件单的订单类型。如果该订单不是条件单，则可能返回""或者UNKNOWN. 現貨交易不支持
> execFee	string	交易手續費. 您可以從這裡了解現貨手續費幣種信息
> execId	string	成交Id
> execPrice	string	成交價格
> execQty	string	成交數量
> execType	string	交易類型. 現貨交易不支持
> execValue	string	成交價值. 現貨交易不支持
> execTime	string	成交時間（毫秒）
> isMaker	Bool	是否是 Maker 訂單,true 為 maker 訂單，false 為 taker 訂單
> feeRate	string	手續費率. 現貨交易不支持
> markPrice	string	成交執行時，該 symbol 當時的標記價格. 現貨交易不支持
> closedSize	string	平倉數量
> seq	long	序列號, 用於關聯成交和倉位的更新 同一時間有多筆成交, seq相同 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別 現貨交易沒有該字段
nextPageCursor	string	游標，用於翻頁

---

請求示例

GET /cloud/trade/v3/execution/list?category=spot&symbol=BTCUSDT HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672221263407
X-BAPI-RECV-WINDOW: 5000

響應示例

{
  "result": {
    "list": [
      {
        "symbol": "BTCUSDT",
        "orderId": "1896284562024596224",
        "side": "Buy",
        "orderPrice": "",
        "orderQty": "",
        "leavesQty": "",
        "createType": "",
        "orderType": "Market",
        "stopOrderType": "",
        "execFee": "0.0000000198",
        "execId": "2100000000136808695",
        "execPrice": "83877.09",
        "execType": "",
        "execValue": "",
        "execTime": "1740790735426",
        "isMaker": false,
        "feeRate": "",
        "markPrice": "",
        "closedSize": 0,
        "seq": ""
      },
      {
        "symbol": "BTCUSDT",
        "orderId": "1893483376007480064",
        "side": "Buy",
        "orderPrice": "",
        "orderQty": "",
        "leavesQty": "",
        "createType": "",
        "orderType": "Market",
        "stopOrderType": "",
        "execFee": "0.0000000198",
        "execId": "2100000000135856467",
        "execPrice": "90800",
        "execType": "",
        "execValue": "",
        "execTime": "1740456808031",
        "isMaker": false,
        "feeRate": "",
        "markPrice": "",
        "closedSize": 0,
        "seq": ""
      }
    ],
    "nextPageCursor": "2100000000135856467",
    "category": "spot"
  },
  "retCode": 0,
  "retExtInfo": {},
  "retMsg": "OK",
  "time": 1740966707907
}