获取用户最近订单记录

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

results matching ""

    No results matching ""