用户成交记录
获取用户成交历史 (鉴权类型: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"
},
...
]
}
}