获取用户最近订单记录
获取用户订单列表 (鉴权类型:KEYED, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/spot/v1/orders
请求限制
参见 速率限制详细
请求参数
| 字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | string | 必填 | 交易对(如:BTC_USDT) |
| offset | int | 必填 | 当前页 从 1 开始 |
| limit | int | 必填 | 每页返回数量(取值范围1-100) |
| status | string | 必填 | 状态 |
1=下单失败 |
|||
2=创建订单中 |
|||
3=下单失败,冻结失败 |
|||
4=下单成功,等待成交 |
|||
5=部分成交 |
|||
6=完全成交 |
|||
7=撤销中 |
|||
8=撤销成功 |
|||
9=当前委托(4冻结成功+5部分成交) |
|||
10=6完全成交+8撤销成功 |
解释说明
但是，对于高交易量的成交，强烈建议用户维护自己的当前订单列表，使用 websocket 更新订单状态。每次交易前您必须拉取一次当前订单列表。
只能获取最近500条订单，请求超出500条会返回空响应. (offset * limit > 500)
请求示例
curl https://api-cloud.bitmart.com/spot/v1/orders?symbol=BTC_USDT&status=1&offset=1&limit=100
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| orders | List | 订单列表 |
| order_id | long | 订单ID |
| symbol | string | 交易对(如:BTC_USDT) |
| create_time | long | 时间戳，精确到毫秒 |
| side | string | 类型 |
buy=买入 |
||
sell=卖出 |
||
| type | string | 订单类型 |
limit=限价单 |
||
market=市价单 |
||
| price | string | 委托价格 |
| price_avg | string | 成交均价 |
| size | string | 委托数量（交易货币） |
| notional | string | 买入金额，单位计价币种（特例：市价单卖的时候为交易币种） |
| filled_notional | string | 已成交金额 |
| filled_size | string | 已成交数量 |
| status | string | 状态 |
1=下单失败 |
||
2=创建订单中 |
||
3=下单失败,冻结失败 |
||
4=下单成功,等待成交 |
||
5=部分成交 |
||
6=完全成交 |
||
7=撤销中 |
||
8=撤销成功 |
返回数据格式示例
{
"message":"OK",
"code":1000,
"trace":"70e7d427-7436-4fb8-8cdd-97e1f5eadbe9",
"data":{
"current_page":1,
"orders":[
{
"order_id":2147601241,
"symbol":"BTC_USDT",
"create_time":1591099963000,
"side":"sell",
"type":"limit",
"price":"9000.00",
"price_avg":"0.00",
"size":"1.00000",
"notional":"9000.00000000",
"filled_notional":"0.00000000",
"filled_size":"0.00000",
"status":"4"
}
]
}
}