用户成交记录
获取用户成交历史
(鉴权类型:KEYED, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/spot/v1/trades
请求限制
参见 速率限制详细
请求参数
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
symbol | string | 必填 | 交易对(如:BTC_USDT) |
查询单个订单的成交记录的特殊参数
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
order_id | long | 选填 | 订单 id |
解释说明
订单没有成交或者撤销返回的记录将是空列表。
查询所有订单的成交记录的特殊参数
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
offset | int | 选填 | 当前页 从 1 开始 |
limit | int | 选填 | 每页返回数量(取值范围1-100) |
解释说明
只能获取最近200条订单,请求超出200条会返回空响应. (offset
* limit
> 200)
请求示例
https://api-cloud.bitmart.com/spot/v1/trades?symbol=BTC_USDT&limit=10&offset=1
响应详情
字段 | 类型 | 描述 |
---|---|---|
orders | List | 订单列表 |
detail_id | long | 成交 id |
order_id | long | 订单 id |
symbol | string | 交易对 symbol |
create_time | long | 成交时间 (毫秒表示) |
side | string | 订单方向 |
buy =买入 |
||
sell =卖出 |
||
price_avg | string | 成交均价 |
notional | string | 成交价格 |
size | string | 成交数量 |
fees | string | 手续费 |
fee_coin_name | string | 手续费计价币名称 |
exec_type | string | 该账单是maker还是taker产生的。M 表示Maker,T 表示Taker |
返回数据格式示例
{
"message":"OK",
"code":1000,
"trace":"a06a5c53-8e6f-42d6-8082-2ff4718d221c",
"data":{
"current_page":1,
"trades":[
{
"detail_id":256348632,
"order_id":2147484350,
"symbol":"BTC_USDT",
"create_time":1590462303000,
"side":"buy",
"fees":"0.00001350",
"fee_coin_name":"BTC",
"notional":"88.00000000",
"price_avg":"8800.00",
"size":"0.01000",
"exec_type":"M"
},
...
]
}
}