查询订单记录

查询订单记录 (鉴权类型:KEYED, 参见接口权限)

请求格式

GET https://api-cloud.bitmart.com/contract/v1/ifcontract/userOrders

请求限制

参见 速率限制详细

请求参数

参数 类型 是否必须 描述
contractID long 合约 ID
offset int 偏移量
size int 请求数量, 如果 size 不传或 size 为 0, 系统最多返回 60 条
status int 订单状态
0=全部
1=申报中
2=委托中
3=申报中和委托中
4=完成

解释说明

请求示例

curl https://api-cloud.bitmart.com/contract/v1/ifcontract/userOrders?contractID=1&offset=0&size=0&status=0

响应详情

字段 类型 描述
order_id long 订单 ID
contract_id long 合约 ID
price string 订单价格
vol string 订单量
done_avg_price string 成交均价
done_vol string 成交量
way int 订单方向
1:开多
2:平空
3:平多
4:开空
category int 订单类型
1:限价单
2:市价单
make_fee string make 手续费
take_fee string take 手续费
origin string 来源
created_at string 创建时间
finished_at string 结束时间
status int 状态
1=申报中
2=委托中,表示订单已经进撮合队列,订单信息中的 done_vol 表示订单成交部分,只要 done_vol 不为 0 就表示订单有成交;
4:完成
errno int 订单结束的原因
1=用户取消
2=超时 (暂时没有用)
3=用户资产不够,转撤销
4=破产委托结束
5=系统部分转撤销
6=部分平仓导致的部分转撤销
7=自动减仓导致的部分转撤销
8=盈利补偿导致的部分转撤销(暂时没有用)
9=仓位错误导致的部分转撤销
10=类型非法
11=反方向订单存在

解释说明

返回数据格式示例

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
    "orders": [
      {
        "order_id": 10284160,
        "contract_id": 1,
        "price": "8",
        "vol": "4",
        "done_avg_price": "0",
        "done_vol": "0",
        "way": 1,
        "category": 1,
        "open_type": 2,
        "make_fee": "0",
        "take_fee": "0",
        "origin": "",
        "created_at": "2018-07-17T07:24:13.410507Z",
        "finished_at": null,
        "status": 2,
        "errno": 0
      }
    ]
  }
}

results matching ""

    No results matching ""