跳到主要内容

查询成交记录

类型: GET 描述: /v4/trade

参数

名称类型是否必需默认值描述取值范围
symbolstringN/A交易对,如不填写则代表所有
bizTypestringN/A业务类型:SPOTLEVER
orderSidestringN/A订单方向:BUYSELL
orderTypestringN/A订单类型:LIMITMARKET
orderIdnumberN/A订单ID
fromIdnumberN/A起始ID
directionstringN/A查询方向:PREVNEXT
limitnumber20限制数量,最大100
startTimenumberN/A开始时间(例如:1657682804112
endTimenumberN/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
}
]
}
}