获取用户最近订单记录
获取用户订单列表
(鉴权类型: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"
}
]
}
}