查询成交记录
类型: 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 | 结束时间 |
说明
此接口用于查询成交记录。支持按交易对、业务类型、订单方向、订单类型、时间范围进行筛选,并支持分页查询。
响应示例
响应
{
"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
}
]
}
}