查询成交记录

类型: GET

描述: /v4/trade

参数

名称	类型	是否必需	默认值	描述	取值范围
symbol	string	否	N/A	交易对，如不填写则代表所有
bizType	string	否	N/A	业务类型：SPOT、LEVER
orderSide	string	否	N/A	订单方向：BUY、SELL
orderType	string	否	N/A	订单类型：LIMIT、MARKET
orderId	number	否	N/A	订单ID
fromId	number	否	N/A	起始ID
direction	string	否	N/A	查询方向：PREV、NEXT
limit	number	否	20	限制数量，最大100
startTime	number	否	N/A	开始时间（例如：1657682804112）
endTime	number	否	N/A	结束时间

请求示例

cURL

curl --location --request GET 'https://sapi.xt.com/v4/trade?limit=100&bizType=SPOT&startTime=1757779200000&endTime=1760457599999&direction=NEXT' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'validate-algorithms: HmacSHA256' \
--header 'validate-recvwindow: 60000' \
--header 'validate-appkey: xxxxxxxxxx' \
--header 'validate-timestamp: xxxxxxxxxx' \
--header 'validate-signature: xxxxxxxxxx'

说明

此接口用于查询成交记录。支持按交易对、业务类型、订单方向、订单类型、时间范围进行筛选，并支持分页查询。

响应示例

响应

{
  "rc": 0,
  "mc": "string",
  "ma": [{}],
  "result": {
    "hasPrev": true,
    "hasNext": true,
    "items": [
      {
        "symbol": "BTC_USDT", // 交易对
        "tradeId": "6316559590087222001", // 成交ID
        "orderId": "6216559590087220004", // 订单ID
        "orderSide": "BUY", // 订单方向
        "orderType": "LIMIT", // 订单类型
        "bizType": "SPOT", // 业务类型
        "time": 1655958915583, // 成交时间
        "price": "40000", // 成交价格
        "quantity": "1.2", // 成交数量
        "quoteQty": "48000", // 成交金额
        "baseCurrency": "BTC", // 基础币种
        "quoteCurrency": "USDT", // 计价币种
        "takerMaker": "taker", // 吃单方/挂单方

        "deductType": "COUPON", // 手续费抵扣类型：COUPON / PLATFORM_CURRENCY / null
        "deductFee": "0.003", // 使用优惠券时的抵扣费用金额；否则为null

        "fee": "0.5", // 手续费金额（或使用平台币抵扣时的平台币数量）
        "feeCurrency": "USDT", // 手续费币种

        "couponAmount": "0.002", // 使用优惠券时的优惠券金额；否则为null
        "couponCurrency": "usdt" // 使用优惠券时的优惠券币种；否则为null
      }
    ]
  }
}