Navbar
现货 币本位交割合约 币本位永续合约 U本位合约 新版API
简体中文
shell

简介

U本位合约API简介

欢迎使用火必U本位合约 API！ 你可以使用此 API 获得市场行情数据，进行交易，并且管理你的账户。

在文档的右侧是代码示例，目前我们仅提供针对 shell 的代码示例。

你可以通过选择上方下拉菜单的版本号来切换文档对应的 API 版本，也可以通过点击右上方的语言按钮来切换文档语言。

做市商项目

欢迎有优秀 maker 策略交易量大的用户参与长期合约做市商项目。如果您的火必交割合约账户中有折合大于 3 BTC 资产，或火必币本位永续合约账户中有折合大于 3 BTC 资产，或火必U本位合约账户中有大于 100000 USDT 资产，请提供以下信息到 Vip@global-hgroup.com（做市商项目不支持点卡抵扣、VIP、交易量相关活动以及任何形式的返佣活动）:

  1. 提供火必 UID （需不存在返佣关系的 UID）；
  2. 提供其他交易平台 maker 交易量截图证明（比如30天内成交量，或者 VIP 等级等）；

具体的做市商权益政策内容您可以通过：U本位合约做市商权益政策 来了解。

直连专线（Colocation）简介

解决方案架构

火必合约 API 直连专线解决方案是基于 AWS 基础架构构建的。客户端将通过 AWS “PrivateLink”进行连接，通过快速的 AWS 网络连接直接访问 Huobi 的 API 服务，而无需路由到公共网络进行访问。

性能提升

直连专线解决方案的网络延迟比普通外网连接预计低 10ms 至 50ms。实际的性能提升取决于很多因素。

符合条件的客戶

直连专线仅适用于更高级别的做市商。要确认您的帐户是否符合条件，请咨询您的专属客户经理。

配置说明

具体配置可以通过：火必合约直连专线部署来了解。

风险机制说明

阶梯强制平仓

担保资产率是衡量用户资产风险的指标，当担保资产率 ≤ 0%时，用户的仓位将会被系统强制平仓。
建议用户密切关注担保资产率的变动，避免其仓位被强平。
火必合约实行阶梯强平机制，即系统会尝试降低调整系数对应的档位，从而避免仓位被一次性强平。
具体的U本位合约阶梯强制平仓规则您可以通过: 阶梯强制平仓说明 来了解。

风险准备金和分摊机制

风险准备金，用于应付因强平单未能平出而产生的穿仓损失。
当市场行情波动较大，用户强制平仓后，按照接管价格无法成交时，导致亏损范围大于风险准备金。平台采用“分摊”制度，从本期盈利的账户中，每个账户按盈利等比分摊穿仓部分的损失。
具体的U本位合约风险准备金和分摊机制您可以通过: 阶梯强制平仓说明 来了解。

阶梯调整系数

调整系数，为防止用户穿仓而设计。根据持仓张数设定最高五个档位，用户的净持仓量越大，档位越高，风险越大。
具体的U本位合约阶梯调整系数您可以通过: U本位合约阶梯调整系数 来了解。

撮合机制说明

1、撮合系统从订单系统接受订单后，订单进入撮合系统，成交则调用清算服务进行清算，成功交收后，返回撮合结果给订单系统；未成交则加入订单队列等待成交。
2、价格优先，即在买入申报时，买价高的申报优先于买价低的申报；在卖出申报时，卖价低的申报优先于卖价高的申报。
3、时间优先，即在同价位的买价申报情况下，依照申报到服务器时间的先后顺序确定。
4、最高买入申报与最低卖出申报价位相同，以该价格为成交价
5、买入申报价格高于即时揭示的最低卖出申报价格时，以即时揭示的最低卖出申报价格为成交价
6、卖出申报价格低于即时揭示的最高买入申报价格时，以即时揭示的最高买入申报价格为成交价

更新日志

1.6.9 2022年11月10日 【U本位接口新增】

1、新增 账户类型查询

2、新增 账户类型更改

1.6.8 2022年09月01日 【合约接口版本升级】

1、新增【通用】查询用户财务记录(新)

2、新增【通用】组合查询用户财务记录 (新)

3、新增【全仓】组合查询用户历史成交记录(新)

4、新增【全仓】获取历史成交记录(新)

5、新增【逐仓】组合查询用户历史成交记录(新)

6、新增【逐仓】获取历史成交记录(新)

7、新增【全仓】组合查询合约历史委托(新)

8、新增【全仓】获取合约历史委托(新)

9、新增【逐仓】组合查询合约历史委托(新)

10、新增【逐仓】获取合约历史委托(新)

11、新增【通用】获取强平订单(新)

1.6.7 2022年06月24日 【修改使用杠杆的接口限制内容】

1、修改合约批量下单接口【逐仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

2、修改合约批量下单接口【全仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

3、修改合约计划委托下单接口【逐仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

4、修改合约计划委托下单接口【全仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

5、修改合约下单接口【逐仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

6、修改合约下单接口【全仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

7、修改切换杠杆接口【全仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

8、修改切换杠杆接口【逐仓】（请求参数lever_rate字段解除主帐号高倍杠杆协议限制）

1.1.6 2022年04月24日 【新增批量获取聚合行情（V2）接口】

1、新增批量获取聚合行情（V2）接口

1.1.5 2022年02月25日 【新增单向持仓接口的相关内容】

1、新增切换持仓模式（逐仓）接口

2、新增切换持仓模式（全仓）接口

3、修改获取用户账户信息（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

4、修改获取用户账户信息（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

5、修改获取单个子账户资产信息（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

6、修改获取单个子账户资产信息（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

7、修改查询用户账户和持仓信息（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

8、修改查询用户账户和持仓信息（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

9、修改订阅资产变动（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

10、修改订阅资产变动（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

11、修改获取用户持仓信息（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

12、修改获取用户持仓信息（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

13、修改获取单个子账户持仓信息（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

14、修改获取单个子账户持仓信息（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

15、修改订阅持仓变动（逐仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

16、修改订阅持仓变动（全仓）接口（返回参数data中，新增position_mode字段，表示当前合约的持仓模式。）

17、修改合约下单（逐仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

18、修改合约下单（全仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

19、修改合约批量下单（逐仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

20、修改合约批量下单（全仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

21、修改合约计划委托下单（逐仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

22、修改合约计划委托下单（全仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

23、修改跟踪委托下单（逐仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

24、修改跟踪委托下单（全仓）接口（新增选填入参reduce_only，表示是否为只减仓订单，1表示为只减仓订单，0表示为非只减仓订单。该参数在双向持仓模式下无效，在单向持仓模式下不填默认为0。入参offset（开平方向）字段改为非必填，在双向持仓模式下为必填字段，在单向持仓模式下为非必填，填仅可填“both”。）

25、修改获取用户的合约订单信息（逐仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

26、修改获取用户的合约订单信息（全仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

27、修改获取用户的合约订单明细信息（逐仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

28、修改获取用户的合约订单明细信息（全仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

29、修改获取用户的合约当前未成交委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

30、修改获取用户的合约当前未成交委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

31、修改获取用户的合约历史委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

32、修改获取用户的合约历史委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

33、修改组合查询用户历史委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

34、修改组合查询用户历史委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

35、修改获取用户的成交记录（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数trades中，新增reduce_only字段，表示是否为只减仓。）

36、修改获取用户的成交记录（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数trades中，新增reduce_only字段，表示是否为只减仓。）

37、修改组合查询用户成交记录（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数trades中，新增reduce_only字段，表示是否为只减仓。）

38、修改组合查询用户成交记录（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数trades中，新增reduce_only字段，表示是否为只减仓。）

39、修改获取计划委托当前委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

40、修改获取计划委托当前委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

41、修改获取计划委托历史委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

42、修改获取计划委托历史委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

43、修改获取跟踪委托当前委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

44、修改获取跟踪委托当前委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

45、修改获取跟踪委托历史委托（逐仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

46、修改获取跟踪委托历史委托（全仓）接口（trade_type入参新增17买入（单向持仓）和18卖出（单向持仓）枚举值，同时返回参数orders中，新增reduce_only字段，表示是否为只减仓。）

47、修改订阅订单成交数据（逐仓）接口（返回参数新增reduce_only字段，表示是否为只减仓。）

48、修改订阅订单成交数据（全仓）接口（返回参数新增reduce_only字段，表示是否为只减仓。）

49、修改订阅撮合订单成交数据（逐仓）接口（返回参数新增reduce_only字段，表示是否为只减仓。）

50、修改订阅撮合订单成交数据（全仓）接口（返回参数新增reduce_only字段，表示是否为只减仓。）

51、修改订阅计划委托订单变动（逐仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

52、修改订阅计划委托订单变动（全仓）接口（返回参数data中，新增reduce_only字段，表示是否为只减仓。）

1.1.4 2021年12月22日 【新增USDT交割合约接口内容】

1、修改获取合约信息接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：contract_type（合约类型），pair（交易对），business_type（业务类型），delivery_date（合约交割日期，永续无需交割时该字段为空字符串））

2、修改获取合约最高限价和最低限价接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

3、修改获取当前合约总持仓量接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

4、修改查询合约风险准备金和预估分摊比例接口（新增选填入参：business_type（业务类型）。返回参数data下新增字段：business_type（业务类型）、pair（交易对）。）

5、修改获取风险准备金历史数据接口（返回参数data下新增字段：business_type（业务类型）、pair（交易对）。）

6、修改查询平台阶梯调整系数（全仓）接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

7、修改获取平台历史持仓量接口（新增选填入参：contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

8、修改精英账户多空持仓对比-账户数接口（返回参数data下新增字段：business_type（业务类型）、pair（交易对）。）

9、修改精英账户多空持仓对比-持仓量接口（返回参数data下新增字段：business_type（业务类型）、pair（交易对）。）

10、修改获取强平订单接口（新增选填入参：pair（交易对）。返回参数data下的orders里新增字段：business_type（业务类型）、pair（交易对）。）

11、修改查询平台历史结算记录接口（返回参数data下settlement_record内新增字段：business_type（业务类型）、pair（交易对）。）

12、修改获取预估结算价接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

13、修改查询系统交易权限（全仓）接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

14、修改获取行情深度数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

15、修改获取K线数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

16、修改查询阶梯保证金（全仓）接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

17、修改获取市场最优挂单接口（新增选填入参：business_type（业务类型）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。返回参数ticks下新增business_type字段，表示业务类型。）

18、修改获取聚合行情接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

19、修改批量获取聚合行情接口（新增选填入参：business_type（业务类型）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。返回参数data下新增字段：business_type（业务类型）。）

20、修改获取基差数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

21、修改获取标记价格的K线数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

22、修改获取市场最近成交记录接口（新增选填入参，business_type(业务类型)。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。返回参数data下新增字段：business_type（业务类型）。）

23、修改批量获取市场最近成交记录接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

24、修改获取用户的合约账户信息（全仓）接口（在data下新增futures_contract_detail字段，表示支持全仓的所有交割合约的相关字段。然后内部参数和contract_detail内部参数一样。返回参数contract_detail，futures_contract_detail下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

25、修改获取用户的合约持仓信息（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

26、修改查询母账户下的单个子账户资产信息（全仓）接口（在data下新增futures_contract_detail字段，表示支持全仓的所有交割合约的相关字段。然后内部参数和contract_detail内部参数一样。返回参数contract_detail、futures_contract_detail下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

27、修改查询母账户下的单个子账户持仓信息（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

28、修改查询用户财务记录接口（请求参数contract_code支持交割合约代码调用，格式为：BTC-USDT-211225。）

29、修改组合查询财务记录接口（请求参数contract_code支持交割合约代码调用，格式为：BTC-USDT-211225。）

30、修改获取用户的合约下单量限制接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

31、修改获取用户的合约手续费费率接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）、delivery_fee（交割的手续费费率）。）

32、修改获取用户的合约持仓量限制（全仓）接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）、lever_rate（杠杆倍数）、buy_limit_value（多仓持仓价值上限）、sell_limit_value（空仓持仓价值上限）、mark_price（品种标记价格）。）

33、修改获取用户资产和持仓信息（全仓）接口（在data下新增futures_contract_detail字段，表示支持全仓的所有交割合约的相关字段。然后内部参数和contract_detail内部参数一样。返回参数positions和contract_detail，futures_contract_detail下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

34、修改查询用户结算记录（全仓）接口（返回参数需在contract_detail和positions下新增pair字段（交易对）。）

35、修改获取用户当前可用杠杆倍数（全仓）接口（新增选填入参：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

36、修改切换杠杆（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数data下新增字段：business_type（业务类型）、contract_type（合约类型）、pair（交易对）。）

37、修改合约下单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

38、修改合约批量下单（全仓）接口（orders_data下新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

39、修改撤销订单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填）

40、修改全部撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

41、修改获取用户的合约订单信息（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

42、修改获取用户的合约订单明细信息（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

43、修改获取用户的合约当前未成交委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

44、修改获取用户的合约历史委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

45、修改获取用户的合约历史成交记录（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下trades内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

46、修改组合查询合约历史委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

47、修改组合查询历史成交记录（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下trades内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

48、修改合约闪电平仓下单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

49、修改合约计划委托下单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

50、修改合约计划委托撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

51、修改合约计划委托全部撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

52、修改获取计划委托当前委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

53、修改获取计划委托历史委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

54、修改对仓位设置止盈止损订单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

55、修改止盈止损撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

56、修改止盈止损全部撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

57、修改获取止盈止损当前委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

58、修改获取止盈止损历史委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下orders内新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

59、修改查询开仓单关联的止盈止损订单详情（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

60、修改跟踪委托订单下单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

61、修改跟踪委托订单撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

62、修改跟踪委托订单全部撤单（全仓）接口（新增选填入参：contract_type（合约类型）、pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。）

63、修改查询跟踪委托订单当前委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

64、修改查询跟踪委托订单历史委托（全仓）接口（新增选填入参：pair（交易对）。请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时contract_code改为非必填。返回参数data下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

65、修改订阅 KLine 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

66、修改请求 KLine 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

67、修改订阅 Market Depth 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

68、修改订阅 Market Depth增量推送数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

69、修改买一卖一逐笔行情推送接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

70、修改订阅 Market detail 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

71、修改请求 Trade detail 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

72、修改订阅 Trade Detail 数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

73、修改订阅基差数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

74、修改请求基差数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

75、修改订阅强平订单数据（免鉴权）接口（订阅参数外层新增选填字段：business_type（业务类型），与topic同级。返回参数data下新增字段：pair（交易对）、contract_type（合约类型）、business_type（业务类型），新增的字段与contract_code同级。取消订阅时也需要business_type参数）

76、修改订阅合约信息变动数据（免鉴权）接口（订阅参数外层新增选填字段：business_type（业务类型），与topic同级。返回参数data下新增字段：pair（交易对）、contract_type（合约类型）、business_type（业务类型）、delivery_date（合约交割日期）。取消订阅时也需要business_type参数）

77、修改订阅标记价格K线数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

78、修改请求标记价格K线数据接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。）

79、修改订阅资产变动数据（全仓）接口（在data下新增futures_contract_detail字段，表示支持全仓的所有交割合约的相关字段。然后内部参数和contract_detail内部参数一样。返回参数contract_detail、futures_contract_detail下新增字段：contract_type（合约类型）、business_type（业务类型）、pair（交易对）。）

80、修改订阅订单成交数据（全仓）接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数新增字段：business_type（业务类型）、pair（交易对）、contract_type（合约类型），与contract_code同级。）

81、修改订阅持仓变动更新数据（全仓）接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数新增字段：business_type（业务类型）、pair（交易对）、contract_type（合约类型），与contract_code同级。）

82、修改订阅撮合订单成交数据（全仓）接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数新增字段：business_type（业务类型）、pair（交易对）、contract_type（合约类型），与contract_code同级。）

83、修改订阅计划委托订单更新ws推送（全仓）接口（请求参数contract_code支持交割合约代码，格式为BTC-USDT-201101。返回参数新增字段：business_type（业务类型）、pair（交易对）、contract_type（合约类型），与contract_code同级。）

84、修改获取用户的合约持仓量限制（逐仓）接口（新增返参：lever_rate（杠杆倍数）、buy_limit_value（多仓持仓价值上限）、sell_limit_value（空仓持仓价值上限）、mark_price（品种标记价格））

85、新增查询用户所有杠杆持仓量限制（逐仓）接口

86、新增查询用户所有杠杆持仓量限制（全仓）接口

1.1.3 2021年5月17日 【修改：母子账户划转（新增选填入参：client_order_id）。同账号不同保证金账户的划转（新增选填入参：client_order_id）】

1、修改母子账户划转接口（新增选填入参：client_order_id）

2、修改同账号不同保证金账户的划转接口（新增选填入参：client_order_id）

1.1.2 2021年05月12日 【新增：跟踪委托订单接口。】

1、新增跟踪委托订单下单（逐仓）接口

2、新增跟踪委托订单下单（全仓）接口

3、新增跟踪委托订单撤单（逐仓）接口

4、新增跟踪委托订单撤单（全仓）接口

5、新增跟踪委托订单全部撤单（逐仓）接口

6、新增跟踪委托订单全部撤单（全仓）接口

7、新增跟踪委托订单当前委托（逐仓）接口

8、新增跟踪委托订单当前委托（全仓）接口

9、新增跟踪委托订单历史委托（逐仓）接口

10、新增跟踪委托订单历史委托（全仓）接口

1.1.1 2021年04月29日 【修改撤销订单接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。）、修改获取合约订单信息接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。将原来只能查询最近4小时内的撤单信息改为只可以查询最近2小时内的撤单信息。）】

1、修改撤销订单（逐仓）接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。）

2、修改撤销订单（全仓）接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。）

3、修改获取合约订单信息（逐仓）接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。将原来只能查询最近4小时内的撤单信息改为只可以查询最近2小时内的撤单信息。）

4、修改获取合约订单信息（全仓）接口（将原来的 client_order_id 有效时间从24小时改为8小时。超过8小时的订单根据client_order_id将查询不到。将原来只能查询最近4小时内的撤单信息改为只可以查询最近2小时内的撤单信息。）

1.1.0 2021年4月28日 【新增:获取市场最优挂单接口。】

1、新增获取市场最优挂单接口

1.0.9 2021年2月26日 【新增：获取账户总资产估值接口、批量获取合约资金费率接口。修改获取合约最高限价和最低限价接口（支持用户所有入参都不填，接口返回所有当前上市合约的限价数据。）、修改获取市场最近成交记录接口（支持用户所有入参都不填，接口返回所有当前上市合约的最近成交数据；当用户不传入参时， 返参ch值为market.*trade.detail。在返参tick下新增字段：contract_code。）】

1、新增获取账户总资产估值接口

2、新增批量获取合约资金费率接口

3、修改获取合约最高限价和最低限价接口（支持用户所有入参都不填，接口返回所有当前上市合约的限价数据。）

4、修改获取市场最近成交记录接口（支持用户所有入参都不填，接口返回所有当前上市合约的最近成交数据；当用户不传入参时， 返参ch值为market.*trade.detail。在返参data下新增字段：contract_code。）

1.0.8 2021年2月5日【新增：组合查询合约历史委托（全仓和逐仓）、组合查询用户历史成交记录（全仓和逐仓）、组合查询用户财务记录、获取平台阶梯保证金（全仓和逐仓）、批量设置子账户交易权限、批量获取子账户资产信息（全仓和逐仓）。11-14 修改接口，新增字段。】

1、新增组合查询合约历史委托接口（逐仓）

2、新增组合查询合约历史委托接口（全仓）

3、新增组合查询用户历史成交记录接口（逐仓）

4、新增组合查询用户历史成交记录接口（全仓）

5、新增组合查询用户财务记录接口

6、新增获取平台阶梯保证金（逐仓）

7、新增获取平台阶梯保证金（全仓）

8、新增批量设置子账户交易权限接口

9、新增批量获取子账户资产信息接口（逐仓）

10、新增批量获取子账户资产信息接口（全仓）

11、修改获取市场最近成交记录接口（返参data参数下新增quantity，表示成交量（币）。计算公式：成交量（币） = 成交量（张）* 合约面值。返参data参数下新增trade_turnover，表示成交额（计价币种）。计算公式：成交额（计价币种） = 成交量（张）* 合约面值 * 成交价格。）

12、修改批量获取最近的交易记录接口（返参data参数下新增quantity，表示成交量（币）。计算公式：成交量（币） = 成交量（张）* 合约面值。返参data参数下新增trade_turnover，表示成交额（计价币种）。计算公式：成交额（计价币种） = 成交量（张）* 合约面值 * 成交价格。）

13、修改订阅 Trade Detail 数据接口（返参data参数下新增quantity，表示成交量（币）。计算公式：成交量（币） = 成交量（张）* 合约面值。返参data参数下新增trade_turnover，表示成交额（计价币种）。计算公式：成交额（计价币种） = 成交量（张）* 合约面值 * 成交价格。）

14、修改请求 Trade Detail 数据接口（返参data参数下新增quantity，表示成交量（币）。计算公式：成交量（币） = 成交量（张）* 合约面值。返参data参数下新增trade_turnover，表示成交额（计价币种）。计算公式：成交额（计价币种） = 成交量（张）* 合约面值 * 成交价格。）

1.0.7 2021年1月29日 【新增：批量获取聚合行情接口、获取标记价格的 K 线数据、查询用户结算记录（全仓和逐仓）、订阅标记价格 K 线数据（sub）、请求标记价格 K 线数据（req）。7-28 修改接口，新增字段。修改：计划委托订单的订单ID由原本的自然数自增ID 改为长度为 18 位的唯一标识ID。推荐使用下单后返回的 order_id_str（字符串类型的订单 ID），避免发生长度过大而被系统截断的情况。】

1、新增批量获取聚合行情接口

2、新增获取标记价格的 K 线数据接口

3、新增订阅标记价格 K 线数据 WS 接口

4、新增请求标记价格 K 线数据 WS 接口

5、新增查询用户结算记录(逐仓)接口

6、新增查询用户结算记录(全仓)接口

7、修改全部撤单(逐仓)接口（请求参数新增 2 个选填字段:direction，表示买卖方向，不填默认撤销全部。参数可选值为“buy”:买，“sell”:卖。offset，表示开平方向，不填默认撤销全部。参数可 选值为“open”:开仓，“close”:平仓。）

8、修改全部撤单(全仓)接口（请求参数新增 2 个选填字段:direction，表示买卖方向，不填默认撤销全部。参数可选值为“buy”:买，“sell”:卖。offset，表示开平方向，不填默认撤销全部。参数可 选值为“open”:开仓，“close”:平仓。）

9、修改获取合约订单信息(逐仓)接口（返参data中新增real_profit字段，表示真实收益，类型decimal）

10、修改获取合约订单信息(全仓)接口（返参data中新增real_profit字段，表示真实收益，类型decimal）

11、修改获取订单明细信息(逐仓)接口（返回参数中的 data 和 trades 下各新增以下字段:real_profit(真实收益)。同时 trades 下新增每笔成交收益字段：profit（平仓盈亏））

12、修改获取订单明细信息(全仓)接口（返回参数中的 data 和 trades 下各新增以下字段:real_profit(真实收益)。同时 trades 下新增每笔成交收益字段：profit（平仓盈亏））

13、修改获取合约当前未成交委托(逐仓)接口（请求参数新增 2 个选填字段:sort_by，表示排序字段，不填默认按创建时间倒序。参数可选值为“created_at”(按照创建时间倒序)，“update_time”(按照更新时间倒 序)。trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,1:买入 开多,2: 卖出开空,3: 买入平空,4: 卖出平多。 返回参数中的 orders 下新增以下字段:update_time(订单更新时间，单位毫秒)、real_profit(真实收益)。）

14、修改获取合约当前未成交委托(全仓)接口（请求参数新增 2 个选填字段:sort_by，表示排序字段，不填默认按创建时间倒序。参数可选值为“created_at”(按照创建时间倒序)，“update_time”(按照更新时间倒 序)。trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,1:买入 开多,2: 卖出开空,3: 买入平空,4: 卖出平多。 返回参数中的 orders 下新增以下字段:update_time(订单更新时间，单位毫秒)、real_profit(真实收益)。）

15、修改获取合约历史委托(逐仓)接口（返参orders中新增real_profit字段，表示真实收益，类型decimal）

16、修改获取合约历史委托(全仓)接口（返参orders中新增real_profit字段，表示真实收益，类型decimal）

17、修改获取历史成交记录(逐仓)接口（返参trades中新增real_profit字段，表示真实收益，类型decimal）

18、修改获取历史成交记录(全仓)接口（返参trades中新增real_profit字段，表示真实收益，类型decimal）

19、修改订阅订单成交数据(逐仓)接口（返参外层新增real_profit字段，表示真实收益，类型decimal. 返参trade中新增：real_profit字段，表示真实收益、profit字段，表示平仓盈亏。）

20、修改订阅订单成交数据(全仓)接口（返参外层新增real_profit字段，表示真实收益，类型decimal. 返参trade中新增：real_profit字段，表示真实收益、profit字段，表示平仓盈亏。）

21、修改计划委托全部撤单(逐仓)接口（请求参数新增 2 个选填字段:direction，表示买卖方向，不填默认撤销全部。参数可选值为“buy”:买，“sell”:卖。offset，表示开平方向，不填默认撤销全部。参数可 选值为“open”:开仓，“close”:平仓。）

22、修改计划委托全部撤单(全仓)接口（请求参数新增 2 个选填字段:direction，表示买卖方向，不填默认撤销全部。参数可选值为“buy”:买，“sell”:卖。offset，表示开平方向，不填默认撤销全部。参数可 选值为“open”:开仓，“close”:平仓。）

23、修改止盈止损订单全部撤单(逐仓)接口（请求参数新增选填字段:direction，表示买卖方向，不填默认撤销全部）

24、修改止盈止损订单全部撤单(全仓)接口（请求参数新增选填字段:direction，表示买卖方向，不填默认撤销全部）

25、修改查询计划委托当前委托(逐仓)接口（请求参数新增选填字段:trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,1:买入开多,2: 卖出开空,3: 买入平空,4: 卖出平多。）

26、修改查询计划委托当前委托(全仓)接口（请求参数新增选填字段:trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,1:买入开多,2: 卖出开空,3: 买入平空,4: 卖出平多。）

27、修改查询止盈止损订单当前委托(逐仓)接口（请求参数新增选填字段:trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,3: 买入平空,4: 卖出平多。）

28、修改查询止盈止损订单当前委托(全仓)接口（请求参数新增选填字段:trade_type，表示交易类型，不填默认查询全部。参数可选值为 0:全部,3: 买入平空,4: 卖出平多。）

1.0.6 2021年01月12号 【1 新增获取预估结算价接口。2-13 新增止盈止损订单接口。14-35 修改接口,新增字段。 新增【合约策略订单】一级菜单，将本次新增的双向止盈止损相关接口以及原有的计划委托相关接口挪到该菜单下】

1、新增获取预估结算价

2、新增对仓位设置止盈止损订单(逐仓)

3、新增对仓位设置止盈止损订单(全仓)

4、新增止盈止损订单撤单接口(逐仓)

5、新增止盈止损订单撤单接口(全仓)

6、新增止盈止损订单全部撤单接口(逐仓)

7、新增止盈止损订单全部撤单接口(全仓)

8、新增查询止盈止损订单当前委托接口(逐仓)

9、新增查询止盈止损订单当前委托接口(全仓)

10、新增查询止盈止损订单历史委托接口(逐仓)

11、新增查询止盈止损订单历史委托接口(全仓)

12、新增查询开仓单关联的止盈止损订单详情接口(逐仓)

13、新增查询开仓单关联的止盈止损订单详情接口(全仓)

14、修改合约下单接口(逐仓)（新增选填入参：tp_trigger_price（止盈触发价格）、tp_order_price（止盈委托价格）、tp_order_price_type（止盈委托类型）、sl_trigger_price（止损触发价格）、sl_order_price（止损委托价格）、sl_order_price_type（止损委托类型）。）

15、修改合约下单接口(全仓)（新增选填入参：tp_trigger_price（止盈触发价格）、tp_order_price（止盈委托价格）、tp_order_price_type（止盈委托类型）、sl_trigger_price（止损触发价格）、sl_order_price（止损委托价格）、sl_order_price_type（止损委托类型）。）

16、修改合约批量下单接口(逐仓)（在入参orders_data中新增选填参数：tp_trigger_price（止盈触发价格）、tp_order_price（止盈委托价格）、tp_order_price_type（止盈委托类型）、sl_trigger_price（止损触发价格）、sl_order_price（止损委托价格）、sl_order_price_type（止损委托类型）。）

17、修改合约批量下单接口(全仓)（在入参orders_data中新增选填参数：tp_trigger_price（止盈触发价格）、tp_order_price（止盈委托价格）、tp_order_price_type（止盈委托类型）、sl_trigger_price（止损触发价格）、sl_order_price（止损委托价格）、sl_order_price_type（止损委托类型）。）

18、修改获取合约订单信息接口(逐仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

19、修改获取合约订单信息接口(全仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

20、修改获取订单明细信息接口(逐仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

21、修改获取订单明细信息接口(全仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

22、修改获取合约当前未成交委托接口(逐仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

23、修改获取合约当前未成交委托接口(全仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

24、修改获取合约历史委托接口(逐仓)（新增入参：sort_by(表示：排序字段，可选值为“create_date”，“update_time”)。新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),update_time（表示：订单的更新时间）,在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

25、修改获取合约历史委托接口(全仓)（新增入参：sort_by(表示：排序字段，可选值为“create_date”，“update_time”)。新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),update_time（表示：订单的更新时间）,在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

26、修改订阅订单成交数据接口(逐仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

27、修改订阅订单成交数据接口(全仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

28、修改订阅订单撮合数据接口(逐仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

29、修改订阅订单撮合数据接口(全仓)（新增返回参数：is_tpsl(表示是否设置止盈止损，1：是；0：否),在返回参数order_source订单来源新增枚举值（tpsl:止盈止损触发））

30、修改获取计划委托历史委托接口(逐仓)（新增入参：sort_by(表示：排序字段，可选值为“create_date”，“update_time”)。新增返回参数：update_time（表示：订单的更新时间））

31、修改获取计划委托历史委托接口(全仓)（新增入参：sort_by(表示：排序字段，可选值为“create_date”，“update_time”)。新增返回参数：update_time（表示：订单的更新时间））

32、修改获取当前合约总持仓量（在返回参数data中新增trade_volume：最近24小时成交量（张），trade_amount：最近24小时成交量（币）trade_turnover：最近24小时成交额、这三个字段 ）

33、修改订阅Market Detail数据（在返参tick中新增ask表示卖一，bid表示买一。）

34、修改获取合约信息（在返参data下新增delivery_time，表示交割时间（毫秒时间戳））

35、修改订阅合约信息变动（在返参data下新增delivery_time，表示交割时间（毫秒时间戳））

1.0.5 2020年12月18日 【新增：订阅系统状态更新推送的 WebSocket 接口】

1、新增订阅系统状态更新推送的 WebSocket 接口

1.0.4 2020年12月11日 【1-33 新增全仓模式接口。34-60 修改接口,新增字段】

1、新增全仓模式查询平台阶梯调整系数

2、新增全仓模式查询系统划转权限

3、新增全仓模式查询系统交易权限

4、新增全仓模式获取用户账户信息

5、新增全仓模式获取用户持仓信息

6、新增全仓模式查询母账户下所有子账户资产信息

7、新增全仓模式查询单个子账户资产信息

8、新增全仓模式查询单个子账户持仓信息

9、新增全仓模式查询用户当前的划转限制

10、新增全仓模式用户持仓量限制的查询

11、新增全仓模式获取用户资产和持仓信息

12、新增全仓模式查询用户可用杠杆倍数

13、新增全仓模式切换杠杆

14、新增全仓模式合约下单

15、新增全仓模式合约批量下单

16、新增全仓模式撤销订单

17、新增全仓模式全部撤单

18、新增全仓模式获取合约订单信息

19、新增全仓模式获取订单明细信息

20、新增全仓模式获取合约当前未成交委托

21、新增全仓模式获取合约历史委托

22、新增全仓模式获取历史成交记录

23、新增全仓模式闪电平仓下单

24、新增全仓模式合约计划委托下单

25、新增全仓模式合约计划委托撤单

26、新增全仓模式合约计划委托全部撤单

27、新增全仓模式获取计划委托当前委托

28、新增全仓模式获取计划委托历史委托

29、新增全仓模式订阅订单成交数据

30、新增全仓模式订阅资产变动数据

31、新增全仓模式订阅持仓变动更新数据

32、新增全仓模式订阅撮合订单成交数据

33、新增全仓模式订阅计划委托订单变动

34、查询合约信息接口新增字段（新增入参support_margin_mode；返参data中也新增support_margin_mode字段；表示合约支持的保证金模式）

35、查询平台阶梯调整系数新增返回字段（在返参中新增margin_mode字段：表示保证金模式）

36、查询系统状态接口新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

37、获取用户账户信息接口新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

38、查询单个子账户资产信息接口新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

39、查询用户账户和持仓信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

40、查询母账户下所有子账户资产信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

41、获取用户持仓信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

42、获取单个子账户持仓信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

43、查询财务记录接口新增入参字段（新增入参contract_code：表示合约代码）

44、获取订单明细信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

45、获取合约当前未成交委托新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

46、获取合约历史委托新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

47、获取历史成交记录新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

48、获取计划委托当前委托新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

49、获取计划委托历史委托新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

50、获取用户合约划转限制新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

51、获取用户合约持仓量限制新增返回字段（在返参中新增margin_mode字段，表示保证金模式）

52、获取用户当前合约杠杆倍数新增返回字段（在返参中新增margin_mode字段，表示保证金模式）

53、切换杠杆新增返回字段（在返参中新增margin_mode字段，表示保证金模式）

54、订阅订单成交数据新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

55、订阅撮合订单成交数据新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

56、订阅计划委托订单更新新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

57、订阅持仓变动数据新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

58、订阅资产变动数据新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

59、订阅合约信息变动数据新增返回字段（返参中新增support_margin_mode字段，表示合约支持的保证金模式。）

60、获取合约订单信息新增返回字段（在返参中新增margin_account字段：表示保证金账户；以及margin_mode字段：表示保证金模式）

1.0.3 2020年12月2日 【修改获取订单明细信息接口（查询无成交撤单数据时，如果不传“created_at”和“order_type”参数，由原来的只能查询到最近12小时数据，改为只能查询到最近2小时数据）；修改获取合约历史委托接口（查询无成交撤单数据时，由原来的只保留最近24小时数据，改为只保留2小时数据。）】

1、修改获取订单明细信息接口（查询无成交撤单数据时，如果不传“created_at”和“order_type”参数，由原来的只能查询到最近12小时数据，改为只能查询到最近2小时数据）

2、修改获取合约历史委托接口（查询无成交撤单数据时，由原来的只保留最近24小时数据，改为只保留最近2小时数据。）

1.0.2 2020年11月24日 【新增：查询平台历史结算记录；修改：获取强平订单接口新增返参字段，订阅强平订单数据接口新增返参字段】

1、新增查询平台历史结算记录接口

2、获取强平订单接口新增返参字段（返回参数中的 orders 参数下增加以下字段:amount 表示强平数量(币);trade_turnover 表示强平金额）

3、订阅强平订单数据接口新增返参字段（返回参数中的 data 参数下增加以下字段:amount 表示强平数量(币);trade_turnover 表示强平金额。）

1.0.1 2020年10月29日 【修改：切换杠杆成功时 WS 资产接口推送更新信息，切换杠杆成功时 WS 持仓接口推送更新信息】

1、订阅资产接口推送更新（返参event新增事件类型，switch_lever_rate表示切换倍数。在用户切换倍数成功时，需推送一次最新的资产信息，event为switch_lever_rate。）

2、订阅持仓接口推送更新（返参event新增事件类型，switch_lever_rate表示切换杠杆。在用户切换杠杆倍数成功时，需推送一次最新的持仓信息（若用户持仓量为0，则不会触发推送），event 为 switch_lever_rate。）

1.0.0 2020年10月26日14:00(GMT+8)

合约交易接入说明

合约交易接口列表

接口列表

权限类型 接口数据类型 接口模式 请求方法 类型 描述 需要验签
读取 基础信息接口 通用 /linear-swap-api/v1/swap_contract_info GET 【通用】获取合约信息 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_index GET 【通用】获取合约指数信息 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_price_limit GET 【通用】获取合约最高限价和最低限价 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_open_interest GET 【通用】获取当前合约总持仓量 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_risk_info GET 【通用】查询合约风险准备金和预估分摊比例 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_insurance_fund GET 【通用】获取风险准备金历史数据 否
读取 基础信息接口 逐仓 /linear-swap-api/v1/swap_adjustfactor GET 【逐仓】查询平台阶梯调整系数 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_his_open_interest GET 【通用】获取平台历史持仓量 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_elite_account_ratio GET 【通用】精英账户多空持仓对比-账户数 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_elite_position_ratio GET 【通用】精英账户多空持仓对比-持仓量 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_liquidation_orders GET 【通用】获取强平订单 否
读取 基础信息接口 通用 /linear-swap-api/v1/swap_settlement_records GET 【通用】平台历史结算记录 否
读取 基础信息接口 逐仓 /linear-swap-api/v1/swap_api_state GET 【逐仓】查询系统状态 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_funding_rate GET 【通用】获取合约的资金费率 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_batch_funding_rate GET 【通用】批量获取合约资金费率 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_historical_funding_rate GET 【通用】获取合约的历史资金费率 否
读取 市场行情接口 通用 /linear-swap-ex/market/depth GET 【通用】获取行情深度数据 否
读取 市场行情接口 通用 /linear-swap-ex/market/bbo GET 【通用】获取市场最优挂单 否
读取 市场行情接口 通用 /linear-swap-ex/market/history/kline GET 【通用】获取K线数据 否
读取 市场行情接口 通用 /index/market/history/linear_swap_mark_price_kline GET 【通用】获取标记价格的 K 线数据 否
读取 市场行情接口 通用 /linear-swap-ex/market/detail/merged GET 【通用】获取聚合行情 否
读取 市场行情接口 通用 /linear-swap-ex/market/detail/batch_merged GET 【通用】批量获取聚合行情 否
读取 市场行情接口 通用 /v2/linear-swap-ex/market/detail/batch_merged GET 【通用】批量获取聚合行情(V2) 否
读取 市场行情接口 通用 /index/market/history/linear_swap_basis GET 【通用】获取基差数据 否
读取 市场行情接口 通用 /index/market/history/linear_swap_premium_index_kline GET 【通用】获取溢价指数K线数据 否
读取 市场行情接口 通用 /index/market/history/linear_swap_estimated_rate_kline GET 【通用】获取预测资金费率的K线数据 否
读取 市场行情接口 通用 /linear-swap-ex/market/trade GET 【通用】获取市场最近成交记录 否
读取 市场行情接口 通用 /linear-swap-ex/market/history/trade GET 【通用】批量获取最近的交易记录 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_estimated_settlement_price GET 【通用】获取预估结算价 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_ladder_margin GET 【逐仓】获取平台阶梯保证金 否
读取 市场行情接口 通用 /linear-swap-api/v1/swap_cross_ladder_margin GET 【全仓】获取平台阶梯保证金 否
读取 基础信息接口 全仓 /linear-swap-api/v1/swap_cross_adjustfactor GET 【全仓】查询平台阶梯调整系数 否
读取 基础信息接口 全仓 /linear-swap-api/v1/swap_cross_transfer_state GET 【全仓】查询系统划转权限 否
读取 基础信息接口 全仓 /linear-swap-api/v1/swap_cross_trade_state GET 【全仓】查询系统交易权限 否
读取 账户接口 通用 /linear-swap-api/v1/swap_balance_valuation POST 【通用】获取账户总资产估值 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_account_info POST 【逐仓】获取用户的合约账户信息 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_position_info POST 【逐仓】获取用户的合约持仓信息 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_lever_position_limit POST 【逐仓】查询用户所有杠杆持仓量限制 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_available_level_rate POST 【逐仓】查询用户可用杠杆倍数 是
交易 账户接口 通用 /linear-swap-api/v1/swap_sub_auth POST 【通用】批量设置子账户交易权限 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_sub_account_list POST 【逐仓】查询母账户下所有子账户资产信息 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_sub_account_info_list POST 【逐仓】批量获取子账户资产信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_sub_account_info_list POST 【全仓】批量获取子账户资产信息 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_sub_account_info POST 【逐仓】查询母账户下的单个子账户资产信息 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_sub_position_info POST 【逐仓】查询母账户下的单个子账户持仓信息 是
读取 账户接口 通用 /linear-swap-api/v1/swap_financial_record POST 【通用】查询用户财务记录 是
读取 账户接口 通用 /linear-swap-api/v1/swap_financial_record_exact POST 【通用】组合查询用户财务记录 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_user_settlement_records POST 【逐仓】查询用户结算记录 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_user_settlement_records POST 【全仓】查询用户结算记录 是
读取 账户接口 通用 /linear-swap-api/v1/swap_order_limit POST 【通用】获取用户的合约下单量限制 是
读取 账户接口 通用 /linear-swap-api/v1/swap_fee POST 【通用】获取用户的合约手续费费率 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_transfer_limit POST 【逐仓】获取用户的合约划转限制 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_position_limit POST 【逐仓】获取用户的合约持仓量限制 是
读取 账户接口 逐仓 /linear-swap-api/v1/swap_account_position_info POST 【逐仓】获取用户资产和持仓信息 是
交易 账户接口 通用 /linear-swap-api/v1/swap_master_sub_transfer POST 【通用】母子账户划转 是
读取 账户接口 通用 /linear-swap-api/v1/swap_master_sub_transfer_record POST 【通用】获取母账户下的所有母子账户划转记录 是
交易 账户接口 通用 /linear-swap-api/v1/swap_transfer_inner POST 【通用】同账号不同保证金账户的划转 是
读取 账户接口 通用 /linear-swap-api/v1/swap_api_trading_status GET 【通用】获取用户API指标禁用信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_account_info POST 【全仓】获取用户的合约账户信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_position_info POST 【全仓】获取用户的合约持仓信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_sub_account_list POST 【全仓】查询母账户下所有子账户资产信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_sub_account_info POST 【全仓】查询母账户下的单个子账户资产信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_sub_position_info POST 【全仓】查询母账户下的单个子账户持仓信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_transfer_limit POST 【全仓】获取用户的合约划转限制 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_position_limit POST 【全仓】获取用户的合约持仓量限制 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_lever_position_limit POST 【全仓】查询用户所有杠杆持仓量限制 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_account_position_info POST 【全仓】获取用户资产和持仓信息 是
读取 账户接口 全仓 /linear-swap-api/v1/swap_cross_available_level_rate POST 【全仓】获取用户当前合约杠杆倍数 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_switch_position_mode POST 【逐仓】切换持仓模式 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_switch_position_mode POST 【全仓】切换持仓模式 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_order POST 【逐仓】合约下单 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_batchorder POST 【逐仓】合约批量下单 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_switch_lever_rate POST 【逐仓】切换杠杆 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_cancel POST 【逐仓】撤销合约订单 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_cancelall POST 【逐仓】撤销全部合约单 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_order_info POST 【逐仓】获取用户的合约订单信息 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_order_detail POST 【逐仓】获取用户的合约订单明细信息 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_openorders POST 【逐仓】获取用户的合约当前未成交委托 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_hisorders POST 【逐仓】获取用户的合约历史委托 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_hisorders_exact POST 【逐仓】组合查询合约历史委托 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_matchresults POST 【逐仓】获取用户的合约历史成交记录 是
读取 交易接口 逐仓 /linear-swap-api/v1/swap_matchresults_exact POST 【逐仓】组合查询用户历史成交记录 是
交易 交易接口 逐仓 /linear-swap-api/v1/swap_lightning_close_position POST 【逐仓】合约闪电平仓下单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_trigger_order POST 【逐仓】合约计划委托下单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_trigger_cancel POST 【逐仓】合约计划委托撤单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_trigger_cancelall POST 【逐仓】合约计划委托全部撤单 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_trigger_openorders POST 【逐仓】获取计划委托当前委托 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_trigger_hisorders POST 【逐仓】获取计划委托历史委托 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_switch_lever_rate POST 【全仓】切换杠杆 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_order POST 【全仓】合约下单 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_batchorder POST 【全仓】合约批量下单 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_cancel POST 【全仓】撤销合约订单 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_cancelall POST 【全仓】撤销全部合约单 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_order_info POST 【全仓】获取用户的合约订单信息 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_order_detail POST 【全仓】获取用户的合约订单明细信息 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_openorders POST 【全仓】获取用户的合约当前未成交委托 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_hisorders POST 【全仓】获取用户的合约历史委托 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_hisorders_exact POST 【全仓】组合查询合约历史委托 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_matchresults POST 【全仓】获取用户的合约历史成交记录 是
读取 交易接口 全仓 /linear-swap-api/v1/swap_cross_matchresults_exact POST 【全仓】组合查询用户历史成交记录 是
交易 交易接口 全仓 /linear-swap-api/v1/swap_cross_lightning_close_position POST 【全仓】合约闪电平仓下单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_trigger_order POST 【全仓】合约计划委托下单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_trigger_cancel POST 【全仓】合约计划委托撤单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_trigger_cancelall POST 【全仓】合约计划委托全部撤单 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_trigger_openorders POST 【全仓】获取计划委托当前委托 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_trigger_hisorders POST 【全仓】获取计划委托历史委托 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_tpsl_order POST 【逐仓】对仓位设置止盈止损订单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_tpsl_cancel POST 【逐仓】止盈止损订单撤单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_tpsl_cancelall POST 【逐仓】止盈止损订单全部撤单 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_tpsl_openorders POST 【逐仓】止盈止损订单当前委托 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_tpsl_hisorders POST 【逐仓】止盈止损订单历史委托 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_relation_tpsl_order POST 【逐仓】查询开仓单关联的止盈止损订单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_tpsl_order POST 【全仓】对仓位设置止盈止损订单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_tpsl_cancel POST 【全仓】止盈止损订单撤单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_tpsl_cancelall POST 【全仓】止盈止损订单全部撤单 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_tpsl_openorders POST 【全仓】止盈止损订单当前委托 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_tpsl_hisorders POST 【全仓】止盈止损订单历史委托 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_relation_tpsl_order POST 【全仓】查询开仓单关联的止盈止损订单 是
交易 账户接口 通用 https://api.huobi.pro/v2/account/transfer POST 【通用】现货-U本位合约账户间进行资金的划转 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_track_order POST 【逐仓】跟踪委托订单下单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_track_cancel POST 【逐仓】跟踪委托订单撤单 是
交易 策略接口 逐仓 /linear-swap-api/v1/swap_track_cancelall POST 【逐仓】跟踪委托订单全部撤单 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_track_openorders POST 【逐仓】跟踪委托订单当前委托 是
读取 策略接口 逐仓 /linear-swap-api/v1/swap_track_hisorders POST 【逐仓】跟踪委托订单历史委托 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_track_order POST 【全仓】跟踪委托订单下单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_track_cancel POST 【全仓】跟踪委托订单撤单 是
交易 策略接口 全仓 /linear-swap-api/v1/swap_cross_track_cancelall POST 【全仓】跟踪委托订单全部撤单 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_track_openorders POST 【全仓】跟踪委托订单当前委托 是
读取 策略接口 全仓 /linear-swap-api/v1/swap_cross_track_hisorders POST 【全仓】跟踪委托订单历史委托 是

访问地址

访问地址 适用站点 适用功能 适用交易对
https://api.hbdm.com 火必合约 API 火必合约的交易品种

备注

如果api.hbdm.com无法访问，可以使用api.btcgateway.pro来做调试，AWS服务器用户推荐使用api.hbdm.vn；

签名认证

签名说明

API 请求在通过 internet 传输的过程中极有可能被篡改，为了确保请求未被更改，除公共接口（基础信息，行情数据）外的私有接口均必须使用您的 API Key 做签名认证，以校验参数或参数值在传输途中是否发生了更改。

一个合法的请求由以下几部分组成：

创建 API Key

您可以在 这里 创建 API Key。

API Key 包括以下两部分

签名步骤

规范要计算签名的请求 因为使用 HMAC 进行签名计算时，使用不同内容计算得到的结果会完全不同。所以在进行签名计算前，请先对请求进行规范化处理。下面以查询某订单详情请求为例进行说明：

查询某订单详情

https://api.hbdm.com/linear-swap-api/v1/swap_order?

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx

&SignatureMethod=HmacSHA256

&SignatureVersion=2

&Timestamp=2017-05-11T15:19:30

1. 请求方法（GET 或 POST），后面添加换行符 “\n”

GET\n

2. 添加小写的访问地址，后面添加换行符 “\n”

api.hbdm.com\n

3. 访问方法的路径，后面添加换行符 “\n”

/linear-swap-api/v1/swap_order \n

4. 按照ASCII码的顺序对参数名进行排序。例如，下面是请求参数的原始顺序，进行过编码后

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx

SignatureMethod=HmacSHA256

SignatureVersion=2

Timestamp=2017-05-11T15%3A19%3A30

5. 经过排序之后

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx

SignatureMethod=HmacSHA256

SignatureVersion=2

Timestamp=2017-05-11T15%3A19%3A30

6. 按照以上顺序，将各参数使用字符 “&” 连接

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15%3A19%3A30

7. 组成最终的要进行签名计算的字符串如下

POST\n

api.hbdm.com\n

/linear-swap-api/v1/swap_order\n

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15%3A19%3A30

8. 用上一步里生成的 “请求字符串” 和你的密钥 (Secret Key) 生成一个数字签名

4F65x5A2bLyMWVQj3Aqp+B4w+ivaA7n5Oi2SuYtCJ9o=

  1. 将上一步得到的请求字符串和 API 私钥作为两个参数，调用HmacSHA256哈希函数来获得哈希值。

  2. 将此哈希值用base-64编码，得到的值作为此次接口调用的数字签名。

9. 将生成的数字签名加入到请求的路径参数里

最终，发送到服务器的 API 请求应该为

https://api.hbdm.com/linear-swap-api/v1/swap_order?AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15%3A19%3A30&Signature=4F65x5A2bLyMWVQj3Aqp%2BB4w%2BivaA7n5Oi2SuYtCJ9o%3D

  1. 把所有必须的认证参数添加到接口调用的路径参数里

  2. 把数字签名在URL编码后加入到路径参数里，参数名为“Signature”。

错误码详情

错误代码 错误描述
403 无效身份
1000 系统异常
1001 系统未准备就绪
1002 查询异常
1003 操作redis异常
1004 系统繁忙,请稍后再试
1010 用户不存在
1011 用户会话不存在,请重试
1012 账户不存在
1013 合约品种不存在
1014 合约不存在
1015 指数价格不存在
1016 对手价不存在
1017 查询订单不存在
1018 主账号不存在
1019 主账号不在开通子账号白名单里
1020 您的子账号数量已超出限制,请联系客服
1021 开户失败。您的主账号尚未开通合约交易权限,请前往开通
1030 输入错误
1031 非法的请求来源
1032 访问次数超出限制
1033 合约周期字段值错误
1034 报单价格类型字段值错误
1035 报单方向字段值错误
1036 报单开平字段值错误
1037 倍数不符合要求,请联系客服
1038 下单价格超出精度限制,请修改后下单
1039 买入价必须低于{0}{1},卖出价必须高于{2}{3}
1040 下单数量不能为空或者不能小于0, 请修改后下单
1041 下单数量超出限制 ({0}张),请修改后下单
1042 下单数量+挂单数量+持仓数量超过了单用户多仓持仓限制({0}张),请修改后下单
1043 下单数量+挂单数量+持仓数量超过了单用户空仓持仓限制({0}张), 请修改后下单
1044 触发平台限仓,请修改后下单
1045 当前有挂单,无法切换倍数
1046 当前合约持仓不存在
1047 可用担保资产不足
1048 可平量不足
1049 暂不支持市价开仓
1050 客户报单号重复
1051 没有可撤销的订单
1052 批量撤单、下单的订单数量超过平台限制数量
1053 无法获取最新价格区间
1054 无法获取最新价
1055 价格不合理, 下单后将导致账户权益小于0 , 请修改价格后下单
1056 结算中,暂时无法下单/撤单
1057 暂停交易中,暂时无法下单
1058 停牌中,暂时无法下单
1059 交割中,暂时无法下单/撤单
1060 合约处于非交易状态,暂时无法下单
1061 订单不存在
1062 撤单中,请耐心等待
1063 订单已成交
1064 报单主键冲突
1065 客户报单号不是整数
1066 {0}字段不能为空
1067 {0}字段不合法
1068 导出错误
1069 价格不合理
1070 数据为空,无法导出
1071 订单已撤,无法撤单
1072 卖出价必须低于{0}{1}
1073 仓位异常,请联系客服
1074 下单异常,请联系客服
1075 价格不合理, 下单后将导致担保资产率小于0 , 请修改价格后下单
1076 盘口无数据,请稍后再试
1077 交割结算中,当前品种资金查询失败
1078 交割结算中,部分品种资金查询失败
1079 交割结算中,当前品种持仓查询失败
1080 交割结算中,部分品种持仓查询失败
1081 {0}合约计划委托订单数量不得超过{1}
1082 触发类型参数错误
1083 您的仓位已进入强平接管,暂时无法下单
1084 您的合约API挂单接口被禁用,请于{0} (GMT+8) 后再试
1085 计划委托下单失败,请修改价格再次下单或联系客服
1086 {0}合约暂时限制{1}端开仓,请联系客服
1087 {0}合约暂时限制{1}端平仓,请联系客服
1088 {0}合约暂时限制{1}端撤单,请联系客服
1089 {0}账户暂时限制划转,请联系客服
1090 担保资产率小于0, 无法下单
1091 账户权益小于0, 无法下单
1092 闪电平仓取盘口第{0}档的价格, 下单后将导致账户权益小于0 , 请改为手动输入价格或使用对手价下单
1093 闪电平仓取盘口第{0}档的价格, 下单后将导致担保资产率小于0 , 请改为手动输入价格或使用对手价下单
1094 倍数不能为空, 请切换倍数或联系客服
1095 合约处于非交易状态, 暂时无法切换倍数
1100 您没有开仓权限,请联系客服
1101 您没有平仓权限,请联系客服
1102 您没有转入权限,请联系客服
1103 您没有转出权限,请联系客服
1104 合约交易受限,当前禁止交易
1105 合约交易受限,当前只能平仓
1106 合约交割结算中,暂时无法划转
1108 Dubbo调用异常
1109 子账号没有开仓权限,请联系客服
1110 子账号没有平仓权限,请联系客服
1111 子账号没有入金权限,请联系客服
1112 子账号没有出金权限,请联系客服
1113 子账号没有交易权限,请登录主账号授权
1114 子账号没有划转权限,请登录主账号授权
1115 您没有访问此子账号的权限
1200 登录失败,请重试
1220 您尚未开通合约交易,无访问权限
1221 币币账户总资产不满足合约开通条件
1222 开户天数不满足合约开通条件
1223 VIP等级不满足合约开通条件
1224 您所在的国家/地区不满足合约开通条件
1225 开通合约失败
1226 合约已开户,无法重复开户
1227 火必合约暂不支持子账户,请返回退出子账户,切换主账户登录
1228 您尚未开通合约交易, 请先开通
1229 重复同意协议
1230 您尚未做风险认证
1231 您尚未做身份认证
1232 您上传的图片格式/大小不符合要求,请重新上传
1233 您尚未开通高倍数协议 (使用高倍数请先使用主账号登录web或APP端同意高倍数协议)
1234 {0}合约未完成的开仓委托数量不得超过{1}笔
1235 {0}合约未完成的平仓委托数量不得超过{1}笔
1250 无法获取HT_token
1251 无法获取BTC净资产,请稍后再试
1252 无法获取币币账户资产,请稍后再试
1253 签名验证错误
1254 子账号无权限开通合约，请前往web端登录主账号开通
1300 划转失败
1301 可划转余额不足
1302 系统划转错误
1303 单笔转出的数量不能低于{0}{1}
1304 单笔转出的数量不能高于{0}{1}
1305 单笔转入的数量不能低于{0}{1}
1306 单笔转入的数量不能高于{0}{1}
1307 您当日累计转出量超过{0}{1}, 暂无法转出
1308 您当日累计转入量超过{0}{1}, 暂无法转入
1309 您当日累计净转出量超过{0}{1}, 暂无法转出
1310 您当日累计净转入量超过{0}{1}, 暂无法转入
1311 超过平台当日累计最大转出量限制, 暂无法转出
1312 超过平台当日累计最大转入量限制, 暂无法转入
1313 超过平台当日累计最大净转出量限制, 暂无法转出
1314 超过平台当日累计最大净转入量限制, 暂无法转入
1315 划转类型错误
1316 划转冻结失败
1317 划转解冻失败
1318 划转确认失败
1319 查询可划转金额失败
1320 此合约在非交易状态中, 无法进行系统划转
1321 划转失败, 请稍后重试或联系客服
1322 划转金额必须大于0
1323 服务异常, 划转失败, 请稍后再试
1325 设置交易单位失败
1326 获取交易单位失败
1327 无划转权限, 划转失败, 请联系客服
1328 无划转权限, 划转失败, 请联系客服
1329 无划转权限, 划转失败, 请联系客服
1330 无划转权限, 划转失败, 请联系客服
1331 超出划转精度限制(8位), 请修改后操作
1332 永续合约不存在
1333 开通跟单吃单协议失败
1334 查询跟单吃单协议失败
1335 查询跟单吃单二次确认设置失败
1336 更新跟单吃单二次确认设置失败
1337 查询跟单吃单设置失败
1338 更新跟单吃单设置失败
1339 昵称含有不合法词汇, 请修改
1340 昵称已被使用, 请修改
1341 报名阶段已结束
1342 子账号无法设置昵称
1343 指标失效, 请重新设置
1344 抱歉, 目前可最多对{0}个合约创建行情提醒
1345 抱歉, {0}合约目前可最多创建{1}个提醒
1346 该指标已存在, 请勿重复设置
1347 {0}参数错误, 请修改
1348 该合约不支持全仓模式
1349 委托单倍数与当前持仓的倍数不符, 请先切换倍数
1401 委托价必须小于行权价
1403 {0}合约止盈止损订单的委托数量不得超过{1}
1404 止盈止损订单仅支持与开仓订单绑定
1405 止盈价不得{0}{1}{2}
1406 您的抽奖次数已用完
1407 止损价不得{0}{1}{2}
1408 该止盈止损委托单未生效, 无法撤销
1409 您没有止盈止损订单权限,请联系客服
1410 批量操作子账号的数量不能超过{0}个
1411 结算中, 暂时无法查询订单信息
1412 {0}不符合价格精度限制{1}
1413 您没有跟踪委托订单权限,请联系客服
1414 您尚未开通网格交易协议(使用网格交易请先使用主账号登录web或APP端同意协议)
1415 终止价不得在网格价格范围内,请修改!
1416 超出最大运行时长({0}天{1}时),请修改!
1417 超出网格数量范围({0}~{1}个),请修改!
1418 最多同时运行{0}个网格, 请先终止其它网格
1419 超出初始化保证金范围({0}~{1}}{2})
1420 您没有合约的网格交易权限, 请联系客服
1421 当前合约有委托单或持仓, 请先撤销或平仓
1422 预计每格收益率小于0,请修改!
1423 网格最低价和最高价的价差不合理,请修改!
1424 该网格已因其它原因被终止, 无法修改或手动终止
1425 回调比例必须{0}{1}, 请修改!
1426 激活价必须{0}最新价
1427 {0}合约跟踪委托订单数量不得超过{1}
1428 相同合约的优惠券只能领取1张
1429 已领取,请勿重复领取
1430 此优惠券已失效,请刷新
1431 系统维护中,预计GMT+8 {0} 可恢复
1432 存在初始化中的网格,暂时无法下单
1433 您有限价单导致网格终止,请前往历史委托查看详情
1434 小于最小初始担保资产({0}{1}), 导致每个网格的数量小于最小下单量, 请修改!
1435 该网格已被您手动终止
1436 网格超时, 自动终止
1437 系统原因导致网格终止, 请联系客服
1438 网格触发终止条件, 已终止
1439 网格触发强平, 已终止
1440 {0}合约撤销失败
1441 触发价必须小于网格最高终止价, 大于网格最低终止价, 请修改!
1442 有效时长必须大于已运行时长1分钟以上, 请修改!
1443 合约{0}交割导致网格终止
1450 您所在的风险等级不支持使用当前倍数
1451 您所在的风险等级不支持使用当前倍数, 请登录主账号查看
1452 网格订单数量超出平台数量限制, 暂时无法下单
1453 计划委托订单数量超出平台数量限制, 暂时无法下单
1454 止盈止损订单数量超出平台数量限制, 暂时无法下单
1455 跟踪委托订单数量超出平台数量限制, 暂时无法下单
1484 反向开仓单中存在只减仓单
1485 网格交易不支持单向持仓模式下单
1486 暂不支持单向持仓模式
1487 您暂无单向持仓模式权限
1488 暂不支持在单向持仓模式下开仓
1489 暂不支持在单向持仓模式下平仓
1490 先平后开超过张数限制
1491 只减仓参数错误
1492 只减仓订单数量超过可平量
1493 当前有挂单，不能调整持仓模式
1494 当前有持仓，不能调整持仓模式
1495 当前有网格订单，不能调整持仓模式
1496 当前品种非交易中，不能调整持仓模式
1497 持仓模式传参有误
1498 保证金账号有误
1499 当前为双向持仓模式，不支持单向持仓模式下单
1500 当前为单向持仓模式，不支持双向持仓模式下单
12001 无效的提交时间
12002 错误的签名版本
12003 错误的签名方法
12004 密钥已经过期
12005 ip地址错误
12006 提交时间不能为空
12007 公钥错误
12008 校验失败
12009 用户被锁定或不存在

访问次数限制

将在api接口response中的header返回以下字段：

ratelimit-limit： 单轮请求数上限，单位：次数

ratelimit-interval：请求数重置的时间间隔，单位：毫秒

ratelimit-remaining：本轮剩余可用请求数，单位：次数

ratelimit-reset：请求数上限重置时间，单位：毫秒

如果触发了撤单率限制，您的api接口response返回header中会包括字段：

recovery-time：禁用的恢复时间戳，单位为毫秒，表示禁用结束时间，可恢复访问的时间戳；

如果不在禁用期间，header不返回recovery-time字段；

撤单率限制

API 最佳实践

1、/linear-swap-api/v1/swap_hisorders 历史委托查询接口：

2、/linear-swap-api/v1/swap_matchresults 获取历史成交记录接口：

3、/linear-swap-api/v1/swap_financial_record 查询用户财务记录接口：

4、/linear-swap-api/v1/swap_order_detail 获取订单明细接口：

5、订阅Market Depth 数据的WebSocket：

{

"sub": "market.BTC-USDT.depth.step6",

"id": "id5"

}

{

"sub": "market.BTC-USDT.depth.size_20.high_freq",

"data_type":"incremental",

"id": "id1"

}

6、/linear-swap-api/v1/swap_order合约下单和/linear-swap-api/v1/swap_batchorder合约批量下单接口：

7、服务器部署最佳选择：

代码实例

备注：U本位合约代码使用方式与币本位永续和交割合约类似，可以参考币本位永续和交割合约。

常见问题

接入验签相关

Q1: U本位合约API Key和现货是否同一个？

U本位合约API Key和现货API Key是同一个，两个是一样的。您可以在 这里 创建 API Key。

Q2: 为什么经常出现断线、超时的错误？

如果是在大陆网络环境去请求API接口，网络连接很不稳定，很容易出现超时。建议使用AWS东京C区服务器进行访问。

国内网络可以使用api.btcgateway.pro或者api.hbdm.vn来进行调试,如果仍然无法请求，请在国外服务器上进行运行。

Q3: 为什么WebSocket总是断开连接？

由于网络环境不同，很容易导致websocket断开连接(websocket: close 1006 (abnormal closure))，目前最佳实践是建议您将服务器放置在AWS东京C区，并且使用api.hbdm.vn域名；同时需要做好断连重连操作；行情心跳与订单心跳均需要按照《Websocket心跳以及鉴权接口》的行情心跳与订单心跳回复不同格式的Pong消息：这里。以上操作可以有效减少断连情况。

Q4: api.hbdm.com与api.hbdm.vn有什么区别？

api.hbdm.vn域名使用的是AWS的CDN服务，理论上AWS服务器用户使用此域名会更快更稳定；api.hbdm.com域名使用的是Cloudflare的CDN服务。

Q5: 市商享受的colocation服务是指什么以及使用注意事项？

colo相当于是 创建一个VPC节点，直接连了火必合约的内网，会减少客户服务器和火必合约服务器的通讯时间（绕过CDN）。

火必交割合约 的Colocation和 永续合约 是共用的，即连接永续合约Colocation的域名与交割合约是一样的；

但请您注意：colo需要使用：api.hbdm.com 进行签名（鉴权），避免返回403:Verification failure [校验失败] 的错误。

Q6: 为什么签名认证总返回失败(403:Verification failure [校验失败]) ？

U本位合约签名过程和币本位永续、币交割类似，除了参考以下注意事项外，请参照币本位永续或者交割的demo代码来验证签名是否成功，demo代码验证通过后，再去核对您自己的签名代码。币本位永续的demo代码在 这里 查看。交割的demo代码在 这里 查看。U本位合约的demo代码在 这里 查看。

  1. 检查 API Key 是否有效，是否复制正确

  2. 是否有绑定 IP 白名单

  3. 检查时间戳是否是 UTC 时间

  4. 检查参数是否按字母排序

  5. 检查编码，使用 UTF-8 编码

  6. 检查签名是否有 base64 编码

  7. 对于 GET 请求，每个方法自带的参数都需要进行签名运算

  8. 对于 POST 请求，每个方法自带的参数不进行签名认证

  9. 检查签名结果是否有进行 URI 编码，十六进制字符必须大写，如 “:” 会被编码为 “%3A” ，空 格被编码为 “%20”

  10. websocket构建签名与restful类似，websocket构建json请求的数据不需要URL编码。

  11. 签名时所带Host应与请求接口时Host相同。如果您使用了代理，代理可能会改变请求Host，可以尝试去掉代理；您使用的网络连接库可能会把端口包含在Host内，可以尝试在签名用到的Host中包含端口，如“api.hbdm.com:443"

  12. Api Key 与 Secret Key中是否存在隐藏特殊字符，影响签名.

  13. 检查生成 HmacSHA256 签名结果后是否直接将byte[] 转 Base64 编码，而不是使用其签名结果转换16进制字符串的内容再进行 Base64 编码。

如果通过以上的方法还没找出签名失败的原因，可以通过专门验证签名的 demo 来确认您的签名是在哪一步出现问题。

Q7: 公开行情根据ip限速，需要私钥的根据uid限速是吗？

是的。私有的根据UID来限速，不是根据API—KEY限速，母子帐号是分开分别限速，互不影响。

Q8: 第三方框架集成火必合约是否有推荐？

目前已经有异步量化框架开源，集成了火必交割合约与永续合约： 异步量化框架地址 ，有使用反馈或者问题请在github issue区进行提问。

结算相关

Q1: USDT本位永续的资金费率结算周期是什么？资金费率结算时通过哪些接口可以查询状态？

温馨提示您，USDT本位永续合约每8小时为一期，每期结束时进行结算。即00:00-08:00为一期，结算时间为08:00；08:00-16:00为一期，结算时间为16:00；16:00-次日00:00为一期，结算时间为00:00。以上时间均为新加坡时间。

(1)在结算时不能下单和撤单，若用户在结算时下单或撤单会返回错误码"1056"，提示结算中无法下单和撤单。

您可以通过下面两种方式查询结算状态：

当返回报文中contract_status返回状态码为5、6、7、8中的任意一个数字时表示在结算中，当contract_status返回状态码为1时是表示结算完成可以正常下单和撤单。

(2)在结算时查询资金和持仓会返回错误码，返回的错误码及错误码表示的含义如下：

  1. 错误码"1077"表示"交割结算中，当前品种资金查询失败"；
  2. 错误码"1078"表示"交割结算中，部分品种资金查询失败"；
  3. 错误码"1079"表示"交割结算中，当前品种持仓查询失败"；
  4. 错误码"1080"表示"交割结算中，部分品种持仓查询失败"；

建议您从返回的报文里读取状态码，如果状态码出现上述四种类型，请不要用这个返回的数据。

Q2: 如何查询交易所系统状态

交易所系统常见的两种状态: 系统处于结算/交割；停机维护. 当系统处于这两种状态时, 调用 api 接口会返回响应的错误代码和错误信息

a.如何判断是否是结算/交割完成

通过"获取合约信息”接口: /linear-swap-api/v1/swap_contract_info

或订阅“订阅合约信息变动(免鉴权)”接口: public.$contract_code.contract_info

在返回值中的 contract_status 来判断, 如果值为 1 表示已经结算/交割完成, 可以正常交易了

b.如何判断是否是停机维护

通过"查询系统是否可用”接口: https://api.hbdm.com/heartbeat/

或者"订阅系统状态更新”接口: "topic ": "public.$service.heartbeat"

在推送值中的 heartbeat 来判断, 如果值为 1 表示系统为可用, 可以正常连接了

行情及WS推送相关

Q1: 全量行情orderbook订阅和增量orderbook订阅是多长时间推送？

全量orderbook深度推送(market.$contract_code.depth.$type)是100MS检查一次，有更新则推送，至少1秒会推送1次。增量orderbook深度推送(market.$contract_code.depth.size_${size}.high_freq)是30MS检查一次，有更新则推送，没有更新则不推送。

Q2: 市场公开逐笔成交是多长时间推送？

市场公开逐笔成交market.$contract_code.trade.detail是有成交则推送。

Q3: 有没有历史K线数据或者历史的公开市场逐笔成交数据？

历史K线数据可以通过API接口/linear-swap-ex/market/history/kline去获取，只填写from,to参数，不写size参数，最多只能获取连续两年的数据。

历史的公开市场逐笔成交数据目前没有，您可以通过订阅market.$contract_code.trade.detail来本地进行存储。

Q4: 如何获取K线上的MACD等技术指标？

API没有获取K线上的MACD等技术指标接口，您可以参考TradingView等网站来计算。

Q5: 文档里的时间戳timestamp定义是什么？

文档里的时间戳是指格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数或者总毫秒数。

Q6: 获取行情深度数据中请求参数type的 150档，20档具体是指？

订阅行情深度market.$contract_code.depth.$type,150档指当前盘口的买卖盘的订单，将价格顺序切分为150个小区间，统计每个小区间的挂单数；20档指当前盘口的买卖盘的订单，将价格顺序切分为20个小区间，统计每个小区间的挂单数。

Q7: 获取行情深度数据中请求参数type的“合并深度”是什么意思？

订阅行情深度(market.$contract_code.depth.$type)：

step16和step18 按7位小数合并，买盘向下、卖盘向上
step17和step19 按6位小数合并，买盘向下、卖盘向上
step1和step7 按5位小数合并，买盘向下、卖盘向上
step2和step8 按4位小数合并，买盘向下、卖盘向上
step3和step9 按3位小数合并，买盘向下、卖盘向上
step4和step10 按2位小数合并，买盘向下、卖盘向上
step5和step11 按1位小数合并，买盘向下、卖盘向上
step12和step14 按个位数合并，买盘向下、卖盘向上
step13和step15 按十位数合并，买盘向下、卖盘向上
step4 合并为0.01 例如，下买单价格 100.123， 100.245，
盘口就显示下单价格 100.12， 100.24
如果是卖单 盘口显示价格： 100.13， 100.25

（“向下”和“向上”即是否四舍五入，如买盘向下则不进一位，卖盘向上则进一位） step0到step5,step14到step17是150档； step6到step13,step18、step19是20档； step6是不合并小数； 结合以上举例说明：

假设当前价格1.123456 6位小数点，如果我单选step1，如果价格是买盘，显示价格是 1.12345（不四舍五入），如果是卖盘，就是1.12346（四舍五入）；

同理，如果我选择step7也是同样的，如果价格是买盘，显示价格是 1.12345（不四舍五入），如果是卖盘，就是1.12346（四舍五入）；

假设是TRX 选择20档 那么step6是不合并，如果当前价格是1.123456 6位小数点，选择step6，不论买卖盘口还是1.123456 6位小数；

假设是TRX 选择20档 那么step11按1位小数合并，假设当前价格1.123456 6位小数点，如果我单选step11，如果价格是买盘，显示价格是 1.1（不四舍五入），如果是卖盘，就是1.1（四舍五入)。

Q8: websocket的持仓变动频道，每次是返回全量数据还是增量变化的数据？

订阅持仓推送："topic": "positions.BTC-USDT"，推送的是最新的持仓（包括持仓量、可平仓数量、冻结数量），没有变化就不推送。

Q9: websocket持仓订阅频道，未实现盈亏有变化会推送吗?

订阅持仓推送："topic": "positions.BTC-USDT", 如果持仓有变动，包括开仓/平仓/交割等，会推送仓位变化，若只是单纯的未实现盈亏不会推送。

Q10: WS中的market detail 和 trade detail 具体什么区别和含义?

Market Detail(market.$contract_code.detail) 是市场聚合行情，0.5s检测1次，有成交则推送。包含了此时间段的开盘价、收盘价、最高价、最低价和成交数量；Trade Detail(market.$contract_code.trade.detail) 是有成交更新就会推送，包括成交价格、成交数量和成交方向等数据。

Q11: 订阅market depth增量数据返回参数的两个ts分别是什么？

增量depth订阅：market.$contract_code.depth.size_${size}.high_freq，外层ts是到行情服务器开始转发这笔数据的系统时间戳，里层ts是orderbook的检测时间点。

Q12: 通过ws订阅market depth数据和market depth增量数据的区别是什么？订阅market depth增量数据多久推送一次？

market.$contract_code.depth.$type是全量数据，market.$contract_code.depth.size_${size}.high_freq是增量数据，全量数据是100ms检查一次，至少1秒推送1次；增量30MS检查1次，无更新不推送。

目前market depth增量数据market.$contract_code.depth.size_${size}.high_freq是30MS检测一次，不是随机检测，30m检查一次更新，但是有二台机同时进行，每两次的时间间隔最小可能是0，但30ms内最多推送6次，最大时间间隔无上限，30ms内最少推送次数为0。

Q13: 增量数据market.$contract_code.depth.size_${size}.high_freq推送如何维护本地数据？

增量数据首次会推送全量数据，之后推送的为增量数据。

(1) 把增量的价格与上一个全量做比较，相同的价格把挂单量替换；

(2) 没有相同价格的添加到本地全量数据；

(3) 如果某个价格挂单没有了，会推送类似[8100, 0]这样的数据，把本地相同价格的移除；

(4) 同一个websocket连接，增量数据version是递增的；如果 version不递增，您需要重新订阅并重新维护本地全量数据；

Q14:获取合约的历史资金费率（/linear-swap-api/v1/swap_historical_funding_rate）返回字段中“当期资金费率（funding_rate）”和“实际资金费率（realized_rate）”的区别？

在正常情况下当期资金费率和实际资金费率是相等的。只有在支付资金费率会导致用户爆仓时，会少收或不收资金费率（少收或不收的资金费率值就是实际资金费率）。当期资金费率不变。

Q15: 订阅多个合约代码同一主题时, 需要多个 ws 连接吗?

对于交割合约、币永续、U本位合约之间, 由于是不同的接口地址, 需要不同的 ws 连接

对于交割合约、币永续、U本位合约各自里面, 只要接口地址是一样的, 一个 ws 连接即可.

Q16: 是否可以通过 ws 下单和撤单?

目前不支持 ws 下单和撤单

Q17: 如何订阅订单状态?

a. 订单交易成功: ”订阅合约订单撮合数据（matchOrders.$contract_code）"或"订阅订单成交数据（orders.$contract_code）"

b. 订单撤单成功: 订阅"资产变动数据（accounts.$contract_code）”

Q18: ”订阅合约订单撮合数据（matchOrders.$contract_code）"和"订阅订单成交数据（orders.$contract_code）"的区别？

两者推送的数据不一样, 订单成交数据（orders.$contract_code）会比订单撮合数据（matchOrders.$contract_code）字段多一些

通常情况下, 撮合完成后的推送(订单撮合数据“matchOrders.$contract_code”)要比清算完成后的(订单成交数据“orders.$contract_code”)推送快, 但不能保证撮合完成后的推送一定比清算完成后的推送更快;

强平以及轧差订单不会推送"订单撮合数据（matchOrders.$contract_code）”

Q19: "订阅 KLine 数据（market.$contract_code.kline.$period）”多久推送一次？

有成交时, 500ms推送一次

无成交时, 根据订阅的周期推送

Q20: 如何判断推送是否延迟

判断是否延迟, 请先同步服务器时间, 同步服务器时间接口为: https://api.hbdm.com/api/v1/timestamp, 返回数据中的 ts 是时间戳（毫秒）, 对应的时区是 UTC+8.

每个推送数据的外层都会有一个推送数据 ts, 这个 ts 是服务器推送数据给客户端那一刻的间戳（毫秒）, 对应的时区是 UTC+8.

当有推送数据到达时, 程序记录此时本地时间 ts. 当发现本地时间 ts 远远大于推送数据 ts 时（本地时间远远晚于推送数据时间）, 可以通过以下方式定位延迟和解决延迟:

a. 减少订阅时推送的数据.

b. 查看本地网络和服务器间的稳定性和速度（请把 api.btcgateway.pro 替换为程序使用的域名）

curl -o /dev/null -s -w time_namelookup"(s)":%{time_namelookup}"\n"time_connect"(s)":%{time_connect}"\n"time_starttransfer"(s)":%{time_starttransfer}"\n"time_total"(s)":%{time_total}"\n"speed_download"(B/s)":%{speed_download}"\n" api.btcgateway.pro

收到类似以下数据:

time_namelookup(s):0.001378

time_connect(s):0.128641

time_starttransfer(s):0.276588

time_total(s):0.276804

speed_download(B/s):2010.000

若连续多次运行以上命令, 每次得到的结果差异很大, 可以: a.选择合适的火必域名, b.优化或者重新选择程序所在网络.

交易相关

Q1: API返回1004错误码是什么原因？

由于近段时间平台系统订单堆积情况比较严重，我们的技术人员正在努力解决和优化中，如果近段时间出现系统繁忙的情况或者出现以下提示：

{“status”:”error”,”err_code”:1004,”err_msg”:”System busy. Please try again later.”,”ts”: }

请您耐心等待，在此过程中请不要进行重复的下单和撤单，以避免造成重复下单以及对系统性能造成额外的压力，在此期间，建议您可以通过Web和APP端进行下单和撤单。

Q2: 同样的order id 和 match id，可以有N多个Trade，比如，用户是一笔大的taker单，吃掉了N个maker的订单，那么，就会对应有N个trade，如何标识这些不同的trade？

订单明细信息接口/linear-swap-api/v1/swap_order_detail返回的的字段id是全局唯一的交易标识。如果一个maker单，分多次match掉的话是每次推送只推match的部分，撮合一笔推送一笔。

Q3: USDT本位永续合约交易全链路延时多少？

目前USDT本位永续合约全链路(从开始下单到订单的订单状态可以查询)正常情况下大约在30-50MS左右,来行情时延迟会比平时大，可能会在秒级别。

Q4: API接口返回Connection Reset 或者 Max retris 或者 Timed out 是什么原因？

出现连接重置或者网络超时，一般是网络不稳定导致，可以尝试将服务器放置在AWS东京C区，并使用api.hbdm.vn来尝试，可以有效减少网络超时等错误。

Q5: API接口下单时出错没有order_id如何来查询订单状态？

如果由于网络原因等API下单超时或者失败，没有返回order_id，可以通过下单时加入client_order_id自定义订单号来进行查询订单状态。

Q6: WS 订阅私有账户，订单或者仓位一段时间，连接断开如何办？

WS订阅私有账户，订单，仓位时，请注意也要定时维护好心跳，与市场行情的心跳格式不同，详情请参照菜单《Websocket心跳以及鉴权接口》里的订单推送心跳。同时如果连接断开，请做好重连逻辑。

Q7: 合约资产接口中的“获取合约订单信息”的订单状态1和2都是准备提交有什么不同？3已提交又是什么？

1是准备提交，2是定序的提交，是内部流程的提交。可以认为已经被系统接受了，在系统的流程中。3是已委托到市场。

Q8: API有获取总资产BTC的接口吗？

没有的。

Q9: API撤单成功为什么查询订单却是成交？

请注意撤单成功或者下单成功只代表您撤单命令或者下单命令的成功，并不代表订单已经撤销，您可以通过该接口/linear-swap-api/v1/swap_order_info去查询订单状态。

Q10: API查询订单状态为10是否一定失败？

通过/linear-swap-api/v1/swap_order_info查询订单状态，如果status为10，表示订单失败，不会成功。

Q11: API一般从撤单开始到撤单成功需要多久？

撤单命令执行成功一般几十ms，实际撤单状态要查询订单状态/linear-swap-api/v1/swap_order_info获取。

Q12: 获取历史强平订单的方法？

需要获取历史强平订单，可以通过：获取合约历史委托（/linear-swap-api/v1/swap_hisorders【逐仓】或/linear-swap-api/v1/swap_cross_hisorders【全仓】）、获取历史成交记录（/linear-swap-api/v1/swap_matchresults【逐仓】或/linear-swap-api/v1/swap_cross_matchresults【全仓】）这两个接口中的返回字段order_source(订单来源)来判断，当order_source返回的为“risk”说明这个订单就是被强平的订单。

Q13: 是否支持双向持仓

支持的. 火必目前是支持同时持有空单和多单的

Q14: 如何保证快速成交

火必合约目前是没有市价的. 为提高成交概率, 可以使用对手价: opponent, 最优5档: optimal_5, 最优10档: optimal_10, 最优20档: optimal_20. 其中最优20档的成交概率最大, 但是滑点也最大.

需要注意的是, 以上下单价格方式, 不保证 100% 成交的. 系统执行下单时, 是获取当时时刻的对方 N 档价格, 进行下单的.

Q15: api 程序如何更快连接到交易所

推荐使用 AWS 东京 c 区服务器, 同时使用 api.hbdm.vn 域名连接

Q16: 现货与合约之间, 划转报 Abnormal service 错误

a.检查请求地址是否为火必 Global 地址: api.huobi.pro

b.检查币的精度是否不超过 8 位小数

Q17: 如何确认是否开仓/平仓成功

"合约下单（/linear-swap-api/v1/swap_order）”接口或者"合约批量下单（/linear-swap-api/v1/swap_batchorder）”接口下单成功后, 不代表已经开仓/平仓成功. 只是意味着服务器已经成功收到你的下单指令

查询是否开仓/平仓成功，可以使用返回的“order_id” 通过“获取合约订单信息（/linear-swap-api/v1/swap_order_info）” 或 “获取订单明细信息（/linear-swap-api/v1/swap_order_detail）”这两个接口来查询订单状态。当订单已经成交后，接口返回参数中的status 值为 6 （全部成交）。

但同时需要注意：

a.获取合约订单信息（/linear-swap-api/v1/swap_order_info）接口在系统结算或交割后，会把结束状态的订单（5部分成交已撤单 6全部成交 7已撤单）删除掉。

b.获取订单明细信息（/linear-swap-api/v1/swap_order_detail）接口存在延迟情况，所以查询时最好带上：created_at（下单时间戳）和 order_type(订单类型，默认填1)，会直接查询数据库，查询结果会更及时。

Q18: 为什么系统自动撤单了?

下单时 order_price_type 为: IOC, FOK, Maker（post_only） 当盘口不满足条件时, 会自动撤单

post_only, 只做Maker（Post only）订单, 不会立刻在市场上成交, 如果委托会立即与已有委托成交, 那么该委托会被取消, 保证用户始终为Maker.

IOC 订单, 若不能在市场上立即成交, 则未成交的部分立即取消.

FOK 订单, 若不能全部成交则立即全部取消.

Q19: 如何获取用户当前资产最大可开张数？

目前没有直接获取当前资产最大可开张数的接口.

Q20: order_id 和 order_id_str 是一样的吗?

order_id_str 是 order_id 的字符串格式, 两者的值是一样的

对于 18 位的 order_id, 在 nodejs 和 javascript 的 JSON.parse 默认是 int, 解析会有问题, 因此推荐使用 order_id_str

Q21: 如何获取成交数据中的主买/主卖数量

"获取市场最近成交记录（/linear-swap-ex/market/trade）”接口或"sub": "market.$contract_code.trade.detail"订阅, 可以获取此数据, 其中:

amount: 成交量(张), 买卖双边成交量之和

direction: 主动成交方向

Q22: 获取K线数据(/linear-swap-ex/market/history/kline)时, from 和 to 的时间间隔是 2000 * period, 为什么获取的 data 为[]?

获取 K 线时, from 和 to 两个时间点是全都包含在内的, 因此是 2001 条数据. 此时数量超出了最大条数 2000. 所以返回 []

另外，当 from 和 to 的时间超过 2 年，返回的数据也会是 []

Q23: 如何获取合约最新价格

a.调用"获取K线数据(/linear-swap-ex/market/history/kline)”接口, 任意 period, 返回数据的最后一条数据的 close 就是最新价.

b.调用"获取市场最近成交记录(/linear-swap-ex/market/trade)”接口, 返回数据的 price 就是最新价

Q24: 如何获取最新指数价?

有两种方式获取最新指数价:

a.通过调用"获取合约指数信息（/linear-swap-api/v1/swap_index）”接口, 返回数据中的 index_price 就是最新指数价

b.通过订阅"指数K线数据（market.$contract_code.index.$period）”websocket, 返回数据的最后一条k线的 close 就是最新指数价

Q25: API 升级会影响程序的运行吗?

一般情况, API 升级会部分影响 ws 断连, 请做好 ws 重连逻辑. 升级内容可以订阅升级公告:

交割: https://status-dm.huobigroup.com/

币本位永续: https://status-swap.huobigroup.com/

USDT本位永续: https://status-linear-swap.huobigroup.com/

Q26: "获取用户账户信息（/api/v1/contract_account_info）"中 margin_balance 是指什么?

margin_balance 是指账户权益

1、账户权益（margin_balance）= 静态权益（margin_static）+ 未实现盈亏（profit_unreal）。

2、账户权益（margin_balance）= 账户余额 + 已实现盈亏（profit_real）+ 未实现盈亏（profit_unreal）。

注：账户余额 = 静态权益（margin_static）- 已实现盈亏（profit_real），我们在API中只给出了静态权益字段。

以上二种计算方式都可以得出帐户权益。

Q27: 获取用户账户信息（/linear-swap-api/v1/swap_account_info）中的risk_rate "保证金率”和WEB端的"担保资产率”是一样的吗?

是一样的. 当 risk_rate <= 0 时, 用户的仓位将会被系统强平.

错误码相关

Q1: 1030错误是什么原因？

如果您出现比如查询订单或者下单时遇到：{"status":"error","err_code":1030,"err_msg":"Abnormal service. Please try again later.","ts":1588093883199}类似错误，说明您的输入的请求参数值或者类型不对，请打印出您的request请求body及完整URL参数，并请一一核对对应API文档接口参数。常见的比如volume张数必须是整数。

Q2: 1048错误是什么原因？

如果您出现{'index': 1, 'err_code': 1048, 'err_msg': 'Insufficient close amount available. '}类似错误，说明此时可平仓量不足，您平仓时需查询目前已有的仓位张数再去平仓。

1、检查平仓的张数是否过大（当有平仓的限价挂单时, 会占用可平仓位的张数, 建议您撤销这些挂单后再去重试）.

2、检查仓位方向和开平方向（平多: 卖出平多(direction用sell、offset用close)、平空: 买入平空(direction用buy、offset用close)、闪电平仓只需传: direction（平多:sell、平空: buy））.

3、止盈止损的挂单和计划委托的挂单, 不会占仓位数.

Q3: API返回1032错误码是什么原因？

1032代表您的访问次数超出限制，币本位永续合约、交割合约和U本位合约都分开限制频率，请查看合约交易接入说明中的访问次数限制，并且可以在api接口response中的header打印当前的频率限制次数来看是否超出限制频率。建议加大请求间隔延时避免超出限制频率。

全仓模式和逐仓模式的区别与使用

1、全仓模式下，全仓账户中的USDT会为每个品种合约的仓位提供担保，即全仓下所有品种合约的仓位共享一个账户权益，账户中的盈亏、占用担保资产、担保资产率等数据合并计算；逐仓模式下，USDT本位永续合约各品种合约的账户权益单独计算各品种合约下的仓位担保资产，盈亏互不影响。

2、全仓模式与逐仓模式使用不同的保证金账户，资产互相独立，可同时进行两个模式的交易，也可同时拥有两个模式的仓位。例如在BTC-USDT合约市场下，全仓模式交易的保证金账户为USDT，而逐仓模式交易的保证金账户为BTC-USDT。

3、API用户可通过API接口【获取合约信息：/linear-swap-api/v1/swap_contract_info】的support_margin_mode字段（合约支持的保证金模式），来查看合约是否支持全仓模式或逐仓模式。

4、API接口分为三种模式类型，【全仓】、【逐仓】和【通用】，这三个模式类型标注在API接口名称以及接口列表上。其中【全仓】表示该API接口仅支持全仓模式使用，【逐仓】表示该API接口仅支持逐仓模式调用，【通用】则表示该API接口不区分全仓和逐仓，即逐仓模式和全仓模式均可调用。

如何更有效的解决问题

您在反馈API错误时，需要附上您的请求URL，请求request的原始的完整body以及完整请求URL参数，服务器的回复response的原始完整log。如果是websocket订阅，需要您提供订阅的地址，订阅的主题，server推送的原始完整log。

如果是订单相关问题，在使用API订单查询接口/linear-swap-api/v1/swap_order_info请求后保留返回的完整log，并提供您的UID以及订单号。

基础信息

账户类型查询

备注

请求参数

无

Response: 

{
    "code":200,
    "msg":"ok",
    "data":{
        "account_type":2
    },
    "ts":1668057324200
}

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码
msg true string 结果描述
ts true long 时间戳
<data> true
account_type true int 账户类型 1:非统一账户（全仓逐仓账户）2:统一账户
</data> true

账户类型更改接口

备注

Request: 

{
  "account_type": 1
}

请求参数

参数名称 是否必须 类型 描述 取值范围
account_type true int 账户类型 1:非统一账户（全仓逐仓账户）

Response: 

{
    "code":200,
    "msg":"ok",
    "data":{
        "account_type":1
    },
    "ts":1668057324200
}

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码
msg true string 结果描述
ts true long 时间戳
<data> true
account_type true int 账户类型 1:非统一账户（全仓逐仓账户）
</data> true

【通用】获取合约的资金费率


curl "https://api.hbdm.com/linear-swap-api/v1/swap_fund
ing_rate?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...

Response: 


{
    "status": "ok",
    "data": {
        "estimated_rate": "0.000100000000000000",
        "funding_rate": "0.000100000000000000",
        "contract_code": "BTC-USDT",
        "symbol": "BTC",
        "fee_asset": "USDT",
        "funding_time": "1603699200000",
        "next_funding_time": "1603728000000"
    },
    "ts": 1603696494714
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
fee_asset true string 资金费币种 "USDT"...
funding_time true string 当期资金费率时间
funding_rate true string 当期资金费率
estimated_rate true string 下一期预测资金费率（一分钟计算一次）
next_funding_time true string 下一期资金费率时间
</data>

【通用】批量获取合约资金费率

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码，不填返回全部合约 "BTC-USDT" ...

Response

{
    "status": "ok",
    "data": [
        {
            "estimated_rate": "-0.007500000000000000",
            "funding_rate": "-0.007500000000000000",
            "contract_code": "ETC-USDT",
            "symbol": "ETC",
            "fee_asset": "USDT",
            "funding_time": "1613976000000",
            "next_funding_time": "1614004800000"
        },
        {
            "estimated_rate": "-0.007500000000000000",
            "funding_rate": "-0.007500000000000000",
            "contract_code": "ADA-USDT",
            "symbol": "ADA",
            "fee_asset": "USDT",
            "funding_time": "1613976000000",
            "next_funding_time": "1614004800000"
        }
    ],
    "ts": 1614045373795
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
fee_asset true string 资金费币种 "USDT...
funding_time true string 当期资金费率时间（毫秒）
funding_rate true string 当期资金费率
estimated_rate true string 下一期预测资金费率
next_funding_time true string 下一期资金费率时间（毫秒）
</data>

【通用】获取合约的历史资金费率


curl "https://api.hbdm.com/linear-swap-api/v1/swap_historical_funding_rate?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
page_index false int 页码，不填默认第1页
page_size false int 不填默认20，不得多于50

Response:


{
    "status": "ok",
    "data": {
        "total_page": 14,
        "current_page": 1,
        "total_size": 14,
        "data": [
            {
                "avg_premium_index": "0.000049895833333333",
                "funding_rate": "0.000100000000000000",
                "realized_rate": "0.000100000000000000",
                "funding_time": "1603670400000",
                "contract_code": "BTC-USDT",
                "symbol": "BTC",
                "fee_asset": "USDT"
            }
        ]
    },
    "ts": 1603696680599
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
<data> true object
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
fee_asset true string 资金费币种 "USDT"...
funding_time true string 资金费率时间
funding_rate true string 当期资金费率
realized_rate true string 实际资金费率
avg_premium_index true string 平均溢价指数
</data>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>

【通用】获取强平订单(新)

备注

Request:


    "/linear-swap-api/v3/swap_liquidation_orders?trade_type=5&contract=BTC-USDT"

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部,5: 卖出强平,6: 买入强平
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 2h 取值范围 [((end-time) – 2h), (end-time)] ，查询窗口最大为2小时，窗口平移范围为最近90天,已完全撤销的历史订单的查询窗口平移范围只有最近2小时
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天,已完全撤销的历史订单的查询窗口平移范围只有最近2小时
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 452057,
                "contract_code": "BTC-USDT-211210",
                "symbol": "USDT",
                "direction": "sell",
                "offset": "close",
                "volume": 479.000000000000000000,
                "price": 51441.700000000000000000,
                "created_at": 1638593647864,
                "amount": 0.479000000000000000,
                "trade_turnover": 24640.574300000000000000,
                "business_type": "futures",
                "pair": "BTC-USDT"
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 查询id，可作为下一次查询请求的from_id字段
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT", 交割："BTC-USDT-210625" ...
created_at true long 强平时间
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 强平数量（张）
amount true decimal 强平数量（币）
price true decimal 破产价格
trade_turnover true decimal 强平金额（计价币种）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>

【通用】查询平台历史结算记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 永续："BTC-USDT"... , 交割：“BTC-USDT-210625”...
start_time false long 起始时间（时间戳，单位毫秒） 取值范围：[(当前时间 - 90天), 当前时间] ，默认取当前时间- 90天
end_time false long 结束时间（时间戳，单位毫秒） 取值范围：(start_time, 当前时间)，默认取当前时间
page_index false int 页码，不填默认第1页
page_size false int 页长，不填默认20，不得多于50

Response: 

{
    "status": "ok",
    "data": {
        "total_page": 1,
        "current_page": 1,
        "total_size": 12,
        "settlement_record": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211203",
                "settlement_time": 1638518400000,
                "clawback_ratio": 0E-18,
                "settlement_price": 56792.300000000000000000,
                "settlement_type": "delivery",
                "business_type": "futures",
                "pair": "BTC-USDT"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211203",
                "settlement_time": 1638489600000,
                "clawback_ratio": 0E-18,
                "settlement_price": 57028.600000000000000000,
                "settlement_type": "settlement",
                "business_type": "futures",
                "pair": "BTC-USDT"
            }
        ]
    },
    "ts": 1638756873768
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
<settlement_record> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... , 交割：“BTC-USDT-210625”...
settlement_time true long 结算时间（时间戳，单位毫秒）（当settlement_type为交割时，该时间为交割时间；当settlement_type为结算时，该时间为结算时间；）
clawback_ratio true decimal 分摊比例
settlement_price true decimal 结算价格（当settlement_type为交割时，该价格为交割价格；当settlement_type为结算时，该价格为结算价格；）
settlement_type true string 结算类型 “delivery”：交割，“settlement”：结算
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</settlement_record>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>

【通用】精英账户多空持仓对比-账户数


curl "https://api.hbdm.com/linear-swap-api/v1/swap_elite_account_ratio?contract_code=BTC-USDT&period=5min"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-FUTURES" ...
period true string 时间周期类型 5min, 15min, 30min, 60min,4hour,1day

Response:


{
    "status":"ok",
    "data":{
        "list":[
            {
                "buy_ratio":0.5,
                "sell_ratio":0.5,
                "locked_ratio":0,
                "ts":1638115200000
            }
        ],
        "symbol":"BTC",
        "contract_code":"BTC-USDT",
        "business_type":"swap",
        "pair":"BTC-USDT"
    },
    "ts":1638169688105
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-FUTURES" ...
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<list> true object array
buy_ratio true decimal 净多仓的账户比例
sell_ratio true decimal 净空仓的账户比例
locked_ratio true decimal 锁仓的账户比例
ts true long 生成时间
</list>
</data>

【通用】精英账户多空持仓对比-持仓量


curl "https://api.hbdm.com/linear-swap-api/v1/swap_elite_position_ratio?contract_code=BTC-USDT&period=1day"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-FUTURES" ...
period true string 周期 5min, 15min, 30min, 60min,4hour,1day

Response:


{
    "status":"ok",
    "data":{
        "list":[
            {
                "buy_ratio":0.5,
                "sell_ratio":0.5,
                "ts":1638460800000
            }
        ],
        "symbol":"BTC",
        "contract_code":"BTC-USDT-FUTURES",
        "business_type":"futures",
        "pair":"BTC-USDT"
    },
    "ts":1638756121395
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-FUTURES" ...
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<list> true object array
buy_ratio true decimal 多仓的总持仓量占比
sell_ratio true decimal 空仓的总持仓量占比
ts true long 生成时间
</list>
</data>

【逐仓】查询系统状态


curl "https://api.hbdm.com/linear-swap-api/v1/swap_api_state?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码,如果缺省，默认返回所有合约 "BTC-USDT"...

Response: 


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "open": 1,
            "close": 1,
            "cancel": 1,
            "transfer_in": 1,
            "transfer_out": 1,
            "master_transfer_sub": 1,
            "sub_transfer_master": 1,
            "master_transfer_sub_inner_in": 1,
            "master_transfer_sub_inner_out": 1,
            "sub_transfer_master_inner_in": 1,
            "sub_transfer_master_inner_out": 1,
            "transfer_inner_in": 1,
            "transfer_inner_out": 1
        }
    ],
    "ts": 1603696366019
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT"...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如]“BTC-USDT”
open true int 开仓下单权限："1"表示可用，“0”表示不可用
close true int 平仓下单权限："1"表示可用，“0”表示不可用
cancel true int 撤单权限："1"表示可用，“0”表示不可用
transfer_in true int 从币币转入的权限："1"表示可用，“0”表示不可用
transfer_out true int 转出至币币的权限："1"表示可用，“0”表示不可用
master_transfer_sub true int 从母账号划转到子账号的权限："1"表示可用，“0”表示不可用
sub_transfer_master true int 从子账号划转到母账号的权限："1"表示可用，“0”表示不可用
master_transfer_sub_inner_in true int 母账号划转到子账号的转入权限-跨账户："1"表示可用，“0”表示不可用
master_transfer_sub_inner_out true int 母账号划转到子账号的转出权限-跨账户："1"表示可用，“0”表示不可用
sub_transfer_master_inner_in true int 子账号划转到母账号的转入权限-跨账户："1"表示可用，“0”表示不可用
sub_transfer_master_inner_out true int 子账号划转到母账号的转出权限-跨账户："1"表示可用，“0”表示不可用
transfer_inner_in true int 同账号不同保证金账户划转的转入权限："1"表示可用，“0”表示不可用
transfer_inner_out true int 同账号不同保证金账户划转的转出权限："1"表示可用，“0”表示不可用
</data>

【全仓】获取平台阶梯保证金

备注

请求参数：

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续：“BTC-USDT”... ，交割“BTC-USDT-210625”...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response

{
    "status":"ok",
    "data":[
        {
            "margin_account":"USDT",
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "margin_mode":"cross",
            "list":[
                {
                    "lever_rate":2,
                    "ladders":[
                        {
                            "min_margin_balance":0,
                            "max_margin_balance":null,
                            "min_margin_available":0,
                            "max_margin_available":null
                        }
                    ]
                }
            ],
            "business_type":"swap",
            "pair":"BTC-USDT",
            "contract_type":"swap"
        }
    ],
    "ts":1638755685337
}

返回参数：

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 比如："BTC"
contract_code true string 合约代码 永续：“BTC-USDT”... ，交割“BTC-USDT-210625”...
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如“USDT”
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<list> true object array
lever_rate true int 杠杆倍数
<ladders> true object array 该合约对应杠杆倍数下的阶梯保证金数据
min_margin_balance true decimal 最小账户权益（该阶梯权益范围起点，包含该值）
max_margin_balance true decimal 最大账户权益（该阶梯权益范围终点，不包含该值，该值属于下一阶梯的权益范围起点）
min_margin_available true decimal 最小可用保证金（范围内包含该值）
max_margin_available true decimal 最大可用保证金（范围内不包含该值，该值属于下一阶梯的最小可用保证金）
</ladders>
</list>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】获取平台阶梯保证金

备注

请求参数：

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码，不填默认返回所有支持逐仓的合约的阶梯保证金 比如： “BTC-USDT”、“ETH-USDT”...

Response

{
    "status": "ok",
    "data": [
        {
            "margin_account": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "list": [
                {
                    "lever_rate": 20,
                    "ladders": [
                        {
                            "min_margin_balance": 0,
                            "max_margin_balance": 250000,
                            "min_margin_available": 0,
                            "max_margin_available": 250000
                        },
                        {
                            "min_margin_balance": 250000,
                            "max_margin_balance": 2500000,
                            "min_margin_available": 250000,
                            "max_margin_available": 1000000
                        },
                        {
                            "min_margin_balance": 2500000,
                            "max_margin_balance": 10000000,
                            "min_margin_available": 1000000,
                            "max_margin_available": 2500000
                        },
                        {
                            "min_margin_balance": 10000000,
                            "max_margin_balance": 85000000,
                            "min_margin_available": 2500000,
                            "max_margin_available": 10000000
                        },
                        {
                            "min_margin_balance": 85000000,
                            "max_margin_balance": null,
                            "min_margin_available": 10000000,
                            "max_margin_available": null
                        }
                    ]
                }
            ]
        }
    ],
    "ts": 1612504906880
}

返回参数：

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 比如："BTC"
contract_code true string 合约代码 比如："BTC-USDT"
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
<list> true object array
lever_rate true int 杠杆倍数
<ladders> true object array 该合约对应杠杆倍数下的阶梯保证金数据
min_margin_balance true decimal 最小账户权益（该阶梯权益范围起点，包含该值）
max_margin_balance true decimal 最大账户权益（该阶梯权益范围终点，不包含该值，该值属于下一阶梯的权益范围起点）
min_margin_available true decimal 最小可用保证金（范围内包含该值）
max_margin_available true decimal 最大可用保证金（范围内不包含该值，该值属于下一阶梯的最小可用保证金）
</ladders>
</list>
</data>
ts true long 响应生成时间点，单位：毫秒

【通用】获取预估结算价

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response

{
    "status": "ok",
    "data": [
        {
            "contract_code": "BTC-USDT-211210",
            "estimated_settlement_price": null,
            "settlement_type": "settlement",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "this_week"
        },
        {
            "contract_code": "BTC-USDT-211217",
            "estimated_settlement_price": null,
            "settlement_type": "settlement",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "next_week"
        },
        {
            "contract_code": "BTC-USDT-211231",
            "estimated_settlement_price": null,
            "settlement_type": "settlement",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "quarter"
        },
        {
            "contract_code": "BTC-USDT",
            "estimated_settlement_price": null,
            "settlement_type": "settlement",
            "business_type": "swap",
            "pair": "BTC-USDT",
            "contract_type": "swap"
        }
    ],
    "ts": 1638755400222
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object array
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
estimated_settlement_price true decimal 本期预估结算价/预估交割价（结算类型为交割时为预估交割价；结算时为预估结算价；）
settlement_type true string 本期结算类型 “delivery”：交割，“settlement”：结算
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>
ts true long 接口响应时间（毫秒）

备注

【逐仓】查询平台阶梯调整系数


curl "https://api.hbdm.com/linear-swap-api/v1/swap_adjustfactor?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码,如果缺省，默认返回所有合约 "BTC-USDT"...

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "list": [
                {
                    "lever_rate": 125,
                    "ladders": [
                        {
                            "ladder": 0,
                            "min_size": 0,
                            "max_size": 8999,
                            "adjust_factor": 0.650000000000000000
                        },
                        {
                            "ladder": 1,
                            "min_size": 9000,
                            "max_size": 89999,
                            "adjust_factor": 0.800000000000000000
                        },
                        {
                            "ladder": 2,
                            "min_size": 90000,
                            "max_size": null,
                            "adjust_factor": 0.850000000000000000
                        }
                    ]
                }
            ]
        }
    ],
    "ts": 1603695606565
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
<list> true object array
lever_rate true decimal 杠杆倍数
<ladders> true object array
min_size true decimal 净持仓量的最小值
max_size true decimal 净持仓量的最大值
ladder true int 档位
adjust_factor true decimal 调整系数
</ladders>
</tick>
</data>

【全仓】查询平台阶梯调整系数

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false(请看备注) string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status":"ok",
    "data":[
        {
            "symbol":"BTC",
            "contract_code":"BTC-USDT-211210",
            "margin_mode":"cross",
            "list":[
                {
                    "lever_rate":1,
                    "ladders":[
                        {
                            "ladder":0,
                            "min_size":0,
                            "max_size":3999,
                            "adjust_factor":0.005
                        },
                        {
                            "ladder":1,
                            "min_size":4000,
                            "max_size":39999,
                            "adjust_factor":0.01
                        },
                        {
                            "ladder":2,
                            "min_size":40000,
                            "max_size":79999,
                            "adjust_factor":0.015
                        },
                        {
                            "ladder":3,
                            "min_size":80000,
                            "max_size":119999,
                            "adjust_factor":0.02
                        },
                        {
                            "ladder":4,
                            "min_size":120000,
                            "max_size":null,
                            "adjust_factor":0.025
                        }
                    ]
                }
            ],
            "business_type":"futures",
            "pair":"BTC-USDT",
            "contract_type":"this_week"
        }
    ],
    "ts":1638754992327
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<list> true object array
lever_rate true decimal 杠杆倍数
<ladders> true object array
min_size true decimal 净持仓量的最小值
max_size true decimal 净持仓量的最大值
ladder true int 档位 从0档开始
adjust_factor true decimal 调整系数
</ladders>
</list>
</data>

【通用】查询合约风险准备金余额历史数据


curl "https://api.hbdm.com/linear-swap-api/v1/swap_insurance_fund?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-FUTURES"...
page_index false int 页码，不填默认第1页
page_size false int 不填默认100，不得多于100 [1-100]

Response:


{
    "status": "ok",
    "data": {
        "total_page": 1,
        "current_page": 1,
        "total_size": 4,
        "symbol": "BTC",
        "contract_code": "BTC-USDT-FUTURES",
        "tick": [
            {
                "insurance_fund": 16174.621898868113476721,
                "ts": 1638691200000
            },
            {
                "insurance_fund": 130.912398868113476721,
                "ts": 1638604800000
            },
            {
                "insurance_fund": 0.002860554220000000,
                "ts": 1638518400000
            },
            {
                "insurance_fund": 0,
                "ts": 1638432000000
            }
        ],
        "business_type": "futures",
        "pair": "BTC-USDT"
    },
    "ts": 1638754881217
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典数据
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-FUTURES"...
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<tick> true object array
insurance_fund true decimal 风险准备金余额
ts true long 数据时间点，单位：毫秒
</tick>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>

【通用】查询合约风险准备金余额和预估分摊比例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_risk_info?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-FUTURES"...
business_type false string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status": "ok",
    "data": [
        {
            "contract_code": "BTC-USDT",
            "insurance_fund": 16174.621898868113476721,
            "estimated_clawback": 0E-18,
            "business_type": "swap",
            "pair": "BTC-USDT"
        },
        {
            "contract_code": "BTC-USDT-FUTURES",
            "insurance_fund": 16174.621898868113476721,
            "estimated_clawback": 0E-18,
            "business_type": "futures",
            "pair": "BTC-USDT"
        },
        {
            "contract_code": "ETH-USDT",
            "insurance_fund": 16174.621898868113476721,
            "estimated_clawback": 0E-18,
            "business_type": "swap",
            "pair": "ETH-USDT"
        },
        {
            "contract_code": "ETH-USDT-FUTURES",
            "insurance_fund": 16174.621898868113476721,
            "estimated_clawback": 0E-18,
            "business_type": "futures",
            "pair": "ETH-USDT"
        }
    ],
    "ts": 1638754774555
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
estimated_clawback true decimal 预估分摊比例
insurance_fund true decimal 风险准备金余额
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-FUTURES"...
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>

【通用】获取合约最高限价和最低限价

示例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_price_limit?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "high_limit": 49629.00000000000000000000,
            "low_limit": 47682.80000000000000000000,
            "business_type": "swap",
            "pair": "BTC-USDT",
            "contract_type": "swap"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "high_limit": 49645.20000000000000000000,
            "low_limit": 47698.50000000000000000000,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "this_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211217",
            "high_limit": 49699.70000000000000000000,
            "low_limit": 47750.80000000000000000000,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "next_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "high_limit": 50135.10000000000000000000,
            "low_limit": 47214.80000000000000000000,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "quarter"
        }
    ],
    "ts": 1638753887869
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok"
<data> true object array
symbol true string 品种代码 "BTC","ETH" ...
contract_code true string 合约代码 如 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
high_limit true decimal 最高买价
low_limit true decimal 最低卖价
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<data>
ts true long 响应生成时间点，单位：毫秒

【通用】获取当前合约总持仓量

示例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_open_interest?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status": "ok",
    "data": [
        {
            "volume": 78696.000000000000000000,
            "amount": 78.696000000000000000,
            "symbol": "BTC",
            "value": 3823138.245600000000000000,
            "contract_code": "BTC-USDT",
            "trade_amount": 0,
            "trade_volume": 0,
            "trade_turnover": 0,
            "business_type": "swap",
            "pair": "BTC-USDT",
            "contract_type": "swap"
        },
        {
            "volume": 10925.000000000000000000,
            "amount": 10.925000000000000000,
            "symbol": "BTC",
            "value": 530662.210000000000000000,
            "contract_code": "BTC-USDT-211217",
            "trade_amount": 0,
            "trade_volume": 0,
            "trade_turnover": 0,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "next_week"
        },
        {
            "volume": 27104.000000000000000000,
            "amount": 27.104000000000000000,
            "symbol": "BTC",
            "value": 1316937.283200000000000000,
            "contract_code": "BTC-USDT-211210",
            "trade_amount": 0,
            "trade_volume": 0,
            "trade_turnover": 0,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "this_week"
        },
        {
            "volume": 201143.000000000000000000,
            "amount": 201.143000000000000000,
            "symbol": "BTC",
            "value": 9775067.056800000000000000,
            "contract_code": "BTC-USDT-211231",
            "trade_amount": 0,
            "trade_volume": 0,
            "trade_turnover": 0,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "quarter"
        }
    ],
    "ts": 1638754059540
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 "BTC", "ETH" ...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
amount true decimal 持仓量(币)，单边数量
volume true decimal 持仓量(张)，单边数量
value true decimal 总持仓额（单位为合约的计价币种，如USDT）
trade_amount true decimal 最近24小时成交量（币）（当前时间-24小时）,值是买卖双边之和
trade_volume true decimal 最近24小时成交量（张）（当前时间-24小时）,值是买卖双边之和
trade_turnover true decimal 最近24小时成交额 （当前时间-24小时）,值是买卖双边之和
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>
ts true long 响应生成时间点，单位：毫秒

备注

【通用】获取合约信息

示例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_contract_info?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
support_margin_mode false string 合约支持的保证金模式 cross：仅支持全仓模式；isolated：仅支持逐仓模式；all：全逐仓都支持
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211203",
            "contract_size": 0.001000000000000000,
            "price_tick": 0.100000000000000000,
            "delivery_date": "20211203",
            "delivery_time": "1638518400000",
            "create_date": "20211202",
            "contract_status": 1,
            "settlement_date": "1638518400000",
            "support_margin_mode": "cross",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "this_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "contract_size": 0.001000000000000000,
            "price_tick": 0.100000000000000000,
            "delivery_date": "20211210",
            "delivery_time": "1639123200000",
            "create_date": "20211202",
            "contract_status": 1,
            "settlement_date": "1638518400000",
            "support_margin_mode": "cross",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "next_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "contract_size": 0.001000000000000000,
            "price_tick": 0.100000000000000000,
            "delivery_date": "20211231",
            "delivery_time": "1640937600000",
            "create_date": "20211202",
            "contract_status": 1,
            "settlement_date": "1638518400000",
            "support_margin_mode": "cross",
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "quarter"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "contract_size": 0.001000000000000000,
            "price_tick": 0.100000000000000000,
            "delivery_date": "",
            "delivery_time": "",
            "create_date": "20211202",
            "contract_status": 1,
            "settlement_date": "1638518400000",
            "support_margin_mode": "all",
            "business_type": "swap",
            "pair": "BTC-USDT",
            "contract_type": "swap"
        }
    ],
    "ts": 1638517765776
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
contract_size true decimal 合约面值，即1张合约对应多少标的币种（如BTC-USDT合约则面值单位就是BTC） 0.1，0.01...
price_tick true decimal 合约价格最小变动精度 0.001, 0.01...
settlement_date true string 合约下次结算时间 时间戳，如"1490759594752"
delivery_time true string 交割时间（合约无需交割时，该字段值为空字符串），单位：毫秒
create_date true string 合约上市日期 如"20180706"
contract_status true int 合约状态 合约状态: 0:已下市、1:上市、2:待上市、3:停牌，4:待开盘、5:结算中、6:交割中、7:结算完成、8:交割完成
support_margin_mode true string 合约支持的保证金模式 cross：全仓模式；isolated：逐仓模式；all：全逐仓都支持
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
delivery_date true string 合约交割日期,永续无需交割时该字段为空字符串 如"20180720"
</data>
ts true long 响应生成时间点，单位：毫秒

【通用】获取合约指数信息

示例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_index?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 指数代码 "BTC-USDT","ETH-USDT"...

Response:


{
    "status": "ok",
    "data": [
        {
            "index_price": 13076.329865680000000000,
            "index_ts": 1603694592011,
            "contract_code": "BTC-USDT"
        }
    ],
    "ts": 1603694596400
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
contract_code true string 指数代码 "BTC-USDT","ETH-USDT"...
index_price true decimal 指数价格
index_ts true long 响应生成时间点，单位：毫秒
</data>
ts true long 时间戳，单位：毫秒

停服维护

当该业务系统停服维护期间，除了以下2个提供给用户查询系统状态的接口能够正常使用外（获取当前系统状态、查询系统是否可用），该业务所有rest接口都会固定返回响应报文:{"status": "maintain"}。websocket推送接口在停服维护时，除了WebSocket系统状态更新的推送接口可以正常调用外（WebSocket系统状态更新接口），其他推送接口都会返回1006的错误码。

Response

{
    "status": "maintain"
}

也可以通过订阅WebSocket系统状态更新接口获取系统维护停服信息

获取当前系统时间戳

get https://api.hbdm.com/api/v1/timestamp

请求参数

无

返回数据


{
    "status": "ok",
    "ts": 1578124684692
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
ts true long 当前系统时间戳

备注

查询系统是否可用

备注：

返回参数

参数名称 类型 描述
status string "ok" 或 "error"...
<data> dict object
heartbeat int 交割合约 1: 可用 0: 不可用(即停服维护)
swap_heartbeat int 币本位永续 1: 可用 0: 不可用(即停服维护)
estimated_recovery_time long null: 正常. 交割合约预计恢复时间， 单位:毫秒
swap_estimated_recovery_time long null: 正常. 币本位永续合约预计恢复时间，单位：毫秒.
linear_swap_heartbeat long U本位合约 1: 可用 0: 不可用(即停服维护)
linear_swap_estimated_recovery_time long null: 正常. U本位合约预计恢复时间，单位：毫秒.
</data>

返回数据


{
    "status":"ok",
    "data":{
        "heartbeat":1,
        "estimated_recovery_time":null,
        "swap_heartbeat":1,
        "swap_estimated_recovery_time":null,
        "linear_swap_heartbeat":1,
        "linear_swap_estimated_recovery_time":null
    },
    "ts":1557714418033
}

获取当前系统状态

此接口返回当前的系统状态，包含当前系统维护计划和故障进度等。

如您需要通过邮件、短信、Webhook、RSS/Atom feed接收以上信息，可点击这里进入页面进行订阅。当前订阅依赖Google服务，订阅前请确保您可正常访问Google的服务，否则将订阅失败。

curl "https://status-linear-swap.huobigroup.com/api/v2/summary.json"

HTTP 请求

请求参数

此接口不接受任何参数。

Response:

{
  "page": {  // 合约页面基本信息
    "id": "p0qjfl24znv5",  // 页面id
    "name": "Huobi Futures-USDT-margined Swaps",  // 页面名称
    "url": "https://status-linear-swap.huobigroup.com", // 页面地址
    "time_zone": "Asia/Singapore", // 时区
    "updated_at": "2020-02-07T10:25:14.717Z" // 页面最新一次更新时间
  },
  "components": [  // 系统组件及状态
    {
      "id": "h028tnzw1n5l",  // 组件id
      "name": "Deposit", // 组件名称
      "status": "operational", // 组件状态
      "created_at": "2019-12-05T02:07:12.372Z",  // 组件创建时间
      "updated_at": "2020-02-07T09:27:15.563Z", // 组件更新时间
      "position": 1,
      "description": null,
      "showcase": true,
      "group_id": "gtd0nyr3pf0k",  
      "page_id": "p0qjfl24znv5", 
      "group": false,
      "only_show_if_degraded": false
    }
  ],
  "incidents": [ // 系统故障事件及状态
        {
            "id": "rclfxz2g21ly",  // 事件id
            "name": "Market data is delayed",  // 事件名称
            "status": "investigating",  // 事件状态
            "created_at": "2020-02-11T03:15:01.913Z",  // 事件创建时间
            "updated_at": "2020-02-11T03:15:02.003Z",   // 事件更新时间
            "monitoring_at": null,
            "resolved_at": null,
            "impact": "minor",  // 事件影响程度
            "shortlink": "http://stspg.io/pkvbwp8jppf9",
            "started_at": "2020-02-11T03:15:01.906Z",
            "page_id": "p0qjfl24znv5",
            "incident_updates": [ 
                {
                    "id": "dwfsk5ttyvtb",  
                    "status": "investigating",  
                    "body": "Market data is delayed",  
                    "incident_id": "rclfxz2g21ly",   
                    "created_at": "2020-02-11T03:15:02.000Z",    
                    "updated_at": "2020-02-11T03:15:02.000Z",   
                    "display_at": "2020-02-11T03:15:02.000Z",    
                    "affected_components": [  
                        {
                            "code": "nctwm9tghxh6",  
                            "name": "Market data",  
                            "old_status": "operational",  
                            "new_status": "degraded_performance"   
                        }
                    ],
                    "deliver_notifications": true,
                    "custom_tweet": null,
                    "tweet_id": null
                }
            ],
            "components": [  
                {
                    "id": "nctwm9tghxh6",    
                    "name": "Market data", 
                    "status": "degraded_performance", 
                    "created_at": "2020-01-13T09:34:48.284Z", 
                    "updated_at": "2020-02-11T03:15:01.951Z", 
                    "position": 8,
                    "description": null,
                    "showcase": false,
                    "group_id": null,
                    "page_id": "p0qjfl24znv5",
                    "group": false,
                    "only_show_if_degraded": false
                }
            ]
        }
    ],
      "scheduled_maintenances": [  // 系统计划维护事件及状态
        {
            "id": "k7g299zl765l", // 事件id
            "name": "Schedule maintenance", // 事件名称
            "status": "scheduled", // 事件状态
            "created_at": "2020-02-11T03:16:31.481Z",  // 事件创建时间
            "updated_at": "2020-02-11T03:16:31.530Z",  // 事件更新时间
            "monitoring_at": null,
            "resolved_at": null,
            "impact": "maintenance", // 事件影响
            "shortlink": "http://stspg.io/md4t4ym7nytd",
            "started_at": "2020-02-11T03:16:31.474Z",
            "page_id": "p0qjfl24znv5",
            "incident_updates": [  
                {
                    "id": "8whgr3rlbld8",  
                    "status": "scheduled", 
                    "body": "We will be undergoing scheduled maintenance during this time.", 
                    "incident_id": "k7g299zl765l", 
                    "created_at": "2020-02-11T03:16:31.527Z",  
                    "updated_at": "2020-02-11T03:16:31.527Z",  
                    "display_at": "2020-02-11T03:16:31.527Z",  
                    "affected_components": [  
                        {
                            "code": "h028tnzw1n5l",  
                            "name": "Deposit And Withdraw - Deposit",  
                            "old_status": "operational",  
                            "new_status": "operational"  
                        }
                    ],
                    "deliver_notifications": true,
                    "custom_tweet": null,
                    "tweet_id": null
                }
            ],
            "components": [ 
                {
                    "id": "h028tnzw1n5l",  
                    "name": "Deposit", 
                    "status": "operational", 
                    "created_at": "2019-12-05T02:07:12.372Z",  
                    "updated_at": "2020-02-10T12:34:52.970Z",  
                    "position": 1,
                    "description": null,
                    "showcase": false,
                    "group_id": "gtd0nyr3pf0k",
                    "page_id": "p0qjfl24znv5",
                    "group": false,
                    "only_show_if_degraded": false
                }
            ],
            "scheduled_for": "2020-02-15T00:00:00.000Z",  // 计划维护开始时间
            "scheduled_until": "2020-02-15T01:00:00.000Z"  // 计划维护结束时间
        }
    ],
    "status": {  // 系统整体状态
        "indicator": "minor",   // 系统状态指标
        "description": "Partially Degraded Service"  // 系统状态描述
    }
}

返回字段

字段名称 数据类型 描述
page status page页面基本信息
{id string 页面id
name string 页面名称
url string 页面地址
time_zone string 时区
updated_at} string 页面更新时间
components 系统组件及状态
[{id string 组件id
name string 组件名称，如Order submission、Order cancellation、Deposit等
status string 组件状态，取值范围为：operational，degraded_performance，partial_outage，major_outage，under maintenance
created_at string 组件创建时间
updated_at string 组件更新时间
.......}] 其他字段明细，请参考返回示例
incidents 系统故障事件及状态，若当前无故障则返回为空
[{id string 事件id
name string 事件名称
status string 事件状态，取值范围为：investigating，identified，monitoring，resolved
created_at string 事件创建时间
updated_at string 事件更新时间
.......}] 其他字段明细，请参考返回示例
scheduled_maintenances 系统计划维护事件及状态，若当前无计划维护则返回为空
[{id string 事件id
name string 事件名称
status string 事件状态，取值范围为：scheduled，in progress，verifying，completed
created_at string 事件创建时间
updated_at string 事件更新时间
scheduled_for string 计划维护开始时间
scheduled_until string 计划维护结束时间
.......}] 其他字段明细，请参考返回示例
status 系统整体状态
{indicator string 系统状态指标，取值范围为：none，minor，major，critical，maintenance
description} string 系统状态描述，取值范围为：All Systems Operational，Minor Service Outager，Partial System Outage，Partially Degraded Service，Service Under Maintenance

合约市场行情接口

【通用】获取行情深度数据

示例


curl "https://api.hbdm.com/linear-swap-ex/market/depth?contract_code=BTC-USDT&type=step0"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
type true string 深度类型 (150档数据) step0, step1, step2, step3, step4, step5, step14, step15, step16, step17（合并深度1-5,14-17）；step0时，不合并深度, (20档数据) step6, step7, step8, step9, step10, step11, step12, step13, step18, step19（合并深度7-13,18-19）；step6时，不合并深度

Response:


{
    "ch": "market.BTC-USDT-CQ.depth.step6",
    "status": "ok",
    "tick": {
        "asks": [
            [
                48611.5,
                741
            ],
            [
                48635.2,
                792
            ]
        ],
        "bids": [
            [
                48596.4,
                90
            ],
            [
                48585.7,
                180
            ]
        ],
        "ch": "market.BTC-USDT-CQ.depth.step6",
        "id": 1638754215,
        "mrid": 1250406,
        "ts": 1638754215640,
        "version": 1638754215
    },
    "ts": 1638754216092
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.period
status true string 请求处理结果 "ok" , "error"
<tick> true object
asks false array 卖盘,[price(挂单价), vol(此价格挂单张数)], 按price升序
bids false array 买盘,[price(挂单价), vol(此价格挂单张数)], 按price降序
ch true string 数据所属的 channel，格式： market.period
id true long 消息id
mrid true long 订单ID
ts true long 消息生成时间，单位：毫秒.
version true long 版本
</tick>
ts true long 响应生成时间点，单位：毫秒

备注

Depth 类型 精度
step16、step18 0.0000001
step17、step19 0.000001
step1、step7 0.00001
step2、step8 0.0001
step3、step9 0.001
step4、step10 0.01
step5、step11 0.1
step14、step12 1
step15、step13 10

【通用】获取市场最优挂单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response

{
    "status": "ok",
    "ticks": [
        {
            "business_type": "futures",
            "contract_code": "BTC-USDT-CW",
            "ask": [
                48637.3,
                746
            ],
            "bid": [
                48482.5,
                385
            ],
            "mrid": 1251224,
            "ts": 1638754357868
        },
        {
            "business_type": "futures",
            "contract_code": "BTC-USDT-NW",
            "ask": [
                48620.1,
                1000
            ],
            "bid": [
                48461,
                524
            ],
            "mrid": 1251162,
            "ts": 1638754344746
        },
        {
            "business_type": "futures",
            "contract_code": "BTC-USDT-CQ",
            "ask": [
                48630.9,
                868
            ],
            "bid": [
                48577.1,
                63
            ],
            "mrid": 1251236,
            "ts": 1638754359301
        },
        {
            "business_type": "swap",
            "contract_code": "BTC-USDT",
            "ask": [
                48511.6,
                91
            ],
            "bid": [
                48508.9,
                95
            ],
            "mrid": 334931,
            "ts": 1638754361719
        }
    ],
    "ts": 1638754363648
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<ticks> true object array
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type true string 业务类型 futures：交割、swap：永续
mrid true long 撮合ID，唯一标识
ask false array [卖1价,卖1量(张)]
bid false array [买1价,买1量(张)]
ts true long 系统检测orderbook时间点，单位：毫秒
</ticks>
ts true long 响应生成时间点，单位：毫秒

【通用】获取K线数据

示例


curl "https://api.hbdm.com/linear-swap-ex/market/history/kline?contract_code=BTC-USDT&period=1day&from=1587052800&to=1591286400"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day,1week,1mon
size false（请看备注） int 获取数量，默认150 [1,2000]
from false（请看备注） long 开始时间戳 10位 单位S
to false（请看备注） long 结束时间戳 10位 单位S

备注

Response:


{
    "ch": "market.BTC-USDT.kline.1min",
    "data": [
        {
            "amount": 0.004,
            "close": 13076.8,
            "count": 1,
            "high": 13076.8,
            "id": 1603695060,
            "low": 13076.8,
            "open": 13076.8,
            "trade_turnover": 52.3072,
            "vol": 4
        }
    ],
    "status": "ok",
    "ts": 1603695099234
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.period
<data> true object array
id true long K线ID,也就是K线时间戳，K线起始时间
vol true decimal 成交量(张)。 值是买卖双边之和
count true decimal 成交笔数。 值是买卖双边之和
open true decimal 开盘价
close true decimal 收盘价,当K线为最晚的一根时，是最新成交价
low true decimal 最低价
high true decimal 最高价
amount true decimal 成交量(币), 即 (成交量(张) * 单张合约面值)。 值是买卖双边之和
trade_turnover true decimal 成交额，即 sum（每一笔成交张数 * 合约面值 * 成交价格）。 值是买卖双边之和
</data>
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒

【通用】获取标记价格的K线数据

备注：

请求参数：

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week,1mon
size true int K线获取数量 [1,2000]

备注：

Response：

{
    "ch": "market.BTC-USDT.mark_price.5min",
    "data": [
        {
            "amount": "0",
            "close": "31078.68",
            "count": "0",
            "high": "31078.68",
            "id": 1611105300,
            "low": "31078.68",
            "open": "31078.68",
            "trade_turnover": "0",
            "vol": "0"
        },
        {
            "amount": "0",
            "close": "31078.68",
            "count": "0",
            "high": "31078.68",
            "id": 1611105600,
            "low": "31078.68",
            "open": "31078.68",
            "trade_turnover": "0",
            "vol": "0"
        }
    ],
    "status": "ok",
    "ts": 1611106791703
}

返回参数：

参数名称 是否必须 类型 描述 默认值 取值范围
ch true string 数据所属的 channel，格式： market.period
<data> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值
close true string 收盘值
low true string 最低值
high true string 最高值
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额, 数值为0
</data>
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒

【通用】获取聚合行情

示例


curl "https://api.hbdm.com/linear-swap-ex/market/detail/merged?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

Response:


{
    "ch": "market.BTC-USDT.detail.merged",
    "status": "ok",
    "tick": {
        "amount": "12.526",
        "ask": [
            13084.2,
            131
        ],
        "bid": [
            13082.9,
            38
        ],
        "close": "13076.8",
        "count": 2920,
        "high": "13205.3",
        "id": 1603695162,
        "low": "12877.5",
        "open": "12916.2",
        "trade_turnover": "163247.3982",
        "ts": 1603695162580,
        "vol": "12526"
    },
    "ts": 1603695162580
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$contract_code.detail.merged
status true string 请求处理结果 "ok" , "error"
<tick> true object 开盘价和收盘价（从当天零点(UTC+8)开始）
id true long K线ID,也就是K线时间戳
amount true string 成交量(币), 即 (成交量(张) * 单张合约面值)（最近24（当前时间-24小时）小时成交量币）。 值是买卖双边之和
ask true array [卖1价,卖1量(张)]
bid true array [买1价,买1量(张)]
open true string 开盘价
close true string 收盘价,当K线为最晚的一根时，是最新成交价
count true decimal 成交笔数（当前时间-24小时）小时成交笔数）。 值是买卖双边之和
high true string 最高价
low true string 最低价
vol true string 成交量（张）（最近24（当前时间-24小时）小时成交量张）。 值是买卖双边之和
trade_turnover true string 成交额，即 sum（每一笔成交张数 * 合约面值 * 成交价格）（当前时间-24小时）小时成交额）。 值是买卖双边之和
ts true long 时间戳
</tick>
ts true long 响应生成时间点，单位：毫秒

【通用】批量获取聚合行情（V2）

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:

{
    "status": "ok",
    "ticks": [
        {
            "id": 1650792083,
            "ts": 1650792083179,
            "ask": [
                39736.6,
                1285
            ],
            "bid": [
                39736.5,
                6070
            ],
            "business_type": "swap",
            "contract_code": "BTC-USDT",
            "open": "39760",
            "close": "39736.6",
            "low": "39316.3",
            "high": "39971.2",
            "amount": "6891.566",
            "count": 48262,
            "vol": "273472535.834",
            "number_of": "6891566"
        }
    ],
    "ts": 1650792083179
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<ticks> true object array
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type true string 业务类型 futures：交割、swap：永续
id true long K线id
amount true string 成交量(币) （最近24（当前时间-24小时）小时成交量币）。 值是买卖双边之和
ask true array [卖1价,卖1量(张)]
bid true array [买1价,买1量(张)]
open true string 开盘价
close true string 收盘价,当K线为最晚的一根时，是最新成交价
count true decimal 成交笔数（当前时间-24小时）小时成交笔数）。 值是买卖双边之和
high true string 最高价
low true string 最低价
vol true string 成交额（最近24（当前时间-24小时）小时成交量张）。 值是买卖双边之和
number_of true string 成交量（张）（当前时间-24小时）小时成交额）。 值是买卖双边之和
ts true long 时间戳
</ticks>
ts true long 响应生成时间点，单位：毫秒

【通用】获取市场最近成交记录

示例


curl "https://api.hbdm.com/linear-swap-ex/market/trade?contract_code=BTC-USDT"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "ch": "market.*.trade.detail",
    "status": "ok",
    "tick": {
        "data": [
            {
                "amount": "6",
                "ts": 1603695230083,
                "id": 1314755250000,
                "price": "13083",
                "direction": "buy",
                "quantity": 0.006,
                "contract_code": "BTC-USDT",
                "business_type":"swap",
                "trade_turnover": 78.498
            }
        ],
        "id": 1603695235127,
        "ts": 1603695235127
    },
    "ts": 1603695235127
}

返回参数

参数名称 是否必须 类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$symbol.trade.detail
status true string "ok","error"
<tick> true object
id true long 订单唯一id（品种唯一）
ts true long 最新成交时间
<data> true object array
amount true string 成交量(张)。 值是买卖双边之和
direction true string 买卖方向，即taker(主动成交)的方向
id true long 成交唯一id（品种唯一）
price true string 成交价
ts true long 成交时间
quantity true string 成交量（币）
contract_code true string 合约代码
business_type true string 业务类型 futures：交割、swap：永续
trade_turnover true string 成交额（计价币种）
</data>
</tick>
ts true long 发送时间

【通用】批量获取最近的交易记录

示例


curl "https://api.hbdm.com/linear-swap-ex/market/history/trade?contract_code=BTC-USDT&size=100"

备注

请求参数：

参数名称 是否必须 数据类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
size true int 获取交易记录的数量，默认1 [1, 2000]

Response:


{
    "ch": "market.BTC-USDT.trade.detail",
    "data": [
        {
            "data": [
                {
                    "amount": 2,
                    "direction": "buy",
                    "id": 1314767870000,
                    "price": 13081.3,
                    "ts": 1603695383124,
                    "quantity": 0.002,
                    "trade_turnover": 26.1626
                }
            ],
            "id": 131476787,
            "ts": 1603695383124
        }
    ],
    "status": "ok",
    "ts": 1603695388965
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$contract_code.trade.detail
<data> true object array
<data> true object array
amount true decimal 成交量(张)。 值是买卖双边之和
direction true string 买卖方向，即taker(主动成交)的方向
id true long 成交唯一id（品种唯一）
price true decimal 成交价格
ts true long 成交时间
quantity true decimal 成交量（币）
trade_turnover true decimal 成交额（计价币种）
</data>
id true long 订单唯一id（品种唯一）
ts true long 最新成交时间
</data>
status true string "ok"，"error"
ts true long 响应生成时间点，单位：毫秒

备注

【通用】平台历史持仓量查询

实例


curl "https://api.hbdm.com/linear-swap-api/v1/swap_his_open_interest?contract_code=BTC-USDT&period=60min&amount_type=1"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
period true string 时间周期类型 1小时:"60min"，4小时:"4hour"，12小时:"12hour"，1天:"1day"
size false int 获取数量,默认为：48 [1,200]
amount_type true int 计价单位 1:张，2:币

Response:


{
    "status": "ok",
    "data": {
        "symbol": "BTC",
        "tick": [
            {
                "volume": 27112.0000000000000000,
                "amount_type": 1,
                "ts": 1638720000000,
                "value": 1321498.52640000000000000000000000000000000
            }
        ],
        "contract_code": "BTC-USDT-211210",
        "business_type": "futures",
        "pair": "BTC-USDT",
        "contract_type": "this_week"
    },
    "ts": 1638755582116
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典数据
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<tick> true object array
volume true decimal 持仓量。
amount_type true int 计价单位（表示持仓量的计价单位） 1:张，2:币
value true decimal 总持仓额（单位为合约的计价币种，如USDT）
ts true long 统计时间
</tick>
</data>

注意：

【通用】获取合约的溢价指数K线


curl "https://api.hbdm.com/index/market/history/linear_swap_premium_index_kline?contract_code=BTC-USDT&period=1min&size=1"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week,1mon
size true int K线获取数量 [1,2000]

Response:


{
    "ch": "market.BTC-USDT.premium_index.1min",
    "data": [
        {
            "amount": "0",
            "close": "0.0000079166666666",
            "count": "0",
            "high": "0.0000079166666666",
            "id": 1603696920,
            "low": "0.0000079166666666",
            "open": "0.0000079166666666",
            "trade_turnover": "0",
            "vol": "0"
        }
    ],
    "status": "ok",
    "ts": 1603696958348
}

返回参数

参数名称 是否必须 类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.period
<data> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值（溢价指数）
close true string 收盘值（溢价指数）
low true string 最低值（溢价指数）
high true string 最高值（溢价指数）
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额, 数值为0
</data>
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒

【通用】获取实时预测资金费率的K线数据


curl "https://api.hbdm.com/index/market/history/linear_swap_estimated_rate_kline?contract_code=BTC-USDT&period=1min&size=1"

备注

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week,1mon
size true int K线获取数量 [1,2000]

Response:


{
    "ch": "market.BTC-USDT.estimated_rate.1min",
    "data": [
        {
            "amount": "0",
            "close": "0.0001",
            "count": "0",
            "high": "0.0001",
            "id": 1603697100,
            "low": "0.0001",
            "open": "0.0001",
            "trade_turnover": "0",
            "vol": "0"
        }
    ],
    "status": "ok",
    "ts": 1603697104902
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
ch true string 数据所属的 channel，格式： market.period
<data> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值（预测资金费率）
close true string 收盘值 （预测资金费率）
low true string 最低值 （预测资金费率）
high true string 最高值 （预测资金费率）
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额, 数值为0
</data>
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒

【通用】获取基差数据


curl "https://api.hbdm.com/index/market/history/linear_swap_basis?contract_code=BTC-USDT&period=1min&size=1"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string 周期 1min,5min, 15min, 30min, 60min,4hour,1day,1week,1mon
basis_price_type false string 基差价格类型，表示在周期内计算基差使用的价格类型， 不填，默认使用开盘价 开盘价：open，收盘价：close，最高价：high，最低价：low，平均价=（最高价+最低价）/2：average
size true int 基差获取数量，默认 150 [1,2000]

Response:


{
    "ch": "market.BTC-USDT.basis.1min.open",
    "data": [
        {
            "basis": "15.29074235666667",
            "basis_rate": "0.001170582317307796",
            "contract_price": "13077.8",
            "id": 1603697160,
            "index_price": "13062.509257643333"
        }
    ],
    "status": "ok",
    "ts": 1603697170804
}

返回参数

参数名称 是否必须 类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.basis
<data> object array
id true long 唯一标识
contract_price true string 合约最新成交价
index_price true string 指数基准价，与基差价格类型匹配
basis true string 基差=合约基准价 - 指数基准价
basis_rate true string 基差率=基差/指数基准价
</data>
status true string 请求处理结果 "ok" , "error"
ts true long 生成时间

合约资产接口

【通用】获取账户总资产估值

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
valuation_asset false string 资产估值币种，即按该币种为单位进行估值，不填默认"BTC" "BTC", "USD", "USDT", "CNY", "EUR", "GBP", "VND", "HKD", "TWD", "MYR", "SGD", "KRW", "RUB", "TRY"

Response: 

{
    "status": "ok",
    "data": [
        {
            "valuation_asset": "BTC",
            "balance": "0.378256726579799383"
        }
    ],
    "ts": 1614045417046
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object array
valuation_asset true string 资产估值币种，即按该币种为单位进行估值 "BTC", "USD", "USDT", "CNY", "EUR", "GBP", "VND", "HKD", "TWD", "MYR", "SGD", "KRW", "RUB", "TRY"
balance true string 资产估值
</data>
ts true long 时间戳

【逐仓】获取用户账户信息

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 "BTC-USDT"... ,如果缺省，默认返回所有合约

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "margin_balance": 99.755058840000000000,
            "margin_position": 0,
            "margin_frozen": 12.730000000000000000,
            "margin_available": 87.025058840000000000,
            "profit_real": 0,
            "profit_unreal": 0,
            "risk_rate": 7.761218290652003142,
            "withdraw_available": 87.025058840000000000000000000000000000,
            "liquidation_price": null,
            "lever_rate": 10,
            "adjust_factor": 0.075000000000000000,
            "margin_static": 99.755058840000000000,
            "contract_code": "BTC-USDT",
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1603697381238
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts long long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
risk_rate true decimal 保证金率
liquidation_price true decimal 预估强平价
withdraw_available true decimal 可划转数量
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

【全仓】获取用户账户信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account false string 保证金账户，不填则返回所有全仓保证金账户 "USDT"，目前只有一个全仓账户（USDT）

Response

{
    "status": "ok",
    "data": [
        {
            "futures_contract_detail": [
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211217",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 10000.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "next_week",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                },
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211210",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 10000.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "this_week",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                },
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211231",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 10000.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "quarter",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                }
            ],
            "margin_mode": "cross",
            "margin_account": "USDT",
            "margin_asset": "USDT",
            "margin_balance": 10000.000000000000000000,
            "margin_static": 10000.000000000000000000,
            "margin_position": 0,
            "margin_frozen": 0,
            "profit_real": 0E-18,
            "profit_unreal": 0,
            "withdraw_available": 1E+4,
            "risk_rate": null,
            "position_mode": "dual_side",
            "contract_detail": [
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 10000.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "swap",
                    "pair": "BTC-USDT",
                    "business_type": "swap"
                }
            ]
        }
    ],
    "ts": 1638757139907
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts long long 响应生成时间点，单位：毫秒
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（所有全仓仓位汇总）
margin_frozen true decimal 冻结保证金（所有全仓仓位汇总）
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏（所有全仓仓位汇总）
withdraw_available true decimal 可划转数量
risk_rate true decimal 保证金率
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
<contract_detail> true object array 支持永续的所有合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</contract_detail>
<futures_contract_detail> true object array 支持交割的所有合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 交割："BTC-USDT-210625" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</futures_contract_detail>
</data>

【逐仓】获取用户持仓信息

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 "BTC-USDT"... ,如果缺省，默认返回所有合约

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "volume": 1.000000000000000000,
            "available": 1.000000000000000000,
            "frozen": 0,
            "cost_open": 13068.000000000000000000,
            "cost_hold": 13068.000000000000000000,
            "profit_unreal": 0,
            "profit_rate": 0,
            "lever_rate": 10,
            "position_margin": 1.306800000000000000,
            "direction": "buy",
            "profit": 0,
            "last_price": 13068,
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"

        }
    ],
    "ts": 1603697821846
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杠倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

备注

【全仓】获取用户持仓信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ， 交割：“BTC-USDT-210625” ...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）

Response:

{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "volume": 1.000000000000000000,
            "available": 1.000000000000000000,
            "frozen": 0E-18,
            "cost_open": 48945.900000000000000000,
            "cost_hold": 48945.900000000000000000,
            "profit_unreal": -0.003800000000000000,
            "profit_rate": -0.000388183688521410,
            "lever_rate": 5,
            "position_margin": 9.788420000000000000,
            "direction": "buy",
            "profit": -0.003800000000000000,
            "last_price": 48942.1,
            "margin_asset": "USDT",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "contract_type": "swap",
            "pair": "BTC-USDT",
            "business_type": "swap",
            "position_mode": "dual_side"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "volume": 1.000000000000000000,
            "available": 1.000000000000000000,
            "frozen": 0E-18,
            "cost_open": 48929.700000000000000000,
            "cost_hold": 48929.700000000000000000,
            "profit_unreal": -0.049800000000000000,
            "profit_rate": -0.005088933715105550,
            "lever_rate": 5,
            "position_margin": 9.775980000000000000,
            "direction": "buy",
            "profit": -0.049800000000000000,
            "last_price": 48879.9,
            "margin_asset": "USDT",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "contract_type": "this_week",
            "pair": "BTC-USDT",
            "business_type": "futures",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1638758525147
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ， 交割：“BTC-USDT-210625” ...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杠倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

【逐仓】查询用户账户和持仓信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"...

备注：

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_balance": 99.751731640000000000,
            "margin_position": 1.306990000000000000,
            "margin_frozen": 12.730000000000000000,
            "margin_available": 85.714741640000000000,
            "profit_real": -0.005227200000000000,
            "profit_unreal": 0.001900000000000000,
            "risk_rate": 7.031347702748238760,
            "withdraw_available": 85.712841640000000000000000000000000000,
            "liquidation_price": null,
            "lever_rate": 10,
            "adjust_factor": 0.075000000000000000,
            "margin_static": 99.749831640000000000,
            "positions": [
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT",
                    "volume": 1.000000000000000000,
                    "available": 1.000000000000000000,
                    "frozen": 0,
                    "cost_open": 13068.000000000000000000,
                    "cost_hold": 13068.000000000000000000,
                    "profit_unreal": 0.001900000000000000,
                    "profit_rate": 0.001453933272115090,
                    "lever_rate": 10,
                    "position_margin": 1.306990000000000000,
                    "direction": "buy",
                    "profit": 0.001900000000000000,
                    "last_price": 13069.9,
                    "margin_asset": "USDT",
                    "margin_mode": "isolated",
                    "margin_account": "BTC-USDT",
                    "position_mode": "dual_side"
                }
            ],
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1603697944138
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts long long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
risk_rate true decimal 保证金率
liquidation_price true decimal 预估强平价
withdraw_available true decimal 可划转数量
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
<positions> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杠倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</positions>
</data>

【全仓】查询用户账户和持仓信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 "USDT"，目前只有一个全仓账户（USDT）

Response

{
    "status": "ok",
    "data": {
        "positions": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "volume": 1.000000000000000000,
                "available": 1.000000000000000000,
                "frozen": 0E-18,
                "cost_open": 48945.900000000000000000,
                "cost_hold": 48945.900000000000000000,
                "profit_unreal": 0.034200000000000000,
                "profit_rate": 0.003493653196692670,
                "lever_rate": 5,
                "position_margin": 9.796020000000000000,
                "direction": "buy",
                "profit": 0.034200000000000000,
                "last_price": 48980.1,
                "margin_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "contract_type": "swap",
                "pair": "BTC-USDT",
                "business_type": "swap",
                "position_mode": "dual_side"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "volume": 1.000000000000000000,
                "available": 1.000000000000000000,
                "frozen": 0E-18,
                "cost_open": 48929.700000000000000000,
                "cost_hold": 48929.700000000000000000,
                "profit_unreal": 0.036900000000000000,
                "profit_rate": 0.003770715945530015,
                "lever_rate": 5,
                "position_margin": 9.793320000000000000,
                "direction": "buy",
                "profit": 0.036900000000000000,
                "last_price": 48966.6,
                "margin_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "position_mode": "dual_side"
            }
        ],
        "futures_contract_detail": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211217",
                "margin_position": 0,
                "margin_frozen": 0,
                "margin_available": 9716.437716790000000000,
                "profit_unreal": 0E-18,
                "liquidation_price": null,
                "lever_rate": 5,
                "adjust_factor": 0.040000000000000000,
                "contract_type": "next_week",
                "pair": "BTC-USDT",
                "business_type": "futures"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "margin_position": 9.793320000000000000,
                "margin_frozen": 0E-18,
                "margin_available": 9716.437716790000000000,
                "profit_unreal": 0.036900000000000000,
                "liquidation_price": null,
                "lever_rate": 5,
                "adjust_factor": 0.040000000000000000,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "margin_position": 0,
                "margin_frozen": 264.000000000000000000,
                "margin_available": 9716.437716790000000000000000000000000000,
                "profit_unreal": 0E-18,
                "liquidation_price": null,
                "lever_rate": 1,
                "adjust_factor": 0.005000000000000000,
                "contract_type": "quarter",
                "pair": "BTC-USDT",
                "business_type": "futures"
            }
        ],
        "margin_mode": "cross",
        "margin_account": "USDT",
        "margin_asset": "USDT",
        "margin_balance": 10000.027056790000000000,
        "margin_static": 9999.955956790000000000,
        "margin_position": 19.589340000000000000,
        "margin_frozen": 264.000000000000000000,
        "profit_real": -0.044043210000000000,
        "profit_unreal": 0.071100000000000000,
        "withdraw_available": 9716.36661679,
        "risk_rate": 4752.827989089613978802,
        "position_mode": "dual_side",
        "contract_detail": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "margin_position": 9.796020000000000000,
                "margin_frozen": 0E-18,
                "margin_available": 9716.437716790000000000,
                "profit_unreal": 0.034200000000000000,
                "liquidation_price": null,
                "lever_rate": 5,
                "adjust_factor": 0.040000000000000000,
                "contract_type": "swap",
                "pair": "BTC-USDT",
                "business_type": "swap"
            }
        ]
    },
    "ts": 1638758699818
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts long long 响应生成时间点，单位：毫秒
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（所有全仓仓位汇总）
margin_frozen true decimal 冻结保证金（所有全仓仓位汇总）
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏（所有全仓仓位汇总）
withdraw_available true decimal 可划转数量
risk_rate true decimal 保证金率
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
<contract_detail> true object array 支持全仓的永续合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</contract_detail>
<futures_contract_detail> true object array 支持全仓的交割合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 交割："BTC-USDT-210625" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</futures_contract_detail>
<positions> true object array 支持全仓的所有合约的仓位
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杠倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</positions>
</data>

【通用】批量设置子账户交易权限

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
sub_uid true string 子账户uid (多个uid中间以","分隔,一次最多允许开通10个子账户)
sub_auth true int 子账户交易权限，1 开启，0关闭

备注：

Response:


{
    "status": "ok",
    "data": {
        "errors": [
            {
                "sub_uid": "1234567",
                "err_code": 1010,
                "err_msg": "Account doesnt exist."
            }
        ],
        "successes": "123456789"
    },
    "ts": 1612504316476
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true
<errors> true object array
sub_uid true string 开通失败的子账户uid
err_code true int 错误码
err_msg true string 错误信息
</errors>
successes true string 开通合约成功的子账户uid列表
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】查询母账户下所有子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码,如果缺省，默认返回所有合约 "BTC-USDT"...

Response:


{
    "status": "ok",
    "data": [
        {
            "sub_uid": 123456789,
            "list": [
                {
                    "symbol": "BTC",
                    "margin_balance": 20,
                    "liquidation_price": null,
                    "risk_rate": null,
                    "contract_code": "BTC-USDT",
                    "margin_asset": "USDT",
                    "margin_mode": "isolated",
                    "margin_account": "BTC-USDT"
                }
            ]
        }
    ],
    "ts": 1603698380336
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
sub_uid true long 子账户UID
<list> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
liquidation_price true decimal 预估强平价
risk_rate true decimal 保证金率
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
</list>
</data>

备注

【全仓】查询母账户下所有子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account false string 保证金账户，不填则返回所有全仓保证金账户 "USDT"，目前只有一个全仓账户（USDT）

Response


{
    "status": "ok",
    "data": [
        {
            "sub_uid": 123456789,
            "list": [
                {
                    "margin_balance": 163.561708129559110889,
                    "risk_rate": 78.896729392251481019,
                    "margin_asset": "USDT",
                    "margin_mode": "cross",
                    "margin_account": "USDT"
                }
            ]
        }
    ],
    "ts": 1606962745633
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
sub_uid true long 子账户UID
<list> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
risk_rate true decimal 保证金率
</list>
</data>

备注

【逐仓】批量获取子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 "BTC-USDT"... ,如果缺省，默认返回所有合约
page_index false int 第几页,不填默认第一页
page_size false int 不填默认20，不得多于50

备注：

Response:

{
    "status": "ok",
    "data": {
        "total_page": 1,
        "current_page": 1,
        "total_size": 1,
        "sub_list": [
            {
                "sub_uid": 123456789,
                "account_info_list": [
                    {
                        "symbol": "BTC",
                        "margin_balance": 0,
                        "liquidation_price": null,
                        "risk_rate": null,
                        "contract_code": "BTC-USDT",
                        "margin_asset": "USDT",
                        "margin_mode": "isolated",
                        "margin_account": "BTC-USDT"
                    }
                ]
            }
        ]
    },
    "ts": 1612504756853
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典类型
<sub_list> true object array
sub_uid true long 子账户UID
<account_info_list> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
liquidation_price true decimal 预估强平价
risk_rate true decimal 保证金率
</account_info_list>
</sub_list>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>

【全仓】批量获取子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account false string 保证金账户，不填则返回所有全仓保证金账户 "USDT"，目前只有一个全仓账户（USDT）
page_index false int 第几页,不填默认第一页
page_size false int 不填默认20，不得多于50

备注：

Response:

{
    "status": "ok",
    "data": {
        "total_page": 1,
        "current_page": 1,
        "total_size": 1,
        "sub_list": [
            {
                "sub_uid": 12345678,
                "account_info_list": [
                    {
                        "margin_balance": 2,
                        "risk_rate": null,
                        "margin_asset": "USDT",
                        "margin_mode": "cross",
                        "margin_account": "USDT"
                    }
                ]
            }
        ]
    },
    "ts": 1612504845679
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典类型
<sub_list> true object array
sub_uid true long 子账户UID
<account_info_list> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
risk_rate true decimal 保证金率
</account_info_list>
</sub_list>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>

【逐仓】查询单个子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 ,如果缺省，默认返回所有合约 "BTC-USDT"...
sub_uid true long 子账户的UID

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "margin_balance": 20,
            "margin_position": 0,
            "margin_frozen": 0,
            "margin_available": 20.000000000000000000,
            "profit_real": 0,
            "profit_unreal": 0,
            "risk_rate": null,
            "withdraw_available": 20.000000000000000000,
            "liquidation_price": null,
            "lever_rate": 5,
            "adjust_factor": 0.040000000000000000,
            "margin_static": 20,
            "contract_code": "BTC-USDT",
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1603698523200
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
risk_rate true decimal 保证金率
liquidation_price true decimal 预估强平价
withdraw_available true decimal 可划转数量
lever_rate true decimal 杠杆倍数
adjust_factor true decimal 调整系数
margin_static true decimal 静态权益
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

备注

【全仓】查询单个子账户资产信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
sub_uid true long 子账户的UID
margin_account false string 保证金账户，不填则返回所有全仓保证金账户 "USDT"，目前只有一个全仓账户（USDT）

Response:


{
    "status": "ok",
    "data": [
        {
            "futures_contract_detail": [
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211217",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 500.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "next_week",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                },
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211210",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 500.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "this_week",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                },
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT-211231",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 500.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "quarter",
                    "pair": "BTC-USDT",
                    "business_type": "futures"
                }
            ],
            "margin_mode": "cross",
            "margin_account": "USDT",
            "margin_asset": "USDT",
            "margin_balance": 500,
            "margin_static": 500,
            "margin_position": 0,
            "margin_frozen": 0,
            "profit_real": 0,
            "profit_unreal": 0,
            "withdraw_available": 5E+2,
            "risk_rate": null,
            "position_mode": "dual_side",
            "contract_detail": [
                {
                    "symbol": "BTC",
                    "contract_code": "BTC-USDT",
                    "margin_position": 0,
                    "margin_frozen": 0,
                    "margin_available": 500.000000000000000000,
                    "profit_unreal": 0E-18,
                    "liquidation_price": null,
                    "lever_rate": 5,
                    "adjust_factor": 0.040000000000000000,
                    "contract_type": "swap",
                    "pair": "BTC-USDT",
                    "business_type": "swap"
                }
            ]
        }
    ],
    "ts": 1638759191747
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts long long 响应生成时间点，单位：毫秒
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
withdraw_available true decimal 可划转数量
risk_rate true decimal 保证金率
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
<contract_detail> true object array 支持全仓的所有合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</contract_detail>
<futures_contract_detail> true object array 支持全仓的所有合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT-211231" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</futures_contract_detail>
</data>

备注

【逐仓】查询单个子账户持仓信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码，如果缺省，默认返回所有合约 "BTC-USDT"...
sub_uid true long 子账户的UID

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "volume": 1.000000000000000000,
            "available": 1.000000000000000000,
            "frozen": 0,
            "cost_open": 13038.700000000000000000,
            "cost_hold": 13038.700000000000000000,
            "profit_unreal": 0,
            "profit_rate": 0,
            "lever_rate": 10,
            "position_margin": 1.303870000000000000,
            "direction": "buy",
            "profit": 0,
            "last_price": 13038.7,
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1603699081114
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杆倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

【全仓】查询单个子账户持仓信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"...，交割：“BTC-USDT-210625”
sub_uid true long 子账户的UID
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "volume": 1.000000000000000000,
            "available": 1.000000000000000000,
            "frozen": 0E-18,
            "cost_open": 48886.700000000000000000,
            "cost_hold": 48886.700000000000000000,
            "profit_unreal": -0.065300000000000000,
            "profit_rate": -0.001335741622977210,
            "lever_rate": 1,
            "position_margin": 48.952000000000000000,
            "direction": "sell",
            "profit": -0.065300000000000000,
            "last_price": 48952,
            "margin_asset": "USDT",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "contract_type": "quarter",
            "pair": "BTC-USDT",
            "business_type": "futures",
            "position_mode": "dual_side"
        }
    ],
    "ts": 1638759509329
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"...，交割：“BTC-USDT-210625”
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 持仓量（张）
available true decimal 可平仓数量（张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杠倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新价
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

【通用】查询用户财务记录(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "mar_acct": "BTC-USDT",
        "type": "3,4,5,6,7",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false string 合约代码 支持大小写,"BTC-USDT" ... contract_code
mar_acct true string 保证金账户 "BTC-USDT","USDT"(查询全仓时使用)... margin_account
type false string 不填查询全部类型,【查询多类型中间用，隔开】 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;
start_time false long 查询开始时间, 以数据按创建时间进行查询 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 138798248,
                "id": 117840,
                "type": 5,
                "amount": -0.024464850000000000,
                "ts": 1638758435635,
                "contract_code": "BTC-USDT-211210",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 下次查询ID
id true long
ts true long 创建时间
asset true string 币种 "USDT"...
contract_code true string 合约代码 "BTC-USDT"...
margin_account true string 保证金账户 "BTC-USDT","USDT"...
face_margin_account true string 对手方保证金账户，仅在type交易类型为34、35、36、37、38、39时有值，其他类型为空字符串 "BTC-USDT"...
type true int 交易类型 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;
amount true decimal 金额（计价货币）
</data>

【通用】组合查询用户财务记录 (新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "mar_acct": "BTC-USDT",
        "type": "3,4,5,6,7",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false string 合约代码 支持大小写,"BTC-USDT" ... contract_code
mar_acct true string 保证金账户 "BTC-USDT","USDT"(查询全仓时使用)... margin_account
type false string 不填查询全部类型,【查询多类型中间用，隔开】 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;
start_time false long 查询开始时间, 以数据按创建时间进行查询 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 138798248,
                "id": 117840,
                "type": 5,
                "amount": -0.024464850000000000,
                "ts": 1638758435635,
                "contract_code": "BTC-USDT-211210",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 下次查询ID
id true long
ts true long 创建时间
asset true string 币种 "USDT"...
contract_code true string 合约代码 "BTC-USDT"...
margin_account true string 保证金账户 "BTC-USDT","USDT"...
face_margin_account true string 对手方保证金账户，仅在type交易类型为34、35、36、37、38、39时有值，其他类型为空字符串 "BTC-USDT"...
type true int 交易类型 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;
amount true decimal 金额（计价货币）
</data>

【逐仓】查询用户结算记录

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约code "BTC-USDT"...
start_time false long 起始时间（时间戳，单位毫秒） 取值范围：[(当前时间 - 90天), 当前时间] ，默认取当前时间- 90天
end_time false long 结束时间（时间戳，单位毫秒） 取值范围：(start_time, 当前时间]，默认取当前时间
page_index false int 页码 不填默认第1页
page_size false int 页大小 不填默认20，不得多于50（超过则按照50进行查询）

备注:

Response: 

{
    "status":"ok",
    "data":{
        "total_page":1,
        "current_page":1,
        "total_size":13,
        "settlement_records":[
            {
                "symbol":"BTC",
                "contract_code":"BTC-USDT",
                "margin_mode":"isolated",
                "margin_account":"BTC-USDT",
                "margin_balance_init":5000,
                "margin_balance":4891.74704672,
                "settlement_profit_real":-108.25295328,
                "settlement_time":1611040802012,
                "clawback":0,
                "funding_fee":0,
                "offset_profitloss":0,
                "fee":-2.63615328,
                "fee_asset":"USDT",
                "positions":[
                    {
                        "symbol":"BTC",
                        "contract_code":"BTC-USDT",
                        "direction":"buy",
                        "volume":12,
                        "cost_open":27900,
                        "cost_hold_pre":27900,
                        "cost_hold":27459.93,
                        "settlement_profit_unreal":-52.8084,
                        "settlement_price":27459.93,
                        "settlement_type":"settlement"
                    },
                    {
                        "symbol":"BTC",
                        "contract_code":"BTC-USDT",
                        "direction":"sell",
                        "volume":12,
                        "cost_open":27019.86,
                        "cost_hold_pre":27019.86,
                        "cost_hold":27459.93,
                        "settlement_profit_unreal":-52.8084,
                        "settlement_price":27459.93,
                        "settlement_type":"settlement"
                    }
                ]
            }
        ]
    },
    "ts":1611052289681
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<settlement_records> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
margin_balance_init true decimal 本期初始账户权益
margin_balance true decimal 本期结算后账户权益
settlement_profit_real true decimal 本期结算已实现盈亏
settlement_time true long 本期结算时间，交割时为交割时间
clawback true decimal 本期分摊费用
funding_fee true decimal 本期资金费（或本期交割费）
offset_profitloss true decimal 本期平仓盈亏
fee true decimal 本期交易手续费
fee_asset true string 手续费币种
<positions> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
direction true string 仓位方向 "buy":买 "sell":卖
volume true decimal 本期结算前持仓量（张）
cost_open true decimal 开仓均价
cost_hold_pre true decimal 本期结算前持仓均价
cost_hold true decimal 本期结算后持仓均价
settlement_profit_unreal true decimal 本期结算未实现盈亏
settlement_price true decimal 本期结算价格，交割时为交割价格
settlement_type true string 结算类型 settlement：结算；delivery：交割；
</positions>
</settlement_records>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>
ts true long 时间戳

【全仓】查询用户结算记录

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 "USDT"，目前只有一个全仓账户（USDT）
start_time false long 起始时间（时间戳，单位毫秒） 取值范围：[(当前时间 - 90天), 当前时间] ，默认取当前时间- 90天
end_time false long 结束时间（时间戳，单位毫秒） 取值范围：(start_time, 当前时间]，默认取当前时间
page_index false int 页码，不填默认第1页
page_size false int 页数，不填默认10 [1-25]

备注:

Response: 

{
    "status":"ok",
    "data":{
        "total_page":2,
        "current_page":1,
        "total_size":13,
        "settlement_records":[
            {
                "margin_mode":"cross",
                "margin_account":"USDT",
                "margin_balance_init":5000,
                "margin_balance":5007.6708,
                "settlement_profit_real":7.6708,
                "settlement_time":1611051602040,
                "clawback":0,
                "funding_fee":0,
                "offset_profitloss":0,
                "fee":0.6708,
                "fee_asset":"USDT",
                "contract_detail":[
                    {
                        "symbol":"BTC",
                        "contract_code":"BTC-USDT",
                        "offset_profitloss":0,
                        "fee":0.6708,
                        "fee_asset":"USDT",
                        "positions":[
                            {
                                "symbol":"BTC-USDT",
                                "contract_code":"BTC-USDT",
                                "direction":"buy",
                                "volume":9,
                                "cost_open":27911.111111111111111111,
                                "cost_hold_pre":27911.111111111111111111,
                                "cost_hold":34361.25,
                                "settlement_profit_unreal":580.5125,
                                "settlement_price":34361.25,
                                "settlement_type":"settlement"
                            },
                            {
                                "symbol":"BTC-USDT",
                                "contract_code":"BTC-USDT",
                                "direction":"sell",
                                "volume":9,
                                "cost_open":27988.888888888888888888,
                                "cost_hold_pre":27988.888888888888888888,
                                "cost_hold":34361.25,
                                "settlement_profit_unreal":-573.5125,
                                "settlement_price":34361.25,
                                "settlement_type":"settlement"
                            }
                        ]
                    }
                ]
            },
            {
                "margin_mode":"cross",
                "margin_account":"USDT",
                "margin_balance_init":5000,
                "margin_balance":5000,
                "settlement_profit_real":0,
                "settlement_time":1611047654316,
                "clawback":0,
                "funding_fee":0,
                "offset_profitloss":0,
                "fee":0,
                "fee_asset":"USDT",
                "contract_detail":[

                ]
            }
        ]
    },
    "ts":1611051729365
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<settlement_records> true object array
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如“USDT”
margin_balance_init true decimal 本期初始账户权益
margin_balance true decimal 本期结算后账户权益
settlement_profit_real true decimal 本期结算已实现盈亏
settlement_time true long 本期结算时间，交割时为交割时间
clawback true decimal 本期分摊费用
funding_fee true decimal 本期总资金费（包含交割费）
offset_profitloss true decimal 本期总平仓盈亏
fee true decimal 本期总交易手续费
fee_asset true string 手续费币种
<contract_detail> true object array 支持全仓的所有合约的相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ... ， 交割："BTC-USDT-210625" ...
offset_profitloss true decimal 本期该合约平仓盈亏
fee true decimal 本期该合约交易手续费
fee_asset true string 手续费币种
pair true string 交易对 如：“BTC-USDT”
<positions> true object array 该合约仓位（结算时有持仓量的才有值）
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ... ， 交割："BTC-USDT-210625" ...
direction true string 仓位方向 "buy":买 "sell":卖
volume true decimal 本期结算前持仓量（张）
cost_open true decimal 开仓均价
cost_hold_pre true decimal 本期结算前持仓均价
cost_hold true decimal 本期结算后持仓均价
settlement_profit_unreal true decimal 本期结算未实现盈亏
settlement_price true decimal 本期结算价格，交割时为交割价格
settlement_type true string 结算类型 settlement：结算；delivery：交割；
pair true string 交易对 如：“BTC-USDT”
</positions>
</contract_detail> true
</settlement_records>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>
ts true long 时间戳

【逐仓】查询用户可用杠杆倍数

备注

请求参数：

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码，不填默认返回所有合约的实际可用杠杆倍数 比如： “BTC-USDT”...

返回示例：


{
    "status": "ok",
    "data": [
        {
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "available_level_rate": "1,2,3,5"
        }
    ],
    "ts": 1603699467348
}

返回参数：

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array 字典数据
contract_code true string 合约代码 比如："BTC-USDT"
margin_mode true string 保证金模式 isolated：逐仓模式
available_level_rate true string 实际可用杠杆倍数，多个以英文逗号隔开 比如："1,5,10"
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询用户可用杠杆倍数

备注

请求参数

参数名 参数类型 必填 描述 取值范围
contract_code false string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false(请看备注) string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response


{
    "status": "ok",
    "data": [
        {
            "contract_code": "ETH-USDT",
            "available_level_rate": "1,2,3,5",
            "margin_mode": "cross",
            "contract_type": "swap",
            "pair": "ETH-USDT",
            "business_type": "swap"
        },
        {
            "contract_code": "ETH-USDT-211210",
            "available_level_rate": "1,2,3,5",
            "margin_mode": "cross",
            "contract_type": "this_week",
            "pair": "ETH-USDT",
            "business_type": "futures"
        },
        {
            "contract_code": "ETH-USDT-211217",
            "available_level_rate": "1,2,3,5",
            "margin_mode": "cross",
            "contract_type": "next_week",
            "pair": "ETH-USDT",
            "business_type": "futures"
        },
        {
            "contract_code": "ETH-USDT-211231",
            "available_level_rate": "1,2,3,5",
            "margin_mode": "cross",
            "contract_type": "quarter",
            "pair": "ETH-USDT",
            "business_type": "futures"
        }
    ],
    "ts": 1638760001689
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array 字典数据
contract_code true string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
margin_mode true string 保证金模式 cross：全仓模式；
available_level_rate true string 实际可用杠杆倍数，多个以英文逗号隔开 比如："1,5,10"
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>
ts true long 响应生成时间点，单位：毫秒

【通用】查询用户当前的下单量限制

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续"BTC-USDT"... ，交割："BTC-USDT-220325"...
order_price_type true string 订单报价类型 "limit":限价，"opponent":对手价，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单,opponent_ioc"： 对手价-IOC下单，"lightning_ioc"：闪电平仓-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:


{
    "status": "ok",
    "data": {
        "order_price_type": "limit",
        "list": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "open_limit": 170000.000000000000000000,
                "close_limit": 170000.000000000000000000,
                "business_type": "swap",
                "contract_type": "swap",
                "pair": "BTC-USDT"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211217",
                "open_limit": 170000.000000000000000000,
                "close_limit": 170000.000000000000000000,
                "business_type": "futures",
                "contract_type": "next_week",
                "pair": "BTC-USDT"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "open_limit": 170000.000000000000000000,
                "close_limit": 170000.000000000000000000,
                "business_type": "futures",
                "contract_type": "this_week",
                "pair": "BTC-USDT"
            },
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "open_limit": 170000.000000000000000000,
                "close_limit": 170000.000000000000000000,
                "business_type": "futures",
                "contract_type": "quarter",
                "pair": "BTC-USDT"
            }
        ]
    },
    "ts": 1638760136200
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data>
order_price_type true string 订单报价类型 "limit":限价，"opponent":对手价，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单,opponent_ioc"： 对手价-IOC下单，"lightning_ioc"：闪电平仓-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
<list>(属性名称：list)
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续"BTC-USDT"... ，交割："BTC-USDT-220325"...
open_limit true decimal 合约开仓单笔下单量最大值
close_limit true decimal 合约平仓单笔下单量最大值
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</list>
</data>

【通用】查询用户当前的手续费费率

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割：“BTC-USDT-210625” ...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:

{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "open_maker_fee": "0.0002",
            "open_taker_fee": "0.0004",
            "close_maker_fee": "0.0002",
            "close_taker_fee": "0.0004",
            "fee_asset": "USDT",
            "delivery_fee": "0",
            "business_type": "swap",
            "contract_type": "swap",
            "pair": "BTC-USDT"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211217",
            "open_maker_fee": "0.0002",
            "open_taker_fee": "0.0005",
            "close_maker_fee": "0.0002",
            "close_taker_fee": "0.0005",
            "fee_asset": "USDT",
            "delivery_fee": "0.00015",
            "business_type": "futures",
            "contract_type": "next_week",
            "pair": "BTC-USDT"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "open_maker_fee": "0.0002",
            "open_taker_fee": "0.0005",
            "close_maker_fee": "0.0002",
            "close_taker_fee": "0.0005",
            "fee_asset": "USDT",
            "delivery_fee": "0.00015",
            "business_type": "futures",
            "contract_type": "this_week",
            "pair": "BTC-USDT"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "open_maker_fee": "0.0002",
            "open_taker_fee": "0.0005",
            "close_maker_fee": "0.0002",
            "close_taker_fee": "0.0005",
            "fee_asset": "USDT",
            "delivery_fee": "0.00015",
            "business_type": "futures",
            "contract_type": "quarter",
            "pair": "BTC-USDT"
        }
    ],
    "ts": 1638760715804
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割：“BTC-USDT-210625” ...
open_maker_fee true string 开仓挂单的手续费费率，小数形式
open_taker_fee true string 开仓吃单的手续费费率，小数形式
close_maker_fee true string 平仓挂单的手续费费率，小数形式
close_taker_fee true string 平仓吃单的手续费费率，小数形式
fee_asset true string 手续费币种 "USDT"...
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
delivery_fee true string 交割的手续费费率，小数形式
</data>

【逐仓】查询用户当前的划转限制

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 "BTC-USDT"... ,如果缺省，默认返回所有合约

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "transfer_in_max_each": 100000000.000000000000000000,
            "transfer_in_min_each": 1.000000000000000000,
            "transfer_out_max_each": 10000000.000000000000000000,
            "transfer_out_min_each": 0.000001000000000000,
            "transfer_in_max_daily": 1000000000.000000000000000000,
            "transfer_out_max_daily": 200000000.000000000000000000,
            "net_transfer_in_max_daily": 500000000.000000000000000000,
            "net_transfer_out_max_daily": 100000000.000000000000000000
        }
    ],
    "ts": 1603699803580
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
transfer_in_max_each true decimal 单笔最大转入量
transfer_in_min_each true decimal 单笔最小转入量
transfer_out_max_each true decimal 单笔最大转出量
transfer_out_min_each true decimal 单笔最小转出量
transfer_in_max_daily true decimal 单日累计最大转入量
transfer_out_max_daily true decimal 单日累计最大转出量
net_transfer_in_max_daily true decimal 单日累计最大净转入量
net_transfer_out_max_daily true decimal 单日累计最大净转出量
</data>

【全仓】查询用户当前的划转限制

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account false string 保证金账户，不填则返回所有全仓保证金账户 "USDT"，目前只有一个全仓账户（USDT）

Response:


{
    "status": "ok",
    "data": [
        {
            "transfer_in_max_each": 999999999999999999,
            "transfer_in_min_each": 0.0001,
            "transfer_out_max_each": 999999999999999999,
            "transfer_out_min_each": 0.0001,
            "transfer_in_max_daily": 900000000999999999,
            "transfer_out_max_daily": 900000099999999999,
            "net_transfer_in_max_daily": 900000000099999999,
            "net_transfer_out_max_daily": 123456789012345678.12345678,
            "margin_account": "USDT",
            "margin_mode": "cross"
        }
    ],
    "ts": 1606964432217
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
transfer_in_max_each true decimal 单笔最大转入量
transfer_in_min_each true decimal 单笔最小转入量
transfer_out_max_each true decimal 单笔最大转出量
transfer_out_min_each true decimal 单笔最小转出量
transfer_in_max_daily true decimal 单日累计最大转入量
transfer_out_max_daily true decimal 单日累计最大转出量
net_transfer_in_max_daily true decimal 单日累计最大净转入量
net_transfer_out_max_daily true decimal 单日累计最大净转出量
</data>

【逐仓】用户持仓量限制的查询

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 "BTC-USDT"... ,如果缺省，默认返回所有合约

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "buy_limit": 1026154,
            "sell_limit": 1026154,
            "margin_mode": "isolated",
            "lever_rate": 5,
            "buy_limit_value": 50000000.000000000000000000,
            "sell_limit_value": 50000000.000000000000000000,
            "mark_price": 48725.6
        }
    ],
    "ts": 1638770954672
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
buy_limit true decimal 合约多仓持仓的最大值，单位为张
sell_limit true decimal 合约空仓持仓的最大值，单位为张
lever_rate true int 用户当前品种杠杆倍数
buy_limit_value true decimal 合约多仓持仓价值上限，单位USDT
sell_limit_value true decimal 合约空仓持仓价值上限，单位USDT
mark_price true decimal 当前品种标记价格（以该价格用于计算持仓张数）
</data>

【全仓】用户持仓量限制的查询

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割：”BTC-USDT-210625“
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "cross",
            "buy_limit": 1021671,
            "sell_limit": 1021671,
            "business_type": "swap",
            "contract_type": "swap",
            "pair": "BTC-USDT",
            "lever_rate": 5,
            "buy_limit_value": 50000000.000000000000000000,
            "sell_limit_value": 50000000.000000000000000000,
            "mark_price": 48939.4
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211217",
            "margin_mode": "cross",
            "buy_limit": 1021865,
            "sell_limit": 1021865,
            "business_type": "futures",
            "contract_type": "next_week",
            "pair": "BTC-USDT",
            "lever_rate": 5,
            "buy_limit_value": 50000000.000000000000000000,
            "sell_limit_value": 50000000.000000000000000000,
            "mark_price": 48930.1
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "margin_mode": "cross",
            "buy_limit": 1023478,
            "sell_limit": 1023478,
            "business_type": "futures",
            "contract_type": "this_week",
            "pair": "BTC-USDT",
            "lever_rate": 5,
            "buy_limit_value": 50000000.000000000000000000,
            "sell_limit_value": 50000000.000000000000000000,
            "mark_price": 48853
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "margin_mode": "cross",
            "buy_limit": 1021867,
            "sell_limit": 1021867,
            "business_type": "futures",
            "contract_type": "quarter",
            "pair": "BTC-USDT",
            "lever_rate": 1,
            "buy_limit_value": 50000000.000000000000000000,
            "sell_limit_value": 50000000.000000000000000000,
            "mark_price": 48930
        }
    ],
    "ts": 1638760890261
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割：”BTC-USDT-210625“
margin_mode true string 保证金模式 cross：全仓模式；
buy_limit true decimal 合约多仓持仓的最大值，单位为张
sell_limit true decimal 合约空仓持仓的最大值，单位为张
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
lever_rate true int 用户当前品种杠杆倍数
buy_limit_value true decimal 合约多仓持仓价值上限，单位USDT
sell_limit_value true decimal 合约空仓持仓价值上限，单位USDT
mark_price true decimal 当前品种标记价格（以该价格用于计算持仓张数）
</data>

【逐仓】查询用户所有杠杆持仓量限制

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码，不填返回全部 如"BTC-USDT"、"ETH-USDT"
lever_rate false int 杠杆倍数，不填返回所有杠杆倍数

备注

Response:

{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "isolated",
            "list": [
                {
                    "lever_rate": 2,
                    "buy_limit_value": 50000000.000000000000000000,
                    "sell_limit_value": 50000000.000000000000000000
                }
            ]
        }
    ],
    "ts": 1638769536897
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
<list> true object array
lever_rate true int 品种杠杆倍数
buy_limit_value true decimal 合约多仓持仓价值上限，单位USDT
sell_limit_value true decimal 合约空仓持仓价值上限，单位USDT
</list>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询用户所有杠杆持仓量限制

请求参数

参数名称 是否必须 类型 描述 取值范围
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部
contract_type false string 合约类型，不填返回全部 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair false string 交易对，不填返回全部 如：“BTC-USDT”
contract_code false string 合约代码，不填返回全部 永续："BTC-USDT"... 交割："BTC-USDT-211231"...
lever_rate false int 杠杆倍数，不填返回所有杠杆倍数

备注

Response:

{
    "status": "ok",
    "data": [
        {
            "business_type": "swap",
            "contract_type": "swap",
            "pair": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "cross",
            "list": [
                {
                    "lever_rate": 2,
                    "buy_limit_value": 50000000.000000000000000000,
                    "sell_limit_value": 50000000.000000000000000000
                }
            ]
        },
        {
            "business_type": "futures",
            "contract_type": "next_week",
            "pair": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211217",
            "margin_mode": "cross",
            "list": [
                {
                    "lever_rate": 2,
                    "buy_limit_value": 50000000.000000000000000000,
                    "sell_limit_value": 50000000.000000000000000000
                }
            ]
        },
        {
            "business_type": "futures",
            "contract_type": "this_week",
            "pair": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "margin_mode": "cross",
            "list": [
                {
                    "lever_rate": 2,
                    "buy_limit_value": 50000000.000000000000000000,
                    "sell_limit_value": 50000000.000000000000000000
                }
            ]
        },
        {
            "business_type": "futures",
            "contract_type": "quarter",
            "pair": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "margin_mode": "cross",
            "list": [
                {
                    "lever_rate": 2,
                    "buy_limit_value": 50000000.000000000000000000,
                    "sell_limit_value": 50000000.000000000000000000
                }
            ]
        }
    ],
    "ts": 1638769370732
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... 交割："BTC-USDT-211231"...
margin_mode true string 保证金模式 cross：全仓模式
business_type true string 业务类型 futures：交割、swap：永续
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
<list> true object array
lever_rate true int 品种杠杆倍数
buy_limit_value true decimal 合约多仓持仓价值上限，单位USDT
sell_limit_value true decimal 合约空仓持仓价值上限，单位USDT
</list>
</data>
ts true long 响应生成时间点，单位：毫秒

【通用】母子账户划转

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
sub_uid true long 子账号uid
asset true string 币种 "USDT"...
from_margin_account true string 转出的保证金账户 "BTC-USDT"，"USDT"...
to_margin_account true string 转入的保证金账户 "BTC-USDT"，"USDT"...
amount true decimal 划转金额
type true string 划转类型 master_to_sub：母账户划转到子账户， sub_to_master：子账户划转到母账户
client_order_id false long 客户自己填写和维护的订单号，必须为数字 [1-9223372036854775807]

备注：

Response:


{
    "status": "ok",
    "data": {
        "order_id": "770320047276195840"
    },
    "ts": 1603700211160
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
order_id true string 划转订单ID
client_order_id false long 用户下单时填写的客户端订单ID，没填则不返回
</data>

【通用】获取母账户下的所有母子账户划转记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 "BTC-USDT"，"USDT"...
transfer_type false string 划转类型，不填查询全部类型,【查询多类型中间用，隔开】 34:转出到子账号合约账户; 35:从子账号合约账户转入;
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页 1
page_size false int 不填默认20，不得多于50 20

Response:


{
    "status": "ok",
    "data": {
        "total_page": 2,
        "current_page": 1,
        "total_size": 2,
        "transfer_record": [
            {
                "id": 57920,
                "transfer_type": 34,
                "amount": -10.000000000000000000,
                "ts": 1603700211125,
                "sub_uid": "123436789",
                "sub_account_name": "tom",
                "margin_account": "BTC-USDT",
                "asset": "USDT",
                "to_margin_account": "BTC-USDT",
                "from_margin_account": "BTC-USDT"
            }
        ]
    },
    "ts": 1603700414957
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
<transfer_record> true object array
id true long 划转订单ID
ts true long 创建时间
asset true string 币种 "USDT"...
margin_account true string 保证金账户 "BTC-USDT"...
from_margin_account true string 转出的保证金账户 "BTC-USDT"...
to_margin_account true string 转入的保证金账户 "BTC-USDT"...
sub_uid true string 子账户UID
sub_account_name true string 子账户登录名
transfer_type true int 划转类型 34:转出到子账号合约账户; 35:从子账号合约账户转入;
amount true decimal 金额
</transfer_record>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>

【通用】同账号不同保证金账户的划转

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
asset true string 币种 "USDT"...
from_margin_account true string 转出的保证金账户 "BTC-USDT"，"USDT"...
to_margin_account true string 转入的保证金账户 "ETH-USDT"，"USDT"...
amount true decimal 划转数额（单位为合约的计价币种）
client_order_id false long 客户自己填写和维护的订单号,必须为数字 [1-9223372036854775807]

备注：

返回示例：


{
    "status": "ok",
    "data": {
        "order_id": "770321554893758464"
    },
    "ts": 1603700570600
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> 字典数据
order_id true string 划转订单ID
client_order_id false long 用户下单时填写的客户端订单ID，没填则不返回
</data>
ts true long 响应生成时间点，单位：毫秒

【通用】获取用户的API指标禁用信息

备注

请求参数

无

例子：


{
  "status": "ok",
  "data":
  [{
      "is_disable": 1,   //是否被禁用
      "order_price_types": "limit,post_only,FOK,IOC",  // 触发禁用的订单价格类型
      "disable_reason":"COR",  // 触发禁用的原因
      "disable_interval": 5,  // 禁用时间间隔
      "recovery_time": 1, // 计划恢复时间
      "COR":  //撤单率的指标（Cancel Order Ratio）
       {
           "orders_threshold": 150,  //委托单笔数的阈值
           "orders": 150,  //用户委托单笔数的实际值
           "invalid_cancel_orders": 150,  //委托单中的无效撤单笔数 
           "cancel_ratio_threshold": 0.98,   //撤单率的阈值
           "cancel_ratio": 0.98,   //用户撤单率的实际值
           "is_trigger": 1,  //用户是否触发该指标
           "is_active": 1   //该指标是否开启
      } ,
      "TDN":  //总禁用次数的指标（Total  Disable Number）
       {
           "disables_threshold": 3,  //总禁用次数的阈值
           "disables": 3,  //总禁用次数的实际值
           "is_trigger": 1,  //用户是否触发该指标
           "is_active": 1   //该指标是否开启
      } 
   }],
 "ts": 158797866555
}

Response:

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
is_disable true int 是否被禁用 1：被禁用中，0：没有被禁用
order_price_types true string 触发禁用的订单价格类型，多个订单价格类型以英文逗号分割，例如：“limit,post_only,FOK,IOC”
disable_reason true string 触发禁用的原因，表示当前的禁用是由哪个指标触发 "COR":撤单率（Cancel Order Ratio），“TDN”：总禁用次数（Total Disable Number）
disable_interval true long 禁用时间间隔，单位：毫秒
recovery_time true long 计划恢复时间，单位：毫秒
<COR> true object 表示撤单率的指标（Cancel Order Ratio）
orders_threshold true long 委托单笔数的阈值
orders true long 用户委托单笔数的实际值
invalid_cancel_orders true long 用户委托单中的无效撤单笔数
cancel_ratio_threshold true decimal 撤单率的阈值
cancel_ratio true decimal 用户撤单率的实际值
is_trigger true int 用户是否触发该指标 1：已经触发，0：没有触发
is_active true int 该指标是否开启
</COR>
<TDN> true object 表示总禁用次数的指标（Total Disable Number）
disables_threshold true long 总禁用次数的阈值
disables true long 总禁用次数的实际值
is_trigger true int 用户是否触发该指标 1：已经触发，0：没有触发
is_active true int 该指标是否开启
</TDN>
</data>

合约交易接口

【全仓】查询系统交易权限

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
contract_type false string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type false(请看备注) string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211210",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "open": 1,
            "close": 1,
            "cancel": 1,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "this_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211217",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "open": 1,
            "close": 1,
            "cancel": 1,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "next_week"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "open": 1,
            "close": 1,
            "cancel": 1,
            "business_type": "futures",
            "pair": "BTC-USDT",
            "contract_type": "quarter"
        },
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "cross",
            "margin_account": "USDT",
            "open": 1,
            "close": 1,
            "cancel": 1,
            "business_type": "swap",
            "pair": "BTC-USDT",
            "contract_type": "swap"
        }
    ],
    "ts": 1638756343093
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
open true int 开仓下单权限："1"表示可用，“0”表示不可用
close true int 平仓下单权限："1"表示可用，“0”表示不可用
cancel true int 撤单权限："1"表示可用，“0”表示不可用
</data>

【逐仓】切换持仓模式

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 比如： "BTC-USDT"，"ETH-USDT" ...
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓

response

{
    "status":"ok",
    "data":[
        {
            "margin_account":"BTC-USDT",
            "position_mode":"single_side"
        }
    ],
    "ts":1566899973811
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array 字典数据
margin_account true string 保证金账户 比如： "BTC-USDT"，"ETH-USDT" ...
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】切换持仓模式

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 比如： "USDT"
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓

response

{
    "status":"ok",
    "data":[
        {
            "margin_account":"USDT",
            "position_mode":"single_side"
        }
    ],
    "ts":1566899973811
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array 字典数据
margin_account true string 保证金账户 比如："USDT"
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】合约下单

示例

备注

Request

{
    "contract_code": "btc-usdt",
    "direction": "buy",
    "offset":"open",
    "price":"29999",
    "lever_rate": 5,
    "volume": 1,
    "order_price_type":"opponent",
    "tp_trigger_price": 31000,
    "tp_order_price": 31000,
    "tp_order_price_type": "optimal_5",
    "sl_trigger_price": "29100",
    "sl_order_price": "29100",
    "sl_order_price_type": "optimal_5"
}

请求参数

参数名 参数类型 必填 描述 取值范围
contract_code string true 合约代码 "BTC-USDT"...
reduce_only int false 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
client_order_id long false 客户自己填写和维护，必须为数字 [1-9223372036854775807]
price decimal false 价格
volume long true 委托数量(张)
direction string true 仓位方向 "buy":买 "sell":卖
offset string false(请看备注) 开平方向 "open":开 "close":平 “both”:单向持仓
lever_rate int true 杠杆倍数[“开仓”若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。
order_price_type string true "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
tp_trigger_price decimal false 止盈触发价格
tp_order_price decimal false 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type string false 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price decimal false 止损触发价格
sl_order_price decimal false 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type string false 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20

备注

开平方向

开多：买入开多(direction用buy、offset用open)

平多：卖出平多(direction用sell、offset用close)

开空：卖出开空(direction用sell、offset用open)

平空：买入平空(direction用buy、offset用close)

Response:


{
    "status": "ok",
    "data": {
        "order_id": 770323133537685504,
        "client_order_id": 57012021022,
        "order_id_str": "770323133537685504"
    },
    "ts": 1603700946949
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id false long 用户下单时填写的客户端订单ID，没填则不返回
</data>
ts true long 响应生成时间点，单位：毫秒

备注

【全仓】合约下单

备注

Request

{
    "contract_code": "btc-usdt",
    "direction": "buy",
    "offset":"open",
    "price":"29999",
    "lever_rate": 5,
    "volume": 1,
    "order_price_type":"opponent",
    "tp_trigger_price": 31000,
    "tp_order_price": 31000,
    "tp_order_price_type": "optimal_5",
    "sl_trigger_price": "29100",
    "sl_order_price": "29100",
    "sl_order_price_type": "optimal_5"
}

请求参数

参数名 必填 参数类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
client_order_id false long 客户自己填写和维护，必须为数字 [1-9223372036854775807]
price false decimal 价格
volume true long 委托数量(张)
direction true string 仓位方向 "buy":买 "sell":卖
offset false（请看备注） string 开平方向 "open":开 "close":平 “both”:单向持仓
lever_rate true int 杠杆倍数,“开仓”若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
tp_trigger_price decimal false 止盈触发价格
tp_order_price decimal false 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type string false 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price decimal false 止损触发价格
sl_order_price decimal false 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type string false 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20

备注

开平方向

开多：买入开多(direction用buy、offset用open)

平多：卖出平多(direction用sell、offset用close)

开空：卖出开空(direction用sell、offset用open)

平空：买入平空(direction用buy、offset用close)

Response


{
    "status": "ok",
    "data": {
        "order_id": 784017187857760256,
        "order_id_str": "784017187857760256"
    },
    "ts": 1606965863952
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id false long 用户下单时填写的客户端订单ID，没填则不返回
</data>
ts true long 响应生成时间点，单位：毫秒

备注

order_id返回是18位，nodejs和javascript默认解析18有问题，nodejs和javascript里面JSON.parse默认是int，超过18位的数字用json-bigint的包解析。

【逐仓】合约批量下单

示例

备注

Request

{
    "orders_data": [
        {
            "contract_code": "btc-usdt",
            "direction": "sell",
            "offset": "open",
            "price": "29999",
            "lever_rate": 5,
            "volume": 1,
            "order_price_type": "opponent",
            "tp_trigger_price": 27000,
            "tp_order_price": 27000,
            "tp_order_price_type": "optimal_5",
            "sl_trigger_price": "30100",
            "sl_order_price": "30100",
            "sl_order_price_type": "optimal_5"
        },
        {
            "contract_code": "btc-usdt",
            "direction": "buy",
            "offset": "open",
            "price": "29999",
            "lever_rate": 5,
            "volume": 1,
            "order_price_type": "post_only",
            "tp_trigger_price": 31000,
            "tp_order_price": 31000,
            "tp_order_price_type": "optimal_5",
            "sl_trigger_price": "29100",
            "sl_order_price": "29100",
            "sl_order_price_type": "optimal_5"
        }
    ]
}

请求参数

参数名 参数类型 必填 描述
orders_data List<Object>
参数名 参数类型 必填 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"...
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
client_order_id false long 客户自己填写和维护，必须为数字 [1-9223372036854775807]
price false decimal 价格
volume true long 委托数量(张)
direction true string 仓位方向 "buy":买 "sell":卖
offset false(请看备注) string 开平方向 "open":开 "close":平 “both”:单向持仓
lever_rate true int 杠杆倍数[“开仓”若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
tp_trigger_price decimal false 止盈触发价格
tp_order_price decimal false 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type string false 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price decimal false 止损触发价格
sl_order_price decimal false 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type string false 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20

备注

一次最多允许10个订单。

Response:


{
    "status": "ok",
    "data": {
        "errors": [
            {
                "index": 2,
                "err_code": 1050,
                "err_msg": "Customers order number is repeated. Please try again later."
            }
        ],
        "success": [
            {
                "order_id": 770323847022211072,
                "client_order_id": 57012021024,
                "index": 1,
                "order_id_str": "770323847022211072"
            }
        ]
    },
    "ts": 1603701117058
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
<errors> true object array
index true int 订单索引
err_code true int 错误码
err_msg true string 错误信息
</errors>
<success>
index true int 订单索引
order_id true long 订单ID
order_id_str true string string格式的订单ID
client_order_id true long 用户下单时填写的客户端订单ID，没填则不返回
</success>
</data>
ts true long 响应生成时间点，单位：毫秒

备注

【全仓】合约批量下单

备注

Request

{
    "orders_data": [
        {
            "contract_code": "btc-usdt",
            "direction": "sell",
            "offset": "open",
            "price": "29999",
            "lever_rate": 5,
            "volume": 1,
            "order_price_type": "opponent",
            "tp_trigger_price": 27000,
            "tp_order_price": 27000,
            "tp_order_price_type": "optimal_5",
            "sl_trigger_price": "30100",
            "sl_order_price": "30100",
            "sl_order_price_type": "optimal_5"
        },
        {
            "contract_code": "btc-usdt",
            "direction": "buy",
            "offset": "open",
            "price": "29999",
            "lever_rate": 5,
            "volume": 1,
            "order_price_type": "post_only",
            "tp_trigger_price": 31000,
            "tp_order_price": 31000,
            "tp_order_price_type": "optimal_5",
            "sl_trigger_price": "29100",
            "sl_order_price": "29100",
            "sl_order_price_type": "optimal_5"
        }
    ]
}

请求参数

参数名称 是否必须 类型 描述 取值范围
<orders_data> true object array
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ， 交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
client_order_id false long 客户自己填写和维护，必须为数字 [1-9223372036854775807]
price false decimal 价格
volume true long 委托数量(张)
direction true string 仓位方向 "buy":买 "sell":卖
offset false（请看备注） string 开平方向 "open":开 "close":平 “both”:单向持仓
lever_rate true int 杠杆倍数,“开仓”若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
tp_trigger_price decimal false 止盈触发价格
tp_order_price decimal false 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type string false 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price decimal false 止损触发价格
sl_order_price decimal false 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type string false 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
</orders_data>

备注

Response:

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "index": 2,
                "err_code": 1045,
                "err_msg": "Unable to switch leverage due to open orders."
            }
        ],
        "success": [
            {
                "order_id": 784022175422087168,
                "index": 1,
                "order_id_str": "784022175422087168"
            }
        ]
    },
    "ts": 1606967053089
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
<errors> true object array
index true int 订单索引
err_code true int 错误码
err_msg true string 错误信息
</errors>
<success>
index true int 订单索引
order_id true long 订单ID
order_id_str true string string格式的订单ID
client_order_id true long 用户下单时填写的客户端订单ID，没填则不返回
</success>
</data>
ts true long 响应生成时间点，单位：毫秒

备注

【逐仓】撤销订单

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
order_id false (请看备注) string 订单ID(多个订单ID中间以","分隔,一次最多允许撤消10个订单)
client_order_id false (请看备注) string 客户订单ID(多个订单ID中间以","分隔,一次最多允许撤消10个订单)
contract_code true string 合约代码 "BTC-USDT" ...

备注：

Response:


{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "770323133537685504",
                "err_code": 1071,
                "err_msg": "Repeated withdraw."
            }
        ],
        "successes": "770323847022211072"
    },
    "ts": 1603701351602
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data>
<errors>
order_id true string 订单ID
err_code true int 错误码
err_msg true string 错误信息
</errors>
successes true string 撤销成功的订单的order_id或client_order_id列表
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】撤销订单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
order_id false (请看备注) string 订单ID(多个订单ID中间以","分隔,一次最多允许撤消10个订单)
client_order_id false (请看备注) string 客户订单ID(多个订单ID中间以","分隔,一次最多允许撤消10个订单)
contract_code false (请看备注) string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
pair false (请看备注) string 交易对 BTC-USDT
contract_type false (请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）

备注：

Response


{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "784054331179532288",
                "err_code": 1062,
                "err_msg": "Cancelling. Please be patient."
            }
        ],
        "successes": "784054331179532288"
    },
    "ts": 1606974744952
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
<errors> true object array
order_id true string 订单ID
err_code true int 错误码
err_msg true string 错误信息
</errors>
successes true string 撤销成功的订单的order_id或client_order_id列表
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】全部撤单

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

备注：

Response:(多笔订单返回结果(成功订单ID,失败订单ID))


{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "768883002062282752,770325103371542528,770325103388319744"
    },
    "ts": 1603701437838
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data>
<errors>
order_id true string 订单id
err_code true int 订单失败错误码
err_msg true string 订单失败信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】全部撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续："BTC-USDT"... ， 交割："BTC-USDT-210625"...
pair false(请看备注) string 交易对 BTC-USDT
contract_type false(请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

备注：

Response


{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "784055473531781120,784055473842159616"
    },
    "ts": 1606974998510
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
<errors> true object array
order_id true string 订单id
err_code true int 订单失败错误码
err_msg true string 订单失败信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】切换杠杆

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 比如“BTC-USDT”
lever_rate true int 要切换的杠杆倍数；高倍杠杆风险系数较大，请谨慎使用。

响应示例


正确：
{
    "status": "ok",
    "data": {
        "contract_code": "btc-usdt",
        "margin_mode": "isolated",
        "lever_rate": 10
    },
    "ts": 1603699417036
}
错误：
{
    "status": "error",
    "err_code": 1045,
    "err_msg": "Unable to switch leverage due to current holdings or open orders.",
    "ts": 1603701654205
}

响应参数

参数名称 是否必须 类型 描述 取值范围
status true string 响应状态: ok,error
<data> false object
contract_code false string 合约代码
margin_mode false string 保证金模式 isolated：逐仓模式
lever_rate false int 切换成功后的杠杆倍数
</data>
err_code false int 错误码
err_msg false string 错误信息
ts true long 时间戳

【全仓】切换杠杆

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-210625"...
pair false(请看备注) string 交易对 BTC-USDT
contract_type false(请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
lever_rate true int 要切换的杠杆倍数；高倍杠杆风险系数较大，请谨慎使用。

Response


{
    "status": "ok",
    "data": {
        "contract_type": "swap",
        "pair": "BTC-USDT",
        "business_type": "swap",
        "contract_code": "BTC-USDT",
        "lever_rate": 2,
        "margin_mode": "cross"
    },
    "ts": 1639099382678
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 响应状态: ok,error
<data> false object
contract_code false string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-210625"...
margin_mode false string 保证金模式 cross：全仓模式；
lever_rate false int 切换成功后的杠杆倍数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>
err_code false int 错误码
err_msg false string 错误信息
ts true long 时间戳

【逐仓】获取合约订单信息

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
order_id false（请看备注） string 订单ID(多个订单ID中间以","分隔,一次最多允许查询50个订单)
client_order_id false（请看备注） string 客户订单ID(多个订单ID中间以","分隔,一次最多允许查询50个订单)
contract_code true string 合约代码 "BTC-USDT"...

备注：

Response:


{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "volume": 1,
            "price": 13059.8,
            "order_price_type": "opponent",
            "order_type": 1,
            "direction": "sell",
            "offset": "open",
            "lever_rate": 10,
            "order_id": 770334322963152896,
            "client_order_id": 57012021045,
            "created_at": 1603703614712,
            "trade_volume": 1,
            "trade_turnover": 13.059800000000000000,
            "fee": -0.005223920000000000,
            "trade_avg_price": 13059.800000000000000000,
            "margin_frozen": 0,
            "profit": 0,
            "status": 6,
            "order_source": "api",
            "order_id_str": "770334322963152896",
            "fee_asset": "USDT",
            "liquidation_type": "0",
            "canceled_at": 0,
            "margin_asset": "USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "is_tpsl": 0,
            "real_profit": 0,
            "reduce_only": 0
        }
    ],
    "ts": 1603703631815
}

返回数据

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id true long 客户订单ID
created_at true long 创建时间
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额 ，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发 ）
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 结算类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
canceled_at true long 撤单时间
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>
ts true long 时间戳

备注：

【全仓】获取合约订单信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
order_id false（请看备注） string 订单ID(多个订单ID中间以","分隔,一次最多允许查询50个订单)
client_order_id false（请看备注） string 客户订单ID(多个订单ID中间以","分隔,一次最多允许查询50个订单)
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT

备注：

Response

{
    "status": "ok",
    "data": [
        {
            "business_type": "futures",
            "contract_type": "quarter",
            "pair": "BTC-USDT",
            "symbol": "BTC",
            "contract_code": "BTC-USDT-211231",
            "volume": 1.000000000000000000,
            "price": 66000.000000000000000000,
            "order_price_type": "post_only",
            "order_type": 1,
            "direction": "sell",
            "offset": "open",
            "lever_rate": 1,
            "order_id": 917361800293453824,
            "client_order_id": null,
            "created_at": 1638757696945,
            "trade_volume": 0E-18,
            "trade_turnover": 0E-18,
            "fee": 0E-18,
            "trade_avg_price": null,
            "margin_frozen": 66.000000000000000000,
            "profit": 0E-18,
            "status": 3,
            "order_source": "api",
            "order_id_str": "917361800293453824",
            "fee_asset": "USDT",
            "liquidation_type": "0",
            "canceled_at": 0,
            "margin_asset": "USDT",
            "margin_account": "USDT",
            "margin_mode": "cross",
            "is_tpsl": 0,
            "real_profit": 0,
            "reduce_only": 0
        }
    ],
    "ts": 1639099755552
}

返回数据

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id true long 客户订单ID
created_at true long 创建时间
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额 ，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 结算类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
canceled_at true long 撤单时间
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>
ts true long 时间戳

备注：

【逐仓】获取订单明细信息

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"...
order_id true long 订单id
created_at false long 下单时间戳
order_type false int 订单类型 1:报单 、 2:撤单 、 3:强平 、4:交割 、22:ADL减仓单
page_index false int 第几页,不填第一页
page_size false int 不填默认20，不得多于50

备注

获取订单明细接口查询撤单数据时，如果传“created_at”和“order_type”参数则能查询最近6小时数据，如果不传“created_at”和“order_type”参数只能查询到最近2小时数据。

order_id返回是18位，nodejs和javascript默认解析18有问题，nodejs和javascript里面JSON.parse默认是int，超过18位的数字用json-bigint的包解析。

created_at使用13位long类型时间戳（包含毫秒时间），如果输入准确的时间戳，查询性能将会提升。例如:"2019/10/18 10:26:22"转换为时间戳为：1571365582123。也可以直接从swap_order下单接口返回的ts中获取时间戳查询对应的订单。

created_at禁止传0。

Response:


{
    "status": "ok",
    "data": {
        "symbol": "BTC",
        "contract_code": "BTC-USDT",
        "instrument_price": 0,
        "final_interest": 0,
        "adjust_value": 0,
        "lever_rate": 10,
        "direction": "sell",
        "offset": "open",
        "volume": 1.000000000000000000,
        "price": 13059.800000000000000000,
        "created_at": 1603703614712,
        "canceled_at": 0,
        "order_source": "api",
        "order_price_type": "opponent",
        "margin_frozen": 0,
        "profit": 0,
        "trades": [
            {
                "trade_id": 131560927,
                "trade_price": 13059.800000000000000000,
                "trade_volume": 1.000000000000000000,
                "trade_turnover": 13.059800000000000000,
                "trade_fee": -0.005223920000000000,
                "created_at": 1603703614715,
                "role": "taker",
                "fee_asset": "USDT",
                "real_profit": 0,
                "profit": 0,
                "id": "131560927-770334322963152896-1"
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1,
        "liquidation_type": "0",
        "fee_asset": "USDT",
        "fee": -0.005223920000000000,
        "order_id": 770334322963152896,
        "order_id_str": "770334322963152896",
        "client_order_id": 57012021045,
        "order_type": "1",
        "status": 6,
        "trade_avg_price": 13059.800000000000000000,
        "trade_turnover": 13.059800000000000000,
        "trade_volume": 1.000000000000000000,
        "margin_asset": "USDT",
        "margin_mode": "isolated",
        "margin_account": "BTC-USDT",
        "is_tpsl": 0,
        "real_profit": 0,
        "reduce_only": 0
    },
    "ts": 1603703678477
}

返回数据

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT"
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
created_at true long 创建时间
canceled_at true long 撤单时间
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 订单总平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
instrument_price true decimal 爆仓单合约价格
final_interest true decimal 爆仓时合约权益
adjust_value true decimal 爆仓时调整系数
fee true decimal 总手续费
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型
order_id true long 订单id
order_id_str true string string格式的订单id
client_order_id true long 客户订单id
order_type true string 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割 、5:ADL减仓单
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
trade_avg_price true decimal 成交均价
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
trade_volume true decimal 成交总数量
total_page true int 总共页数
current_page true int 当前页数
total_size true int 总条数
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 订单总真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trades> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_price true decimal 成交价格
trade_volume true decimal 成交量（张）
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格）
trade_fee true decimal 成交手续费
role true string taker或maker
created_at true long 创建时间
real_profit true decimal 该笔成交的真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
profit true decimal 该笔成交的平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
</trades>
</data>
ts true long 时间戳

备注：

【全仓】获取订单明细信息

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
order_id true long 订单id
created_at false long 下单时间戳
order_type false int 订单类型 1:报单 、 2:撤单 、 3:强平 、4:交割 、22:ADL减仓单
page_index false int 第几页,不填第一页
page_size false int 不填默认20，不得多于50

备注

获取订单明细接口查询撤单数据时，如果传“created_at”和“order_type”参数则能查询最近6小时数据，如果不传“created_at”和“order_type”参数只能查询到最近2小时数据。

order_id返回是18位，nodejs和javascript默认解析18有问题，nodejs和javascript里面JSON.parse默认是int，超过18位的数字用json-bigint的包解析。

created_at使用13位long类型时间戳（包含毫秒时间），如果输入准确的时间戳，查询性能将会提升。例如:"2019/10/18 10:26:22"转换为时间戳为：1571365582123。也可以直接从swap_order下单接口返回的ts中获取时间戳查询对应的订单。

created_at禁止传0。

Response

{
    "status": "ok",
    "data": {
        "contract_type": "this_week",
        "pair": "BTC-USDT",
        "business_type": "futures",
        "symbol": "BTC",
        "contract_code": "BTC-USDT-211210",
        "instrument_price": 0,
        "final_interest": 0,
        "adjust_value": 0,
        "lever_rate": 5,
        "direction": "buy",
        "offset": "open",
        "volume": 100.000000000000000000,
        "price": 48555.600000000000000000,
        "created_at": 1639100651569,
        "canceled_at": 0,
        "order_source": "api",
        "order_price_type": "opponent",
        "margin_frozen": 0E-18,
        "profit": 0E-18,
        "trades": [
            {
                "trade_id": 2902136,
                "trade_price": 48555.600000000000000000,
                "trade_volume": 100.000000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "created_at": 1639100651577,
                "role": "taker",
                "fee_asset": "USDT",
                "real_profit": 0E-18,
                "profit": 0E-18,
                "id": "2902136-918800256249405440-1"
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1,
        "liquidation_type": "0",
        "fee_asset": "USDT",
        "fee": -2.427780000000000000,
        "order_id": 918800256249405440,
        "order_id_str": "918800256249405440",
        "client_order_id": null,
        "order_type": "1",
        "status": 6,
        "trade_avg_price": 48555.600000000000000000,
        "trade_turnover": 4855.560000000000000000,
        "trade_volume": 100.000000000000000000,
        "margin_asset": "USDT",
        "margin_account": "USDT",
        "margin_mode": "cross",
        "is_tpsl": 0,
        "real_profit": 0,
        "reduce_only": 0
    },
    "ts": 1639100665681
}

返回数据

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
created_at true long 创建时间
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 订单总平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
instrument_price true decimal 爆仓单合约价格
final_interest true decimal 爆仓时合约权益
adjust_value true decimal 爆仓时调整系数
fee true decimal 总手续费
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型
canceled_at true long 撤单时间
order_id true long 订单id
order_id_str true string string格式的订单id
client_order_id true long 客户订单id
order_type true string 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割、5:ADL减仓单
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
trade_avg_price true decimal 成交均价
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
trade_volume true decimal 成交总数量
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 订单总真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
total_page true int 总共页数
current_page true int 当前页数
total_size true int 总条数
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trades> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_cross_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_price true decimal 成交价格
trade_volume true decimal 成交量（张）
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格）
trade_fee true decimal 成交手续费
role true string taker或maker
created_at true long 创建时间
profit true decimal 该笔成交的平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
real_profit true decimal 该笔成交的真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
</trades>
</data>
ts true long 时间戳

备注：

【逐仓】获取合约当前未成交委托

示例

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
page_index false int 页码，不填默认第1页
page_size false int 页长，不填默认20，不得多于50
sort_by false string 排序字段，不填默认按创建时间倒序 “created_at”(按照创建时间倒序)，“update_time”(按照更新时间倒序)
trade_type false int 交易类型，不填默认查询全部 0:全部, 1:买入开多, 2: 卖出开空, 3: 买入平空, 4: 卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）

Response:


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "volume": 1,
                "price": 13329,
                "order_price_type": "limit",
                "order_type": 1,
                "direction": "sell",
                "offset": "open",
                "lever_rate": 10,
                "order_id": 770326042832437248,
                "client_order_id": 57012021028,
                "created_at": 1603701640576,
                "trade_volume": 0,
                "trade_turnover": 0,
                "fee": 0,
                "trade_avg_price": null,
                "margin_frozen": 1.332900000000000000,
                "profit": 0,
                "status": 3,
                "order_source": "api",
                "order_id_str": "770326042832437248",
                "fee_asset": "USDT",
                "liquidation_type": null,
                "canceled_at": null,
                "margin_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "is_tpsl": 0,
                "update_time": 1606975980467,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "total_page": 2,
        "current_page": 1,
        "total_size": 2
    },
    "ts": 1603703993952
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data>
<orders>
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "limit":限价，"opponent":对手价，"post_only":只做maker单,post only下单只受用户持仓数量限制，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单, "opponent_ioc": 对手价-IOC下单，"lightning_ioc": 闪电平仓-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string 订单ID，字符串类型
client_order_id true long 客户订单ID
created_at true long 订单创建时间
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
fee_asset true string 手续费币种 "BTC","ETH"...
trade_avg_price true decimal 成交均价
margin_frozen true decimal 冻结保证金
margin_asset true string 保证金币种（计价币种）
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (3未成交 4部分成交 5部分成交已撤单 6全部成交 7已撤单)
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
liquidation_type true string 强平类型
canceled_at true long 撤单时间
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
is_tpsl true int 是否设置止盈止损 1：是；0：否
update_time true Long 订单更新时间，单位：毫秒
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【全仓】获取合约当前未成交委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
page_index false int 页码，不填默认第1页
page_size false int 页长，不填默认20，不得多于50
sort_by false string 排序字段，不填默认按创建时间倒序 “created_at”(按照创建时间倒序)，“update_time”(按照更新时间倒序)
trade_type false int 交易类型，不填默认查询全部 0:全部, 1: 买入开多, 2: 卖出开空, 3: 买入平空, 4: 卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "update_time": 1639104153425,
                "business_type": "swap",
                "contract_type": "swap",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "volume": 1,
                "price": 66000,
                "order_price_type": "post_only",
                "order_type": 1,
                "direction": "sell",
                "offset": "open",
                "lever_rate": 5,
                "order_id": 918814943964184578,
                "client_order_id": null,
                "created_at": 1639104153393,
                "trade_volume": 0,
                "trade_turnover": 0,
                "fee": 0,
                "trade_avg_price": null,
                "margin_frozen": 13.200000000000000000,
                "profit": 0,
                "status": 3,
                "order_source": "api",
                "order_id_str": "918814943964184578",
                "fee_asset": "USDT",
                "liquidation_type": null,
                "canceled_at": null,
                "margin_asset": "USDT",
                "margin_account": "USDT",
                "margin_mode": "cross",
                "is_tpsl": 0,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639104160523
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<orders> true object
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "limit":限价，"opponent":对手价，"post_only":只做maker单,post only下单只受用户持仓数量限制，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单, "opponent_ioc": 对手价-IOC下单，"lightning_ioc": 闪电平仓-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string string格式的订单ID
client_order_id true long 客户订单ID
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
created_at true long 订单创建时间
trade_volume true decimal 成交总数量
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
fee_asset true string 手续费币种 （"USDT"...）
trade_avg_price true decimal 成交均价
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (3未成交 4部分成交 5部分成交已撤单 6全部成交 7已撤单)
liquidation_type true string 强平类型
canceled_at true long 撤单时间
is_tpsl true int 是否设置止盈止损 1：是；0：否
update_time true Long 订单更新时间，单位：毫秒
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【逐仓】获取合约历史委托(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "status": 0,
        "type": 1,
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 48h 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 13580806498,
                "order_id": 770336866451992600,
                "contract_code": "BTC-USDT",
                "symbol": "BTC",
                "lever_rate": 10,
                "direction": "sell",
                "offset": "close",
                "volume": 1,
                "price": 13100,
                "create_date": 1603704221118,
                "update_time": 1603704221118,
                "order_source": "web",
                "order_price_type": 6,
                "order_type": 1,
                "margin_frozen": 0,
                "profit": 0,
                "trade_volume": 0,
                "trade_turnover": 0,
                "fee": 0,
                "trade_avg_price": 0,
                "status": 3,
                "order_id_str": "770336866451992576",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "margin_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "is_tpsl": 0,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
lever_rate true int lever rate
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 成交时间
update_time true long 订单更新时间，单位：毫秒
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 品种代码 （"USDT"...）
liquidation_type true string 品种代码 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
is_tpsl true int 品种代码 1：是；0：否
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【全仓】获取合约历史委托(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "pair": "BTC-USDT",
        "status": 0,
        "type": 1,
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 48h 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单

备注

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 13580806498,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "order_id": 918800256249405440,
                "contract_code": "BTC-USDT-211210",
                "symbol": "BTC",
                "lever_rate": 5,
                "direction": "buy",
                "offset": "open",
                "volume": 100.000000000000000000,
                "price": 48555.600000000000000000,
                "create_date": 1639100651569,
                "order_source": "api",
                "order_price_type": 3,
                "order_type": 1,
                "margin_frozen": 0E-18,
                "profit": 0E-18,
                "trade_volume": 100.000000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "fee": -2.427780000000000000,
                "trade_avg_price": 48555.6000,
                "status": 6,
                "order_id_str": "918800256249405440",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "margin_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "update_time": 1639100651000,
                "is_tpsl": 0,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
lever_rate true int lever rate
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 成交时间
update_time true long 订单更新时间，单位：毫秒
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 品种代码 （"USDT"...）
liquidation_type true string 品种代码 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpsl true int 品种代码 1：是；0：否
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。） 1：是；0：否
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【逐仓】组合查询合约历史委托(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "status": 0,
        "type": 1,
        "price_type": "opponent",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 48h 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
price_type false string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单 order_price_type

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 13580806498,
                "order_id": 807038270541733888,
                "contract_code": "BTC-USDT",
                "symbol": "BTC",
                "lever_rate": 10,
                "direction": "buy",
                "offset": "close",
                "volume": 9,
                "price": 36580,
                "create_date": 1612454517740,
                "order_source": "android",
                "order_price_type": "opponent",
                "order_type": 1,
                "margin_frozen": 0,
                "profit": 0.3636,
                "trade_volume": 9,
                "trade_turnover": 329.22,
                "fee": -0.131688,
                "trade_avg_price": 36580,
                "status": 6,
                "order_id_str": "807038270541733888",
                "fee_asset": "BTC-USDT",
                "liquidation_type": "0",
                "is_tpsl": 0,
                "real_profit": 0.2394,
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“USDT”
lever_rate true int lever rate
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 成交时间
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 品种代码 （"USDT"...）
liquidation_type true string 品种代码 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpsl true int 品种代码 1：是；0：否
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【全仓】组合查询合约历史委托(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "pair": "BTC-USDT",
        "status": 0,
        "type": 1,
        "price_type": "opponent",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 48h 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
price_type false string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单 order_price_type

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 452057,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "order_id": 918800256249405440,
                "contract_code": "BTC-USDT-211210",
                "symbol": "BTC",
                "lever_rate": 5,
                "direction": "buy",
                "offset": "open",
                "volume": 100.000000000000000000,
                "price": 48555.600000000000000000,
                "create_date": 1639100651569,
                "order_source": "api",
                "order_price_type": "opponent",
                "order_type": 1,
                "margin_frozen": 0E-18,
                "profit": 0E-18,
                "trade_volume": 100.000000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "fee": -2.427780000000000000,
                "trade_avg_price": 48555.6000,
                "status": 6,
                "order_id_str": "918800256249405440",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "is_tpsl": 0,
                "real_profit": 0,
                "margin_mode": "cross",
                "margin_account": "USDT",
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
lever_rate true int lever rate
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 成交时间
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 品种代码 （"USDT"...）
liquidation_type true string 品种代码 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpsl true int 品种代码 1：是；0：否
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【逐仓】获取历史成交记录(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract false（请看备注） string 合约代码 contract_code
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 (now) – 48h 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 452057,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "match_id": 2902136,
                "order_id": 918800256249405440,
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "direction": "buy",
                "offset": "open",
                "trade_volume": 100.000000000000000000,
                "trade_price": 48555.600000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "offset_profitloss": 0E-18,
                "create_date": 1639100651577,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "918800256249405440",
                "id": "2902136-918800256249405440-1",
                "fee_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "real_profit": 0E-18,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【全仓】获取历史成交记录(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "pair": "BTC-USDT",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract true string 合约代码 支持大小写,"BTC-USDT" ... 永续："BTC-USDT"... ，交割："BTC-USDT-210625"... contract_code
pair false(请看备注) string 交易对 “BTC-USDT”...
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 452057,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "match_id": 2902136,
                "order_id": 918800256249405440,
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "direction": "buy",
                "offset": "open",
                "trade_volume": 100.000000000000000000,
                "trade_price": 48555.600000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "offset_profitloss": 0E-18,
                "create_date": 1639100651577,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "918800256249405440",
                "id": "2902136-918800256249405440-1",
                "fee_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "real_profit": 0E-18,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
true
</data>

【逐仓】组合查询用户历史成交记录(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract true string 合约代码 contract_code
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 138798248,
                "match_id": 13752484857,
                "order_id": 807038270541733888,
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "direction": "buy",
                "offset": "close",
                "trade_volume": 9,
                "trade_price": 36580,
                "trade_turnover": 329.22,
                "trade_fee": -0.131688,
                "offset_profitloss": 0.3636,
                "create_date": 1612454517757,
                "role": "Taker",
                "order_source": "android",
                "order_id_str": "807038270541733888",
                "id": "13752484857-807038270541733888-1",
                "fee_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "real_profit": 0.2394,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 isolated：逐仓模式；
margin_account true string 保证金账户 比如“BTC-USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【全仓】组合查询用户历史成交记录(新)

备注

Request:


    {
        "contract": "BTC-USDT",
        "trade_type": 0,
        "pair": "BTC-USDT",
        "start_time": 1660119810000,
        "end_time": 1660274746031,
        "direct": "next",
        "from_id": 1110
    }

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围 原接口字段
contract true string 合约代码 支持大小写,"BTC-USDT" ... 永续："BTC-USDT"... ，交割："BTC-USDT-210625"... contract_code
pair false(请看备注) string 交易对 “BTC-USDT”...
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 查询开始时间, 以数据按创建时间进行查询 取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。
end_time false long 查询结束时间, 以数据按创建时间进行查询 now 取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。
direct false string 查询方向, 方向为next时，数据按照时间正序排列返回，方向为prev时，数据按照时间倒序返回 next prev表示向前查询，next表示向后查询。
from_id false long 如果是向前(prev)查询，则赋值为上一次查询结果中得到的最小query_id ；如果是向后(next)查询，则赋值为上一次查询结果中得到的最大query_id

Response:


    {
        "code": 200,
        "msg": "",
        "data": [
            {
                "query_id": 452057,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "match_id": 2902136,
                "order_id": 918800256249405440,
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "direction": "buy",
                "offset": "open",
                "trade_volume": 100.000000000000000000,
                "trade_price": 48555.600000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "offset_profitloss": 0E-18,
                "create_date": 1639100651577,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "918800256249405440",
                "id": "2902136-918800256249405440-1",
                "fee_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "real_profit": 0E-18,
                "reduce_only": 0
            }
        ],
        "ts": 1604312615051
    }

返回参数

参数名称 是否必须 类型 描述 取值范围
code true int 状态码(由具体业务自定义)
msg true string 状态码对应的描述信息
ts true long 响应生成时间点，单位：毫秒
<data> true object array 字典类型
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

【逐仓】闪电平仓下单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"...
volume true long 委托数量（张）
direction true string 买卖方向 “buy”:买，“sell”:卖
client_order_id false long （API）客户自己填写和维护，必须为数字 [1-9223372036854775807]
order_price_type false string 订单报价类型 不填，默认为“市价”，"market": 市价，"lightning"：闪电平仓，"lightning_ioc"：闪电平仓-IOC，"lightning_fok"：闪电平仓-FOK

备注

Response:


{
  "status": "ok",
  "data": {
    "order_id": 9861634,
    "order_id_str": "9861634",
    "client_order_id": 9086
  },
  "ts": 158797866555
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典
order_id true long 订单ID[全局唯一]
order_id_str true string String类型订单ID
client_order_id false Long 用户自己的订单id
</data>

错误信息：


{
    "status": "error",
    "err_code": 1048,
    "err_msg": "Insufficient close amount available.",
    "ts": 1603704587846
}

【全仓】闪电平仓下单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ， 交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
volume true decimal 委托数量（张）
direction true string 买卖方向 “buy”:买，“sell”:卖
client_order_id false long （API）客户自己填写和维护，必须为数字 [1-9223372036854775807]
order_price_type false string 订单报价类型 不填，默认为“市价”，"market": 市价，"lightning"：闪电平仓，"lightning_ioc"：闪电平仓-IOC，"lightning_fok"：闪电平仓-FOK

备注

Response


{
    "status": "ok",
    "data": {
        "order_id": 784063527799226368,
        "order_id_str": "784063527799226368"
    },
    "ts": 1606976912267
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典
order_id true long 订单ID[全局唯一]
order_id_str true string String类型订单ID
client_order_id false int 用户自己的订单id
</data>

合约策略订单接口

【逐仓】合约计划委托下单

备注

请求示例


{
    "contract_code": "BTC-USDT",
    "trigger_type": "ge",
    "trigger_price": 1111,
    "order_price": 1000,
    "order_price_type":"limit",
    "volume": 111,
    "direction": "buy",
    "offset": "open",
    "lever_rate": 10
}

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
trigger_type true string 触发类型 ge大于等于(触发价比最新价大)；le小于(触发价比最新价小)
trigger_price true decimal 触发价，精度超过最小变动单位会报错
order_price false decimal 委托价，精度超过最小变动单位会报错
order_price_type false string 委托类型，不填默认为limit; 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
volume true long 委托数量(张)
direction true string 买卖方向 buy:买 sell:卖
offset false(请看备注) string 开平方向 open:开 close:平 both:单向持仓
lever_rate false int 开仓必须填写，平仓可以不填。杠杆倍数[开仓若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。

备注：

Response:


{
    "status": "ok",
    "data": {
        "order_id": 35,
        "order_id_str": "35"
    },
    "ts": 1547521135713
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> true object 成功处理返回的数据
order_id true int 订单ID : 全局唯一
order_id_str true string 字符串类型的订单ID
</data>

错误示例：


{
    "status": "error",
    "err_code": 1014,
    "err_msg": "This contract doesnt exist.",
    "ts": 1603704820880
}

【全仓】合约计划委托下单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
trigger_type true string 触发类型 ge大于等于(触发价比最新价大)；le小于(触发价比最新价小)
trigger_price true decimal 触发价，精度超过最小变动单位会报错
order_price false decimal 委托价，精度超过最小变动单位会报错
order_price_type false string 委托类型，不填默认为limit; 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
volume true long 委托数量(张)
direction true string 买卖方向 buy:买 sell:卖
offset false(请看备注) string 开平方向 open:开, close:平, both:单向持仓
lever_rate false int 开仓必须填写，平仓可以不填。杠杆倍数[开仓若有10倍多单，就不能再下20倍多单;高倍杠杆风险系数较大，请谨慎使用。

Response


正确的返回：
{
    "status": "ok",
    "data": {
        "order_id": 1880,
        "order_id_str": "1880"
    },
    "ts": 1606977456766
}

错误的返回：
{
    "status": "error",
    "err_code": 1085,
    "err_msg": "Trigger order failed, please modify the price and place the order again or contact the customer service.",
    "ts": 1606977396756
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> true object 成功处理返回的数据
order_id true int 订单ID : 全局唯一
order_id_str true string 字符串类型的订单ID
</data>

【逐仓】合约计划委托撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
order_id true string 用户订单ID（多个订单ID中间以","分隔,一次最多允许撤消20个订单 ）

Response:


{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "34",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "1"
    },
    "ts": 1603704887184
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
<errors> true object array 订单失败信息
order_id false string 订单id
err_code false int 订单失败错误码
err_msg false string 订单失败信息
</errors>
successes true string 成功的订单，多个订单号以“,”相连
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】合约计划委托撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
order_id true string 用户订单ID（多个订单ID中间以","分隔,一次最多允许撤消10个订单 ）

Response

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "1888",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "1880"
    },
    "ts": 1606977508308
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
<errors> true object array 订单失败信息
order_id false string 订单id
err_code false int 订单失败错误码
err_msg false string 订单失败信息
</errors>
successes true string 成功的订单，多个订单号以“,”相连
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】合约计划委托全部撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

备注：

Response:


{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "2"
    },
    "ts": 1603704998960
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
<errors> true object array 订单失败信息
order_id false string 订单id
err_code false int 订单失败错误码
err_msg false string 订单失败信息
</errors>
successes true string 成功的订单，多个订单号以“,”相连
</data>
ts true long 响应生成时间点，单位：毫秒

错误示例：


{
    "status": "error",
    "err_code": 1051,
    "err_msg": "No orders to cancel.",
    "ts": 1603705063592
}

【全仓】合约计划委托全部撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false(请看备注) string 交易对 BTC-USDT
contract_type false(请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

备注：

Response

{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "1879,1878"
    },
    "ts": 1606977712328
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
<errors> true object array 订单失败信息
order_id false string 订单id
err_code false int 订单失败错误码
err_msg false string 订单失败信息
</errors>
successes true string 成功的订单，多个订单号以“,”相连
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】获取计划委托当前委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
trade_type false int 交易类型，不填默认查询全部 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）

Response:


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "trigger_type": "ge",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "sell",
                "offset": "open",
                "lever_rate": 10,
                "order_id": 4,
                "order_id_str": "4",
                "order_source": "api",
                "trigger_price": 13900.000000000000000000,
                "order_price": 13900.000000000000000000,
                "created_at": 1603705215654,
                "order_price_type": "limit",
                "status": 2,
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1603705219567
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
<orders> true object array 订单信息
symbol true string 合约品种
contract_code true string 合约代码
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单 2、撤单
direction true string 订单方向 [买(buy),卖(sell)]
offset true string 开平标志 [开(open),平(close),单向持仓(both)]
lever_rate true int 杠杆倍数
order_id true long 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
order_price true decimal 委托价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 1:准备提交、2:已提交、3:报单中、8：撤单未找到、9：撤单中、10：失败'
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】获取计划委托当前委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false String 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false string 交易对 BTC-USDT
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
trade_type false int 交易类型，不填默认查询全部 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "quarter",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "trigger_type": "le",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "buy",
                "offset": "open",
                "lever_rate": 1,
                "order_id": 918808635214700544,
                "order_id_str": "918808635214700544",
                "order_source": "api",
                "trigger_price": 40000.000000000000000000,
                "order_price": 40000.000000000000000000,
                "created_at": 1639102649275,
                "order_price_type": "limit",
                "status": 2,
                "margin_mode": "cross",
                "margin_account": "USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639102667934
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
<orders> true object array 订单信息
symbol true string 合约品种 “BTC”，“ETH”...
contract_code true string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单 2、撤单
direction true string 订单方向 [买(buy),卖(sell)]
offset true string 开平标志 [开(open),平(close),单向持仓(both)]
lever_rate true int 杠杆倍数
order_id true long 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
order_price true decimal 委托价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 1:准备提交、2:已提交、3:报单中、8：撤单未找到、9：撤单中、10：失败'
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】获取计划委托历史委托

备注

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17:买入（单向持仓）, 18:卖出（单向持仓）;后台是根据该值转换为offset和direction，然后去查询的； 其他值无法查询出结果
status true string 订单状态 多个以英文逗号隔开，计划委托单状态：0:全部（表示全部结束状态的订单）、4:已委托、5:委托失败、6:已撤单
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页 1 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50 20 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 created_at "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

备注：

Response:


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "trigger_type": "ge",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "sell",
                "offset": "open",
                "lever_rate": 10,
                "order_id": 3,
                "order_id_str": "3",
                "relation_order_id": "-1",
                "order_price_type": "limit",
                "status": 6,
                "order_source": "api",
                "trigger_price": 13900.000000000000000000,
                "triggered_price": null,
                "order_price": 13900.000000000000000000,
                "created_at": 1603705155231,
                "triggered_at": null,
                "order_insert_at": 0,
                "canceled_at": 1603705159520,
                "update_time": 1603705159520,
                "fail_code": null,
                "fail_reason": null,
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 3,
        "current_page": 1,
        "total_size": 3
    },
    "ts": 1603705603369
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
<orders> true object array 订单信息
symbol true string 合约品种
contract_code true string 合约代码
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单 2、撤单
direction true string 订单方向 [买(buy),卖(sell)]
offset true string 开平标志 [开(open),平(close),单向持仓(both)]
lever_rate true int 杠杆倍数
order_id true long 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
relation_order_id true string 该字段为关联限价单的订单id，未触发前数值为-1
order_price_type true string 订单报价类型 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 (4:报单成功、5:报单失败、6:已撤单 )
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
triggered_price true decimal 被触发时的价格
order_price true decimal 委托价
created_at true long 订单创建时间
update_time true long 订单更新时间，单位：毫秒
triggered_at true long 触发时间
order_insert_at true long 下order单时间
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】获取计划委托历史委托

备注

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code false（请看备注） string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17:买入（单向持仓）, 18:卖出（单向持仓）;后台是根据该值转换为offset和direction，然后去查询的； 其他值无法查询出结果
status true string 订单状态 多个以英文逗号隔开，计划委托单状态：0:全部（表示全部结束状态的订单）、4:已委托、5:委托失败、6:已撤单
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页 1 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50 20 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 created_at "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

备注：

Response


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "quarter",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "trigger_type": "le",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "buy",
                "offset": "open",
                "lever_rate": 1,
                "order_id": 918808635214700544,
                "order_id_str": "918808635214700544",
                "relation_order_id": "-1",
                "order_price_type": "limit",
                "status": 6,
                "order_source": "api",
                "trigger_price": 40000.000000000000000000,
                "triggered_price": null,
                "order_price": 40000.000000000000000000,
                "created_at": 1639102649275,
                "triggered_at": null,
                "order_insert_at": 0,
                "canceled_at": 1639103205980,
                "fail_code": null,
                "fail_reason": null,
                "margin_mode": "cross",
                "margin_account": "USDT",
                "update_time": 1639103206083,
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639103213233
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<data> true object 成功处理返回的数据
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
<orders> true object array 订单信息
symbol true string 合约品种 “BTC”，“ETH”...
contract_code true string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单 2、撤单
direction true string 订单方向 [买(buy),卖(sell)]
offset true string 开平标志 [开(open),平(close),单向持仓(both)]
lever_rate true int 杠杆倍数
order_id true long 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
order_price_type true string 订单报价类型 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 (4:报单成功、5:报单失败、6:已撤单 )
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
triggered_price true decimal 被触发时的价格
order_price true decimal 委托价
created_at true long 订单创建时间
update_time true long 订单更新时间，单位：毫秒
triggered_at true long 触发时间
order_insert_at true long 下order单时间
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】对仓位设置止盈止损订单

备注

Request

{
    "contract_code": "btc-usdt",
    "direction": "sell",
    "volume": 1,
    "tp_trigger_price": 32000,
    "tp_order_price": 32000,
    "tp_order_price_type": "optimal_5",
    "sl_trigger_price": "29000",
    "sl_order_price": "29000",
    "sl_order_price_type": "optimal_5"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
direction true string 买卖方向 buy:买入平空 sell:卖出平多
volume true decimal 委托数量(张)
tp_trigger_price false decimal 止盈触发价格
tp_order_price false decimal 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type false string 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price false decimal 止损触发价格
sl_order_price false decimal 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type false string 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20

Response

{
    "status": "ok",
    "data": {
        "tp_order": {
            "order_id": 795713650661638144,
            "order_id_str": "795713650661638144"
        },
        "sl_order": {
            "order_id": 795713650665832448,
            "order_id_str": "795713650665832448"
        }
    },
    "ts": 1609754517975
}

Error Response

{
    "status": "error",
    "err_code": 1066,
    "err_msg": "contract_code cannot be empty.",
    "ts": 1604369954194
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> false object 成功处理返回的数据，下单失败时不返回
<tp_order> true object 止盈单下单结果
order_id true long 止盈订单ID
order_id_str true string 止盈订单ID（字符串格式）
</tp_order>
<sl_order> true object 止损单下单结果
order_id true long 止损订单ID
order_id_str true string 止损订单ID（字符串格式）
</sl_order>
</data>
err_code false int 错误码（下单失败才出现）
err_msg false string 错误信息（下单失败才出现）

备注

【全仓】对仓位设置止盈止损订单

备注：

Request

{
    "contract_code": "btc-usdt",
    "direction": "sell",
    "volume": 1,
    "tp_trigger_price": 32000,
    "tp_order_price": 32000,
    "tp_order_price_type": "optimal_5",
    "sl_trigger_price": "29000",
    "sl_order_price": "29000",
    "sl_order_price_type": "optimal_5"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT210625”...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
direction true string 买卖方向 buy:买入平空 sell:卖出平多
volume true decimal 委托数量(张)
tp_trigger_price false decimal 止盈触发价格
tp_order_price false decimal 止盈委托价格（最优N档委托类型时无需填写价格）
tp_order_price_type false string 止盈委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
sl_trigger_price false decimal 止损触发价格
sl_order_price false decimal 止损委托价格（最优N档委托类型时无需填写价格）
sl_order_price_type false string 止损委托类型 不填默认为market: 市价，limit: 限价：limit ，最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20

Response

{
    "status": "ok",
    "data": {
        "tp_order": {
            "order_id": 795714078698749952,
            "order_id_str": "795714078698749952"
        },
        "sl_order": {
            "order_id": 795714078698749953,
            "order_id_str": "795714078698749953"
        }
    },
    "ts": 1609754620038
}

Error Response

{
    "status": "error",
    "err_code": 1066,
    "err_msg": "contract_code cannot be empty.",
    "ts": 1604369954194
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> false object 成功处理返回的数据，下单失败时不返回
<tp_order> true object 止盈单下单结果
order_id true long 止盈订单ID
order_id_str true string 止盈订单ID（字符串格式）
</tp_order>
<sl_order> true object 止损单下单结果
order_id true long 止损订单ID
order_id_str true string 止损订单ID（字符串格式）
</sl_order>
</data>
err_code false int 错误码（下单失败才出现）
err_msg false string 错误信息（下单失败才出现）

备注

【逐仓】止盈止损订单撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
order_id true string 止盈止损订单ID（多个订单ID中间以","分隔,一次最多允许撤消10个订单 ）

Response

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "795713650661638145",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "795713650661638144"
    },
    "ts": 1609754722004
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 止盈止损订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】止盈止损订单撤单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
order_id true string 止盈止损订单ID（多个订单ID中间以","分隔,一次最多允许撤消10个订单 ）

Response

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "795714078698749956",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "795714078698749952"
    },
    "ts": 1609754775942
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 止盈止损订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】止盈止损订单全部撤单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖

Response

{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "795713650665832448,795714964661583872,795714964661583873"
    },
    "ts": 1609754843671
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 止盈止损订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】止盈止损订单全部撤单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false(请看备注) string 交易对 BTC-USDT
contract_type false(请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖

Response

{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "795714078698749953,795715192882053120,795715192886247424"
    },
    "ts": 1609754894463
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 止盈止损订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】查询止盈止损订单当前委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
trade_type false int 交易类型，不填默认查询全部 0:全部,3: 买入平空,4: 卖出平多。

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "volume": 1,
                "order_type": 1,
                "direction": "buy",
                "order_id": 795715396674895872,
                "order_id_str": "795715396674895872",
                "order_source": "api",
                "trigger_type": "le",
                "trigger_price": 27000,
                "order_price": 0,
                "created_at": 1609754934244,
                "order_price_type": "optimal_5",
                "status": 2,
                "tpsl_order_type": "tp",
                "source_order_id": "795715396666507264",
                "relation_tpsl_order_id": "795715396674895873"
            }
        ],
        "total_page": 4,
        "current_page": 1,
        "total_size": 4
    },
    "ts": 1609755183516
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
order_source true string 来源
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 市价："market"，限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
order_price true decimal 委托价
status true int 订单状态： 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败 、11：已失效
source_order_id true string 源限价单的订单id（下单设置的止盈止损订单该字段才有值，表示当前止盈止损单由哪个限价单触发的）
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询止盈止损订单当前委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false string 交易对 BTC-USDT
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
trade_type false int 交易类型，不填默认查询全部 0:全部,3: 买入平空,4: 卖出平多。

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "this_week",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "sell",
                "order_id": 918816985859559425,
                "order_id_str": "918816985859559425",
                "order_source": "api",
                "trigger_type": "le",
                "trigger_price": 40000.000000000000000000,
                "order_price": 0E-18,
                "created_at": 1639104640223,
                "order_price_type": "optimal_5",
                "status": 2,
                "tpsl_order_type": "sl",
                "source_order_id": null,
                "relation_tpsl_order_id": "918816985859559424"
            },
            {
                "contract_type": "this_week",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "sell",
                "order_id": 918816985859559424,
                "order_id_str": "918816985859559424",
                "order_source": "api",
                "trigger_type": "ge",
                "trigger_price": 50000.000000000000000000,
                "order_price": 0E-18,
                "created_at": 1639104640223,
                "order_price_type": "optimal_5",
                "status": 2,
                "tpsl_order_type": "tp",
                "source_order_id": null,
                "relation_tpsl_order_id": "918816985859559425"
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 2
    },
    "ts": 1639104794491
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码 ”BTC“、”ETH“...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
order_source true string 来源
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 市价："market"，限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
order_price true decimal 委托价
status true int 订单状态： 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败 、11：已失效
source_order_id true string 源限价单的订单id（下单设置的止盈止损订单该字段才有值，表示当前止盈止损单由哪个限价单触发的）
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】查询止盈止损订单历史委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码,"BTC-USDT" ...
status true string 订单状态 多个以英文逗号隔开，止盈止损订单状态： 0:全部（表示全部结束状态的订单）、4:委托成功、5:委托失败、6:已撤单、11：已失效
create_date true long 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "volume": 1,
                "order_type": 1,
                "tpsl_order_type": "sl",
                "direction": "sell",
                "order_id": 795714964661583873,
                "order_id_str": "795714964661583873",
                "order_source": "api",
                "trigger_type": "le",
                "trigger_price": 29000,
                "created_at": 1609754831244,
                "order_price_type": "optimal_5",
                "status": 6,
                "source_order_id": null,
                "relation_tpsl_order_id": "795714964661583872",
                "canceled_at": 1609754844420,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1",
                "update_time": 1609754850018,
                "order_price": 0
            }
        ],
        "total_page": 17,
        "current_page": 1,
        "total_size": 17
    },
    "ts": 1609756931689
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
order_source true string 来源
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 市价："market"，限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
order_price true decimal 委托价
status true int 订单状态： 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败 、11：已失效
source_order_id true string 源限价单的订单id（下单设置的止盈止损订单该字段才有值，表示当前止盈止损单由哪个限价单触发的）
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
update_time true long 订单更新时间，单位：毫秒
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询止盈止损订单历史委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
status true string 订单状态 多个以英文逗号隔开，止盈止损订单状态： 0:全部（表示全部结束状态的订单）、4:委托成功、5:委托失败、6:已撤单、11：已失效
create_date true long 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "this_week",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "tpsl_order_type": "tp",
                "direction": "sell",
                "order_id": 918816985859559424,
                "order_id_str": "918816985859559424",
                "order_source": "api",
                "trigger_type": "ge",
                "trigger_price": 50000.000000000000000000,
                "created_at": 1639104640223,
                "order_price_type": "optimal_5",
                "status": 6,
                "source_order_id": null,
                "relation_tpsl_order_id": "918816985859559425",
                "canceled_at": 1639104933147,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1",
                "update_time": 1639104933172,
                "order_price": 0E-18
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639104940769
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
order_source true string 来源
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 市价："market"，限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
order_price true decimal 委托价
status true int 订单状态： 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败 、11：已失效
source_order_id true string 源限价单的订单id（下单设置的止盈止损订单该字段才有值，表示当前止盈止损单由哪个限价单触发的）
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
update_time true long 订单更新时间，单位：毫秒
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】查询开仓单关联的止盈止损订单详情

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
order_id true long 开仓订单id

Response

{
    "status": "ok",
    "data": {
        "symbol": "BTC",
        "contract_code": "BTC-USDT",
        "margin_mode": "isolated",
        "margin_account": "BTC-USDT",
        "volume": 1,
        "price": 29999,
        "order_price_type": "opponent",
        "direction": "buy",
        "offset": "open",
        "lever_rate": 75,
        "order_id": 795947785812557824,
        "order_id_str": "795947785812557824",
        "client_order_id": null,
        "created_at": 1609810340126,
        "trade_volume": 1,
        "trade_turnover": 29.999,
        "fee": -0.01619946,
        "trade_avg_price": 29999,
        "margin_frozen": 0,
        "profit": 0,
        "status": 6,
        "order_type": 1,
        "order_source": "api",
        "fee_asset": "USDT",
        "canceled_at": 0,
        "tpsl_order_info": [
            {
                "volume": 1,
                "direction": "sell",
                "tpsl_order_type": "tp",
                "order_id": 795947785820946432,
                "order_id_str": "795947785820946432",
                "trigger_type": "ge",
                "trigger_price": 31000,
                "order_price": 0,
                "created_at": 1609810340134,
                "order_price_type": "optimal_5",
                "relation_tpsl_order_id": "795947785820946433",
                "status": 1,
                "canceled_at": 0,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1"
            },
            {
                "volume": 1,
                "direction": "sell",
                "tpsl_order_type": "sl",
                "order_id": 795947785820946433,
                "order_id_str": "795947785820946433",
                "trigger_type": "le",
                "trigger_price": 29100,
                "order_price": 0,
                "created_at": 1609810340134,
                "order_price_type": "optimal_5",
                "relation_tpsl_order_id": "795947785820946432",
                "status": 1,
                "canceled_at": 0,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1"
            }
        ]
    },
    "ts": 1609810352828
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买, "sell":卖
offset true string 开平方向 "open":开, "close":平, "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id true long 客户订单ID
created_at true long 创建时间
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
fee_asset true string 手续费币种 （"BTC","ETH"...）
canceled_at true long 撤单时间
<tpsl_order_info> true object array 关联的止盈止损单信息
volume true decimal 委托数量
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
order_price true decimal 委托价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败' 、11：已失效、12、未生效-已结束
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
</tpsl_order_info>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询开仓单关联的止盈止损订单详情

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
order_id true long 开仓订单id

Response

{
    "status": "ok",
    "data": {
        "contract_type": "this_week",
        "business_type": "futures",
        "pair": "BTC-USDT",
        "symbol": "BTC",
        "contract_code": "BTC-USDT-211210",
        "margin_mode": "cross",
        "margin_account": "USDT",
        "volume": 1,
        "price": 48592.2,
        "order_price_type": "opponent",
        "direction": "buy",
        "offset": "open",
        "lever_rate": 5,
        "order_id": 918819004716982272,
        "order_id_str": "918819004716982272",
        "client_order_id": null,
        "created_at": 1639105121550,
        "trade_volume": 1,
        "trade_turnover": 48.592200000000000000,
        "fee": -0.024296100000000000,
        "trade_avg_price": 48592.200000000000000000,
        "margin_frozen": 0E-18,
        "profit": 0,
        "status": 6,
        "order_type": 1,
        "order_source": "api",
        "fee_asset": "USDT",
        "canceled_at": 0,
        "tpsl_order_info": [
            {
                "volume": 1.000000000000000000,
                "direction": "sell",
                "tpsl_order_type": "tp",
                "order_id": 918819004746342400,
                "order_id_str": "918819004746342400",
                "trigger_type": "ge",
                "trigger_price": 50000.000000000000000000,
                "order_price": 0E-18,
                "created_at": 1639105121563,
                "order_price_type": "optimal_5",
                "relation_tpsl_order_id": "918819004750536704",
                "status": 2,
                "canceled_at": 0,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1"
            },
            {
                "volume": 1.000000000000000000,
                "direction": "sell",
                "tpsl_order_type": "sl",
                "order_id": 918819004750536704,
                "order_id_str": "918819004750536704",
                "trigger_type": "le",
                "trigger_price": 40000.000000000000000000,
                "order_price": 0E-18,
                "created_at": 1639105121564,
                "order_price_type": "optimal_5",
                "relation_tpsl_order_id": "918819004746342400",
                "status": 2,
                "canceled_at": 0,
                "fail_code": null,
                "fail_reason": null,
                "triggered_price": null,
                "relation_order_id": "-1"
            }
        ]
    },
    "ts": 1639105149621
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如“USDT”，“BTC-USDT”
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买, "sell":卖
offset true string 开平方向 "open":开, "close":平, "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string String类型订单ID
client_order_id true long 客户订单ID
created_at true long 创建时间
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
status true int 订单状态 (1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中)
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
fee_asset true string 手续费币种 （"BTC","ETH"...）
canceled_at true long 撤单时间
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
<tpsl_order_info> true object array 关联的止盈止损单信息
volume true decimal 委托数量
tpsl_order_type true string 止盈止损类型 “tp”:止盈单；"sl"：止损单
direction true string 买卖方向 买入平空："buy",卖出平多："sell"
order_id true long 止盈止损订单ID
order_id_str true string 字符串类型的止盈止损订单ID
trigger_type true string 触发类型： ge大于等于；le小于等于
trigger_price true decimal 触发价
order_price true decimal 委托价
created_at true long 订单创建时间
order_price_type true string 订单报价类型 限价："limit"， 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20
status true int 订单状态 1:未生效、2:等待委托、3:委托中、4:委托成功、5:委托失败、6:已撤单、8：撤单未找到、9：撤单中、10：失败' 、11：已失效、12、未生效-已结束
relation_tpsl_order_id true string 关联的止盈止损单id（用户同时设置止盈止损单时，该字段才有值，否则数值为-1）
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
</tpsl_order_info>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】跟踪委托订单下单

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
direction true string 买卖方向 buy:买 sell:卖
offset false(请看备注) string 开平方向 open:开 close:平 both:单向持仓
lever_rate false int 杠杆倍数，开仓操作为必填，平仓操作为非必填
volume true decimal 委托数量(张)
callback_rate true decimal 回调幅度 如：0.01 表示1%，不可小于0.001（0.1%）
active_price true decimal 激活价格
order_price_type true string 委托类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20，理论价格：formula_price

备注

Response: 

{
    "status": "ok",
    "data": {
        "order_id": 826052268312821760,
        "order_id_str": "826052268312821760"
    },
    "ts": 1616987808080
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> true object 成功处理返回的数据
order_id true long 跟踪委托订单ID[全局唯一]
order_id_str true string 字符串类型的跟踪委托订单ID
</data>

【全仓】跟踪委托订单下单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
contract_type false（请看备注） string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
reduce_only false int 是否为只减仓订单（该字段在双向持仓模式下无效，在单向持仓模式下不填默认为0。） 0:表示为非只减仓订单，1:表示为只减仓订单
direction true string 买卖方向 buy:买 sell:卖
offset false(请看备注) string 开平方向 open:开 close:平 both:单向持仓
lever_rate false int 杠杆倍数，开仓操作为必填，平仓操作为非必填
volume true decimal 委托数量(张)
callback_rate true decimal 回调幅度 如：0.01 表示1%，不可小于0.001（0.1%）
active_price true decimal 激活价格
order_price_type true string 委托类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20，理论价格：formula_price

备注

Response: 

{
    "status": "ok",
    "data": {
        "order_id": 826052906719444992,
        "order_id_str": "826052906719444992"
    },
    "ts": 1616987960287
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 时间戳
<data> true object 成功处理返回的数据
order_id true long 跟踪委托订单ID[全局唯一]
order_id_str true string 字符串类型的跟踪委托订单ID
</data>

【逐仓】跟踪委托订单撤单

备注：

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
order_id true string 用户跟踪委托订单ID（多个订单ID中间以","分隔,一次最多允许撤消10个订单 ）

Response: 

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "826052268312821761",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "826052268312821760"
    },
    "ts": 1616988039695
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 跟踪委托订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】跟踪委托订单撤单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false (请看备注) string 合约代码 永续：“BTC-USDT”... ，交割：“BTC-USDT-210625”...
pair false (请看备注) string 交易对 BTC-USDT
contract_type false (请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
order_id true string 用户跟踪委托订单ID（多个订单ID中间以","分隔,一次最多允许撤消10个订单 ）

Response: 

{
    "status": "ok",
    "data": {
        "errors": [
            {
                "order_id": "826052906719444993",
                "err_code": 1061,
                "err_msg": "This order doesnt exist."
            }
        ],
        "successes": "826053970168446976"
    },
    "ts": 1616988232517
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 跟踪委托订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】跟踪委托订单全部撤单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

Response: 

{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "826054603831312384,826054608491184128,826054686706565120"
    },
    "ts": 1616988392280
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 跟踪委托订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】跟踪委托订单全部撤单

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续：“BTC-USDT”... ,永续：“BTC-USDT-210625”...
pair false(请看备注) string 交易对 BTC-USDT
contract_type false(请看备注) string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
direction false string 买卖方向（不填默认全部） "buy":买 "sell":卖
offset false string 开平方向（不填默认全部） "open":开 "close":平

Response: 

{
    "status": "ok",
    "data": {
        "errors": [],
        "successes": "826054813483597824,826054818734866432,826054867657228288"
    },
    "ts": 1616988442893
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
<errors> true object 字典
order_id true string 跟踪委托订单ID[全局唯一]
err_code false long 错误码
err_msg false string 错误信息
</errors>
successes true string 成功的订单
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】跟踪委托订单当前委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
trade_type false int 交易类型（不填默认查询全部） 0:全部, 1:买入开多, 2: 卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50

Response: 

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "buy",
                "offset": "open",
                "lever_rate": 5,
                "order_id": 826055066114916352,
                "order_id_str": "826055066114916352",
                "order_source": "api",
                "created_at": 1616988475122,
                "order_price_type": "formula_price",
                "status": 2,
                "callback_rate": 0.030000000000000000,
                "active_price": 48888.000000000000000000,
                "is_active": 0,
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1616988497109
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 BTC-USDT
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
direction true string 买卖方向 买："buy",卖："sell"
offset true string 开平方向 开："open", 平："close", "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 跟踪委托订单ID
order_id_str true string 字符串类型的跟踪委托订单ID
order_source true string 来源
created_at true long 订单创建时间
order_price_type true string 订单报价类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20，理论价格：formula_price
status true int 订单状态： 2:等待委托、4:已委托、5:委托失败、6:已撤单
callback_rate true decimal 回调幅度 如：0.01 表示1%
active_price true decimal 激活价格
is_active true int 激活价格是否已激活 1：已激活；0：未激活
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如：“BTC-USDT”
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】查询跟踪委托订单当前委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
pair false string 交易对 BTC-USDT
trade_type false int 交易类型（不填默认查询全部） 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50

Response: 

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "quarter",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "buy",
                "offset": "open",
                "lever_rate": 1,
                "order_id": 918819679173152768,
                "order_id_str": "918819679173152768",
                "order_source": "api",
                "created_at": 1639105282359,
                "order_price_type": "formula_price",
                "status": 2,
                "callback_rate": 0.030000000000000000,
                "active_price": 41111.000000000000000000,
                "is_active": 0,
                "margin_mode": "cross",
                "margin_account": "USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639105312766
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
direction true string 买卖方向 买："buy",卖："sell"
offset true string 开平方向 开："open",平："close", "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 跟踪委托订单ID
order_id_str true string 字符串类型的跟踪委托订单ID
order_source true string 来源
created_at true long 订单创建时间
order_price_type true string 订单报价类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20，理论价格：formula_price
status true int 订单状态： 2:等待委托、4:已委托、5:委托失败、6:已撤单
callback_rate true decimal 回调幅度 如：0.01 表示1%
active_price true decimal 激活价格
is_active true int 激活价格是否已激活 1：已激活；0：未激活
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如：“BTC-USDT”
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【逐仓】跟踪委托订单历史委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 BTC-USDT
status true string 订单状态 多个以英文逗号隔开，跟踪委托订单状态：0:全部（表示全部结束状态的订单）、4:已委托、5:委托失败、6:已撤单
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）
create_date true long 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

Response: 

{
    "status":"ok",
    "data":{
        "orders":[
            {
                "symbol":"BTC",
                "contract_code":"BTC-USDT",
                "triggered_price":null,
                "volume":1,
                "order_type":1,
                "direction":"sell",
                "offset":"open",
                "lever_rate":5,
                "order_id":826054686706565120,
                "order_id_str":"826054686706565120",
                "order_source":"api",
                "created_at":1616988384665,
                "update_time":1616988430833,
                "order_price_type":"formula_price",
                "status":6,
                "canceled_at":1616988393365,
                "fail_code":null,
                "fail_reason":null,
                "callback_rate":0.03,
                "active_price":51111,
                "is_active":0,
                "market_limit_price":null,
                "formula_price":null,
                "real_volume":0,
                "relation_order_id":"-1",
                "margin_mode":"isolated",
                "margin_account":"BTC-USDT",
                "reduce_only": 0
            }
        ],
        "total_page":1,
        "current_page":1,
        "total_size":4
    },
    "ts":1616989113947
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 BTC-USDT
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
direction true string 买卖方向 买："buy",卖："sell"
offset true string 开平方向 开："open", 平："close", "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 跟踪委托订单ID
order_id_str true string 字符串类型的跟踪委托订单ID
order_source true string 来源
created_at true long 订单创建时间
update_time true long 订单更新时间，单位：毫秒
order_price_type true string 订单报价类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20 ，理论价格：formula_price
status true int 订单状态： 2:等待委托、4:已委托、5:委托失败、6:已撤单
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
callback_rate true decimal 回调幅度 如：0.01 表示1%
active_price true decimal 激活价格
is_active true int 激活价格是否已激活 1：已激活；0：未激活
market_limit_price true decimal 市场最低/最高价（买入则为市场最低价、卖出则为市场最高价）
formula_price true decimal 理论价格（市场最低（最高）价的（1 ± 回调幅度））
real_volume true decimal 实际委托数量
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如：“BTC-USDT”
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

【全仓】跟踪委托订单历史委托

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
pair false（请看备注） string 交易对 BTC-USDT
status true string 订单状态 多个以英文逗号隔开，跟踪委托订单状态：0:全部（表示全部结束状态的订单）、4:已委托、5:委托失败、6:已撤单
trade_type true int 交易类型（不填默认查询全部） 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 17：买入（单向持仓）, 18：卖出（单向持仓）
create_date true long 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 第几页，不填默认第一页
page_size false int 不填默认20，不得多于50
sort_by false string 排序字段（降序），不填默认按照created_at降序 "created_at"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

Response: 

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "quarter",
                "business_type": "futures",
                "pair": "BTC-USDT",
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211231",
                "triggered_price": null,
                "volume": 1.000000000000000000,
                "order_type": 1,
                "direction": "buy",
                "offset": "open",
                "lever_rate": 1,
                "order_id": 918819679173152768,
                "order_id_str": "918819679173152768",
                "order_source": "api",
                "created_at": 1639105282359,
                "update_time": 1639105426243,
                "order_price_type": "formula_price",
                "status": 6,
                "canceled_at": 1639105426208,
                "fail_code": null,
                "fail_reason": null,
                "callback_rate": 0.030000000000000000,
                "active_price": 41111.000000000000000000,
                "is_active": 0,
                "market_limit_price": null,
                "formula_price": null,
                "real_volume": 0,
                "relation_order_id": "-1",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 1
    },
    "ts": 1639105441911
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" :成功, "error"：失败
<data> true object 字典
total_page true int 总页数
total_size true int 总条数
current_page true int 当前页
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
volume true decimal 委托数量
order_type true int 订单类型：1、报单 2、撤单
direction true string 买卖方向 买："buy", 卖："sell"
offset true string 开平方向 开："open", 平："close", "both"：单向持仓
lever_rate true int 杠杆倍数
order_id true long 跟踪委托订单ID
order_id_str true string 字符串类型的跟踪委托订单ID
order_source true string 来源
created_at true long 订单创建时间
update_time true long 订单更新时间，单位：毫秒
order_price_type true string 订单报价类型 最优5档：optimal_5，最优10档：optimal_10，最优20档：optimal_20 ，理论价格：formula_price
status true int 订单状态： 2:等待委托、4:已委托、5:委托失败、6:已撤单
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因
callback_rate true decimal 回调幅度 如：0.01 表示1%
active_price true decimal 激活价格
is_active true int 激活价格是否已激活 1：已激活；0：未激活
market_limit_price true decimal 市场最低/最高价（买入则为市场最低价、卖出则为市场最高价）
formula_price true decimal 理论价格（市场最低（最高）价的（1 ± 回调幅度））
real_volume true decimal 实际委托数量
triggered_price true decimal 被触发时的价格
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
margin_mode true string 保证金模式 cross：全仓模式
margin_account true string 保证金账户 比如：“BTC-USDT”
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
</data>
ts true long 响应生成时间点，单位：毫秒

U本位合约划转接口

【全仓】查询系统划转权限

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account false string 保证金账户，不填则返回所有全仓数据 "USDT"，目前只有一个全仓账户（USDT）

Response 


{
    "status": "ok",
    "data": [
        {
            "margin_mode": "cross",
            "margin_account": "USDT",
            "transfer_in": 1,
            "transfer_out": 1,
            "master_transfer_sub": 1,
            "sub_transfer_master": 1,
            "master_transfer_sub_inner_in": 1,
            "master_transfer_sub_inner_out": 1,
            "sub_transfer_master_inner_in": 1,
            "sub_transfer_master_inner_out": 1,
            "transfer_inner_in": 1,
            "transfer_inner_out": 1
        }
    ],
    "ts": 1606905619516
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
transfer_in true int 从币币转入的权限："1"表示可用，“0”表示不可用
transfer_out true int 转出至币币的权限："1"表示可用，“0”表示不可用
master_transfer_sub true int 从母账号划转到子账号的权限："1"表示可用，“0”表示不可用
sub_transfer_master true int 从子账号划转到母账号的权限："1"表示可用，“0”表示不可用
master_transfer_sub_inner_in true int 母账号划转到子账号的转入权限-跨账户："1"表示可用，“0”表示不可用
master_transfer_sub_inner_out true int 母账号划转到子账号的转出权限-跨账户："1"表示可用，“0”表示不可用
sub_transfer_master_inner_in true int 子账号划转到母账号的转入权限-跨账户："1"表示可用，“0”表示不可用
sub_transfer_master_inner_out true int 子账号划转到母账号的转出权限-跨账户："1"表示可用，“0”表示不可用
transfer_inner_in true int 同账号不同保证金账户划转的转入权限："1"表示可用，“0”表示不可用
transfer_inner_out true int 同账号不同保证金账户划转的转出权限："1"表示可用，“0”表示不可用
</data>

【通用】现货-U本位合约账户间进行资金的划转

实例

备注

该接口支持全仓模式和逐仓模式

此接口用户币币现货账户与U本位合约账户之间的资金划转。

该接口的访问频次的限制为1秒/1次。

注意：请求地址为火必Global地址

现货与U本位合约划转接口，所有划转的币的精度是8位小数。

请求参数

参数名称 是否必须 类型 描述 取值范围
from true string 来源业务线账户，取值：spot(币币)、linear-swap(U本位合约) e.g. spot
to true string 目标业务线账户，取值：spot(币币)、linear-swap(U本位合约) e.g. linear-swap
currency true string 币种,支持大小写 e.g. usdt
amount true decimal 划转金额
margin-account true string 保证金账户 e.g. btc-usdt、eth-usdt、USDT

备注

Response:


 正确的返回：
{
    "code": 200,
    "data": 176104252,
    "message": "Succeed",
    "success": true
}
错误的返回：
 {
   "code":1303,
   "data":null,
   "message":"The single transfer-out amount must be no less than 0.0008BTC",
   "success":false
}

返回参数

参数名称 是否必须 类型 描述 取值范围
success true string 状态 true/false
data true long 生成的划转订单id
code true long 响应码
message true string 响应信息

响应码列表

响应码 中文说明 英文说明
200 成功 Succeed
403 拒绝访问 Access denied
404 访问的资源不存在 The resource being accessed does not exist
429 太多的请求 too many requests
500 系统错误 System error
501 无效请求 Invalid request
502 无效参数 Invalid parameter
504 缺少参数 Lack of parameter
512 拒绝匿名请求 Reject anonymous requests
513 无效的签名 Invalid signature
10000 币种不存在 Currency does not exist
10001 不支持同业务划转 Does not support transfer within single business
10002 不支持此划转业务 This transfer is not supported
10003 from方check校验不通过 check rejected by the from party
10004 to方check校验不通过 to check rejected by the to party
10005 个人账户平账检查不通过 Personal account balance check failed
10006 系统账户检查失败 System account check failed
10008 黑名单校验不通过 Blacklist check failed
10009 用户有未安全上账资产，禁止划转 No transfer is allowed if the user has any asset that has not been charged to the account safely
10010 用户被锁定 User locked
10011 24小时内修改过安全策略 Security policy has been modified within 24 hours
20001 OTC 人脸识别 OTC Face Recognition
1030 服务异常，请稍后再试 Abnormal service. Please try again later.
1010 用户不存在 Abnormal service. Please try again later.
1012 账户不存在 Abnormal service. Please contact customer service.
1013 合约品种不存在 This contract type doesn't exist.
1018 主账号不存在 Main account doesn't exist.
1089 {0}合约暂时限制划转,请联系客服 {0} contract is restricted of transfer. Please contact customer service.
1102 您没有转入权限,请联系客服 Unable to transfer in currently. Please contact customer service.
1103 您没有转出权限,请联系客服 Unable to transfer out currently. Please contact customer service.
1106 合约状态异常,暂时无法划转 Abnormal contracts status. Can’t transfer.
1111 子账号没有转入权限,请联系客服 Sub-account doesn't own the permissions to transfer in. Please contact customer service.
1112 子账号没有转出权限,请联系客服 sub-account doesn't own the permissions to transfer out. Please contact customer service.
1114 子账号没有划转权限,请登录主账号授权 The sub-account does not have transfer permissions. Please login main account to authorize.
1300 划转失败 Transfer failed.
1301 可划转余额不足 Insufficient amount available.
1302 系统划转错误 Transfer failed.
1303 单笔转出的数量不能低于{0}{1} The single transfer-out amount must be no less than {0}{1}.
1304 单笔转出的数量不能高于{0}{1} The single transfer-out amount must be no more than {0}{1}.
1305 单笔转入的数量不能低于{0}{1} The single transfer-in amount must be no less than {0}{1}.
1306 单笔转入的数量不能高于{0}{1} The single transfer-in amount must be no more than {0}{1}.
1307 您当日累计转出量超过{0}{1}, 暂无法转出 Your accumulative transfer-out amount is over the daily maximum, {0}{1}. You can't transfer out for the time being.
1308 您当日累计转入量超过{0}{1}, 暂无法转入 Your accumulative transfer-in amount is over the daily maximum, {0}{1}. You can't transfer in for the time being.
1309 您当日累计净转出量超过{0}{1}, 暂无法转出 Your accumulative net transfer-out amount is over the daily maximum, {0}{1}. You can't transfer out for the time being.
1310 您当日累计净转入量超过{0}{1}, 暂无法转入 Your accumulative net transfer-in amount is over the daily maximum, {0}{1}. You can't transfer in for the time being.
1311 超过平台当日累计最大转出量限制, 暂无法转出 The platform's accumulative transfer-out amount is over the daily maximum. You can't transfer out for the time being.
1312 超过平台当日累计最大转入量限制, 暂无法转入 The platform's accumulative transfer-in amount is over the daily maximum. You can't transfer in for the time being.
1313 超过平台当日累计最大净转出量限制, 暂无法转出 The platform's accumulative net transfer-out amount is over the daily maximum. You can't transfer out for the time being.
1314 超过平台当日累计最大净转入量限制, 暂无法转入 The platform's accumulative net transfer-in amount is over the daily maximum. You can't transfer in for the time being.
1315 划转类型错误 Wrong transfer type.
1316 划转冻结失败 Failed to freeze the transfer.
1317 划转解冻失败 Failed to unfreeze the transfer.
1318 划转确认失败 Failed to confirm the transfer.
1319 查询可划转金额失败 Failed to acquire the available transfer amount.
1320 此合约在非交易状态中, 无法进行系统划 The contract status is abnormal. Transfer is unavailable temporarily.
1321 划转失败, 请稍后重试或联系客服 Transfer failed. Please try again later or contact customer service.
1322 划转金额必须大于0 Invalid amount. Must be more than 0.
1323 服务异常, 划转失败, 请稍后再试 Abnormal service, transfer failed. Please try again later.
1327 无划转权限, 划转失败, 请联系客服 No transfer permission, transfer failed, please contact customer service.
1328 无划转权限, 划转失败, 请联系客服 No transfer permission, transfer failed, please contact customer service.
1329 无划转权限, 划转失败, 请联系客服 No transfer permission, transfer failed, please contact customer service.
1330 无划转权限, 划转失败, 请联系客服 No transfer permission, transfer failed, please contact customer service.
1331 超出划转精度限制(8位), 请修改后操作 Exceeds limit of transfer accuracy (8 digits). Please modify it.

合约Websocket简介

接口列表

权限类型 接口数据类型 接口模式 请求方法 类型 描述 需要验签
读取 市场行情接口 通用 market.$contract_code.kline.$period sub 【通用】订阅 KLine 数据 否
读取 市场行情接口 通用 market.$contract_code.kline.$period req 【通用】请求 KLine 数据 否
读取 市场行情接口 通用 market.$contract_code.depth.$type sub 【通用】订阅 Market Depth 数据 否
读取 市场行情接口 通用 market.$contract_code.depth.size_${size}.high_freq sub 【通用】订阅 Market Depth增量推送数据 否
读取 市场行情接口 通用 market.$contract_code.bbo sub 【通用】买一卖一逐笔行情推送 否
读取 市场行情接口 通用 market.$contract_code.detail sub 【通用】订阅 Market detail 数据 否
读取 市场行情接口 通用 market.$contract_code.trade.detail req 【通用】请求 Trade detail 数据 否
读取 市场行情接口 通用 market.$contract_code.trade.detail sub 【通用】订阅 Trade Detail 数据 否
读取 指数与基差接口 通用 market.$contract_code.index.$period sub 【通用】订阅指数K线数据 否
读取 指数与基差接口 通用 market.$contract_code.index.$period req 【通用】请求指数K线数据 否
读取 指数与基差接口 通用 market.$contract_code.basis.$period.$basis_price_type sub 【通用】订阅基差数据 否
读取 指数与基差接口 通用 market.$contract_code.basis.$period.$basis_price_type req 【通用】请求基差数据 否
读取 指数与基差接口 通用 market.$contract_code.premium_index.$period sub 【通用】订阅溢价指数K线数据 否
读取 指数与基差接口 通用 market.$contract_code.premium_index.$period req 【通用】请求溢价指数K线数据 否
读取 指数与基差接口 通用 market.$contract_code.estimated_rate.$period sub 【通用】订阅预测资金费率K线数据 否
读取 指数与基差接口 通用 market.$contract_code.estimated_rate.$period req 【通用】请求预测资金费率K线数据 否
读取 指数与基差接口 通用 market.$contract_code.mark_price.$period sub 【通用】订阅标记价格 K 线数据 否
读取 指数与基差接口 通用 market.$contract_code.mark_price.$period req 【通用】请求标记价格 K 线数据 否
读取 交易接口 通用 public.$contract_code.liquidation_orders sub 【通用】订阅强平订单数据（免鉴权） 否
读取 交易接口 通用 public.$contract_code.funding_rate sub 【通用】订阅资金费率变动数据（免鉴权） 否
读取 交易接口 通用 public.$contract_code.contract_info sub 【通用】订阅合约信息变动数据（免鉴权） 否
读取 交易接口 逐仓 orders.$contract_code sub 【逐仓】订阅订单成交数据 是
读取 资产接口 逐仓 accounts.$contract_code sub 【逐仓】订阅资产变动数据 是
读取 资产接口 逐仓 positions.$contract_code sub 【逐仓】订阅持仓变动更新数据 是
读取 交易接口 逐仓 matchOrders.$contract_code sub 【逐仓】订阅撮合订单成交数据 是
读取 交易接口 逐仓 trigger_order.$contract_code sub 【逐仓】订阅计划委托订单更新ws推送 是
读取 资产接口 全仓 orders_cross.$contract_code sub 【全仓】订阅订单成交数据 是
读取 资产接口 全仓 accounts_cross.$margin_account sub 【全仓】订阅资产变动数据 是
读取 交易接口 全仓 positions_cross.$contract_code sub 【全仓】订阅持仓变动更新数据 是
读取 交易接口 全仓 matchOrders_cross.$contract_code sub 【全仓】订阅撮合订单成交数据 是
读取 交易接口 全仓 trigger_order_cross.$contract_code sub 【全仓】订阅计划委托订单变动 是
读取 系统状态接口 通用 public.$service.heartbeat sub 【通用】订阅系统状态更新 否

合约订阅地址

合约站行情请求以及订阅地址为：wss://api.hbdm.com/linear-swap-ws

合约站订单推送订阅地址：wss://api.hbdm.com/linear-swap-notification

合约站指数K线及基差数据订阅地址：wss://api.hbdm.com/ws_index

合约站系统状态更新订阅地址：wss://api.hbdm.com/center-notification

如果api.hbdm.com域名访问不了，可使用：

合约站行情请求以及订阅地址为：wss://api.btcgateway.pro/linear-swap-ws

合约站订单推送订阅地址：wss://api.btcgateway.pro/linear-swap-notification

合约站指数K线及基差数据订阅地址：wss://api.btcgateway.pro/ws_index

合约站系统状态更新订阅地址：wss://api.btcgateway.pro/center-notification

如果对合约订单推送订阅有疑问，可以参考 Demo

备注

如果api.hbdm.com无法访问，可以使用api.btcgateway.pro来做调试，AWS服务器用户推荐使用api.hbdm.vn；

访问次数限制

公开行情接口和用户私有接口都有访问次数限制

api接口response中的header返回以下字段

WebSocket心跳以及鉴权接口

市场行情心跳

{"ping": 18212558000}

{"pong": 18212558000}

注：WebSocket Client 和 WebSocket Server 建立连接之后，WebSocket Server 每隔 5s（这个频率可能会变化） 会向 WebSocket Client 发起一次心跳，WebSocket Client 忽略心跳 5 次后，WebSocket Server 将会主动断开连接；WebSocket Client发送最近 2 次心跳message中的其中一个ping的值，WebSocket Server都会保持WebSocket连接。

订单推送心跳

{

"op": "ping",

"ts": "1492420473058"

}

{

"op": "pong"

"ts": "1492420473058"

}

备注：

{

"op": "error"

"ts": "1492420473027",

"err-code": 2011

"err-msg": “详细出错信息”

}

订单推送访问地址

合约站订单推送订阅地址：wss://api.hbdm.com/linear-swap-notification

备注

如果api.hbdm.com无法访问，可以使用api.btcgateway.pro来做调试，AWS服务器用户推荐使用api.hbdm.vn；

正常ws请求连接不能同时超过30个

数据压缩

WebSocket API 返回的所有数据都进⾏了 GZIP 压缩，需要 client 在收到数据之后解压

请求与响应数据说明

请求数据结构如下:


   {
  "op": string, // 必填;Client 请求的操作类型(Server 会原样返回)，详细操作
  类型列列表请参考附录
  "cid": string, // 选填;当前请求唯一 ID(Client 自⽣成并保证本地唯一性，
  Server 会原样返回) 
  // 其余必填/可选字段
  }

所有响应/推送数据都会以固定的结构返回，具体接口说明文档中只会重点介绍data部分，请求响应数据结构如下:


  {
  "op": string, // 必填;本次响应 Client 请求的操作类型
  "cid": string, // 选填;Client 请求唯一 ID
  "ts": long, // 必填;Server 应答时本地时间戳
  "err-code": integer, // 必填;响应码，0 代表成功;非0 代表出错，详细响应码列表请参考错误码表。
  "err-msg": string, 只在出错情况下有此信息，表明详细的出错信息 
  "data": object // 选填;返回数据对象，请求处理成功时有效
  }

推送数据结构如下:


  {
  "op": "string", // 必填;Server 推送的操作类型，详细操作类型列表请参考附录
  "ts": long, // 必填;Server 推送时本地时间戳
  "data": object // 必填;返回数据对象
  }

服务方主动断开连接

在建连和鉴权期间，如果出错，服务方会主动断开连接，在关闭之前推送数据结构如下,

{

"op": "close", // 表明是服务⽅方主动断开连接

"ts": long // Server 推送时本地时间戳

}

服务方返回错误，但不断开连接

鉴权成功后，在客户方提供非法Op或者某些内部错误的情况下，服务方会返回错误，但并不断开连接

{

"op": "error", // 表明是收到非法op或者内部错误

"ts": long// Server 推送时本地时间戳

}

鉴权-Authentication

用户自⼰在火必网⽣成Access Key和Secret Key，Secret Key由用户自⼰保存，⽤户需提供Access Key。目前关于 apikey 申请和修改，请在“账户 - API 管理 ” 创建新API Key 填写备注(可选择绑定 ip)点击创建。其中 Access Key 为 API 访问密钥，Secret Key 为用户对请求进⾏签名的密钥(仅申请时可见)。用户按规则生成签名(Signature)。

交易功能 websocket 版本接⼝建立连接时首先要做鉴权操作，具体格式如下，

重要提示：这两个密钥与账号安全紧密相关，无论何时都请勿向其它人透露。

鉴权请求数据格式

{

"op": "auth",

"type": "api",

"AccessKeyId": "e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx",

"SignatureMethod": "HmacSHA256",

"SignatureVersion": "2",

"Timestamp": "2017-05-11T15:19:30",

"Signature": "4F65x5A2bLyMWVQj3Aqp+B4w+ivaA7n5Oi2SuYtCJ9o=",

}

鉴权请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，鉴权固定值为auth
type string 必填；认证方式 api表示接口认证，ticket 表示终端认证
cid string 选填；Client请求唯一ID
AccessKeyId string type的值为api时必填；API 访问密钥, 您申请的 APIKEY 中的 AccessKey
SignatureMethod string type的值为api时必填；签名方法, 用户计算签名的基于哈希的协议，此处使用 HmacSHA256
SignatureVersion string type的值为api时必填；签名协议的版本，此处使用 2
Timestamp string type的值为api时必填；时间戳, 您发出请求的时间 (UTC 时区) 。在查询请求中包含此值有助于防止第三方截取您的请求。如:2017-05-11T16:22:06。再次强调是 (UTC 时区)
Signature string type的值为api时必填；签名, 计算得出的值，用于确保签名有效和未被篡改
ticket string type的值为ticket时必填；登陆时返回

注意：

步骤：

示例例参数签名(Signature)计算过程如下，

GET\n

api.hbdm.com\n

/linear-swap-notification\n

AccessKeyId=e2xxxxxx-99xxxxxx-84xxxxxx-7xxxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15%3A19%3A30

计算签名，将以下两个参数传入加密哈希函数: 要进行签名计算的字符串，进行签名的密钥(SecretKey)

得到签名计算结果并进行 Base64编码

将上述值作为参数Signature的取值添加到 API 请求中。 将此参数添加到请求时，必须将该值进⾏URI编码。

鉴权应答数据格式说明

名称 类型 说明
op string 必填；操作名称，鉴权固定值为 auth
type string 必填；根据请求的参数进行返回。
cid string 选填；请求时携带则会返回。
err-code int 成功返回 0, 失败为其他值，详细响应码列列表请参考附录
err-msg string 可选，若出错表示详细错误信息
ts long 服务端应答时间戳
user-id long ⽤户 id

鉴权成功应答数据示例


{
  "op": "auth",
  "type":"api",
  "ts": 1489474081631,
  "err-code": 0,
  "data": {
    "user-id": 12345678
  }
}

鉴权失败应答返回数据示例


{
"op": "auth",
"type":"api",
"ts": 1489474081631, 
"err-code": xxxx， 
"err-msg": ”详细的错误信息“
}

WebSocket市场行情接口

【通用】订阅 KLine 数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.kline.$period",

"id": "id generate by client"

}

正确订阅请求参数的例子：


 {
    "sub": "market.BTC-USDT.kline.1min",
    "id": "id1"
 }

订阅成功返回数据的例子:


  {
      "id": "id1",
      "status": "ok",
      "subbed": "market.BTC-USDT.kline.1min",
      "ts": 1489474081631
  }

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.kline.$period，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线周期 仅支持小写：1min, 5min, 15min, 30min, 1hour,4hour,1day, 1mon

返回参数

参数名称 是否必须 类型 描述
ch true string 请求参数
ts true long 响应生成时间点，单位：毫秒
<tick>
id true long K线ID,也就是K线时间戳，K线起始时间
mrid true long 订单ID
vol true decimal 成交量张数。 值是买卖双边之和
count true decimal 成交笔数。 值是买卖双边之和
open true decimal 开盘价
close true decimal 收盘价,当K线为最晚的一根时，是最新成交价
low true decimal 最低价
high true decimal 最高价
amount true decimal 成交量(币), 即 sum(每一笔成交量(张) * 单张合约面值/该笔成交价)。 值是买卖双边之和
trade_turnover true decimal 成交额, 即sum（每一笔成交张数 * 合约面值 * 成交价格）。 值是买卖双边之和
</tick>

之后每当 KLine 有更新时，client 会收到数据:


{
    "ch":"market.BTC-USDT.kline.1min",
    "ts":1603707124366,
    "tick":{
        "id":1603707120,
        "mrid":131592424,
        "open":13067.7,
        "close":13067.7,
        "high":13067.7,
        "low":13067.7,
        "amount":0.004,
        "vol":4,
        "trade_turnover":52.2708,
        "count":1
    }
}

【通用】请求 KLine 数据

备注

成功建立和 WebSocket API 的连接之后，向Server发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.kline.$period",

"id": "id generated by client",

"from": " type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒",

"to": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大"

}

请求 KLine 数据请求参数的例子：


    {
    "req": "market.BTC-USDT.kline.1min",
    "id": "id4",
    "from": 1579247342,
    "to": 1579247342
    }

请求参数

参数名称 是否必须 类型 描述 取值范围
req true string 需要订阅的主题，该接口固定为：market.$contract_code.kline.$period，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
from true long 开始时间
to true long 结束时间

req请求参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线周期 1min, 5min, 15min, 30min, 60min,4hour,1day,1week, 1mon

备注

[t1, t5] 假设有 t1 ~ t5 的K线：

from: t1, to: t5, return [t1, t5].

from: t5, to: t1, which t5 > t1, return [].

from: t5, return [t5].

from: t3, return [t3, t5].

to: t5, return [t1, t5].

from: t which t3 < t <t4, return [t4, t5].

to: t which t3 < t <t4, return [t1, t3].

from: t1 and to: t2, should satisfy 1325347200 < t1 < t2 < 2524579200.

一次最多2000条。

请求成功返回数据的例子：


{
    "id":"id4",
    "rep":"market.BTC-USDT.kline.60min",
    "wsid":467277265,
    "status":"ok",
    "data":[
        {
            "id":1603270800,
            "open":12198,
            "close":12196.7,
            "low":11715.8,
            "high":12300,
            "amount":0.276,
            "vol":276,
            "trade_turnover":3315.9104,
            "count":39
        },
        {
            "id":1603274400,
            "open":12196.7,
            "close":12277.9,
            "low":12111,
            "high":12289.9,
            "amount":0.198,
            "vol":198,
            "trade_turnover":2420.7728,
            "count":21
        }
    ]
}

返回参数

参数名称 是否必须 类型 描述
rep true string 请求参数
status true string 状态
id true string 请求id
wsid true long wsid
<data>
id true long K线ID,也就是K线时间戳，K线起始时间
vol true decimal 成交量张数。 值是买卖双边之和
count true decimal 成交笔数。 值是买卖双边之和
open true decimal 开盘价
close true decimal 收盘价,当K线为最晚的一根时，是最新成交价
low true decimal 最低价
high true decimal 最高价
amount true decimal 成交量(币), 即 sum(每一笔成交量(张) * 单张合约面值/该笔成交价)。 值是买卖双边之和
trade_turnover true decimal 成交额, 即sum（每一笔成交张数 * 合约面值 * 成交价格）。 值是买卖双边之和
</data>

【通用】订阅 Market Depth 数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.depth.$type",

"id": "id generated by client"

}

正确订阅请求参数的例子： 


    {                                          
    "sub": "market.BTC-USDT.depth.step0",       
    "id": "id5"                                
    }

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.depth.$type，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
type true string Depth 类型 (150档数据) step0, step1, step2, step3, step4, step5, step14, step15, step16, step17（合并深度1-5,14-17）,step0时，不合并深度;(20档数据) step6, step7, step8, step9, step10, step11, step12, step13, step18, step19（合并深度7-13,18-19）；step6时，不合并深度；

备注

档位 Depth 类型 精度
150档 step0 不合并
150档 step16 0.0000001
150档 step17 0.000001
150档 step1 0.00001
150档 step2 0.0001
150档 step3 0.001
150档 step4 0.01
150档 step5 0.1
150档 step14 1
150档 step15 10
20档 step6 不合并
20档 step18 0.0000001
20档 step19 0.000001
20档 step7 0.00001
20档 step8 0.0001
20档 step9 0.001
20档 step10 0.01
20档 step11 0.1
20档 step12 1
20档 step13 10

之后每当 depth 有更新时，client 会收到数据，例子：


{
    "ch":"market.BTC-USDT.depth.step6",
    "ts":1603707576468,
    "tick":{
        "mrid":131596447,
        "id":1603707576,
        "bids":[
            [
                13071.9,
                38
            ],
            [
                13068,
                5
            ]
        ],
        "asks":[
            [
                13081.9,
                197
            ],
            [
                13099.7,
                371
            ]
        ],
        "ts":1603707576467,
        "version":1603707576,
        "ch":"market.BTC-USDT.depth.step6"
    }
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.period
ts true long 数据进入行情服务器时间戳，单位：毫秒
<tick>
mrid true long 订单ID
id true long tick ID
asks false object 卖盘,[price(挂单价), vol(此价格挂单张数)], 按price升序
bids false object 买盘,[price(挂单价), vol(此价格挂单张数)], 按price降序
ts true long 深度生成时间戳，每100MS生成一次，单位：毫秒
version true long 版本号
ch true string 数据所属的 channel，格式： market.period
</tick>

【通用】订阅Market Depth增量数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来请求数据:

{

"sub": "market.$contract_code.depth.size_${size}.high_freq",

"data_type":"incremental",

"id": "id generated by client"

}

正确订阅请求参数的例子： 


{
  "sub": "market.BTC-USDT.depth.size_20.high_freq",
  "data_type":"incremental",
  "id": "id generated by client"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.depth.size_${size}.high_freq，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID
data_type false string Depth 类型 不填默认为全量数据，"incremental"：增量数据，"snapshot"：全量数据

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
size true string 档位数 20:表示20档不合并的深度，150:表示150档不合并的深度

response：

{
    "ch":"market.BTC-USDT.depth.size_20.high_freq",
    "tick":{
        "asks":[
            [
                13081.9,
                206
            ],
            [
                13099.7,
                371
            ]
        ],
        "bids":[
            [
                13071.9,
                38
            ],
            [
                13060,
                400
            ]
        ],
        "ch":"market.BTC-USDT.depth.size_20.high_freq",
        "event":"snapshot",
        "id":131597620,
        "mrid":131597620,
        "ts":1603707712356,
        "version":1512467
    },
    "ts":1603707712357
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$contract_code.depth.size_${size}.high_freq
ts true long 进入行情服务器系统时间点，单位：毫秒
<tick>
mrid true long 订单ID
id true long tick ID
asks true object 卖盘,[price(挂单价), vol(此价格挂单张数)], 按price升序
bids true object 买盘,[price(挂单价), vol(此价格挂单张数)], 按price降序
ts true long 系统检测orderbook时间点，单位：毫秒
version true long 版本号
ch true string 数据所属的 channel，格式： market.$symbol.depth.size_${size}.high_freq
event true string 事件类型；"update":更新，表示推送买卖各20档或150档不合并深度的增量数据；"snapshot":快照值，表示推送买卖各20档或150档不合并深度的全量数据
</tick>

备注

1、当"data_type"为incremental时，首次推送的"event"为"snapshot"的数据，且当重新发送订阅请求时，首次返回都是"snapshot"的数据；

2、深度即可以按照合约周期订阅，也可以按照合约代码订阅，行情系统在进行数据计算时，需要更新对应类型的数据；

3、version（版本号），是自增的序号，每次增加1，不管是增量还是全量数据,每个连接是唯一的。多个websocket连接的version是可能不同的。

4、每30ms检查一次orderbook，如果有更新，则推送，如果没有更新，则不推送。

5、如果是增量数据，要自己维护好本地的orderbook bids\asks 数据。

【通用】订阅 Market Detail 数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来请求数据:

{

"sub": "market.$contract_code.detail",

"id": "id generated by client"

}

订阅 Market Detail 数据请求参数的例子：


 {                                    
  "sub": "market.BTC-USDT.detail",     
  "id": "id6"                         
 }

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.detail，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

请求成功返回数据的例子：


{
    "ch":"market.BTC-USDT.detail",
    "ts":1603707870528,
    "tick":{
        "id":1603707840,
        "mrid":131599205,
        "open":12916.2,
        "close":13065.8,
        "high":13205.3,
        "low":12852.8,
        "amount":30.316,
        "vol":30316,
        "trade_turnover":395073.4918,
        "count":2983,
        "asks":[
            13081.9,
            206
        ],
        "bids":[
            13071.9,
            38
        ]
    }
}

返回参数

参数名称 是否必须 数据类型 描述
ch true string 数据所属的 channel，格式： market.$contract_code.detail
ts true long 响应生成时间点，单位：毫秒
<tick>
id true long ID
mrid true long 订单ID
open true decimal 开盘价
close true decimal 收盘价,当K线为最晚的一根时，是最新成交价
high true decimal 最高价
low true decimal 最低价
amount true decimal 成交量(币), 即 sum(每一笔成交量(张) * 单张合约面值/该笔成交价)。 值是买卖双边之和
vol true decimal 成交量（张）。 值是买卖双边之和
trade_turnover true decimal 成交额，即sum（每一笔成交张数 * 合约面值 * 成交价格）。 值是买卖双边之和
count true decimal 成交笔数
ask true array [卖1价,卖1量(张)]
bid true array [买1价,买1量(张)]
</tick>

备注

【通用】订阅买一卖一逐笔行情推送

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"sub": "market.$contract_code.bbo",

"id": "id generated by client"

}

正确请求参数的例子：


    {
     "sub": "market.BTC-USDT.bbo",
     "id": "id8"
    }

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.bbo，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub请求参数说明

字段名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

返回示例:


{
    "ch":"market.BTC-USDT.bbo",
    "ts":1603707934525,
    "tick":{
        "mrid":131599726,
        "id":1603707934,
        "bid":[
            13064,
            38
        ],
        "ask":[
            13072.3,
            205
        ],
        "ts":1603707934525,
        "version":131599726,
        "ch":"market.BTC-USDT.bbo"
    }
}

返回参数说明：

参数名称 是否必须 数据类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$contract_code.bbo
ts true long 响应生成时间点，单位：毫秒（指接口响应时间）
<tick> true object
ch true string 数据所属的 channel，格式： market.$contract_code.bbo
mrid true string 订单ID
id true long tick ID
ask false array 卖一盘,[price(挂单价), vol(此价格挂单张数)]
bid false array 买一盘,[price(挂单价), vol(此价格挂单张数)]
version true long 版本号
ts true long 响应生成时间点，单位：毫秒（指数据生成时间）
</tick>

说明：

【通用】请求 Trade Detail 数据

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.trade.detail",

"id": "id generated by client"

}

仅返回当前 Trade Detail

请求 Trade Detail 数据请求参数的例子：


    {
     "req": "market.BTC-USDT.trade.detail",
     "size": 50 ,
     "id": "id8"
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.trade.detail，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
size false int 数据条数，最多50，不填默认50 [1,50]

req请求参数说明

字段名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

请求成功返回数据的例子：


{
    "data":[
        {
            "amount":"22",
            "ts":1603706942240,
            "id":1315909380000,
            "price":"13068.4",
            "direction":"sell",
            "quantity": "0.022",
            "trade_turnover": "288.334"
        },
        {
            "amount":"2",
            "ts":1603706947767,
            "id":1315909430000,
            "price":"13068.5",
            "direction":"buy",
            "quantity": "0.002",
            "trade_turnover": "26.334"
        }
    ],
    "id":"id8",
    "rep":"market.BTC-USDT.trade.detail",
    "status":"ok",
    "ts":1603708046534
}

返回参数

参数名称 是否必须 类型 描述 取值范围
rep true string 数据所属的 channel，格式： market.$contract_code.trade.detail
status true string 返回状态
id true long 请求唯一 ID
<data>
id true long 成交唯一id（品种唯一）
price true string 价格
amount true string 数量（张）。 值是买卖双边之和
direction true string 买卖方向，即taker(主动成交)的方向
ts true long 订单成交时间
quantity true string 成交量（币）
trade_turnover true string 成交额（计价币种）
</data>
ts true long 发送时间

备注

【通用】订阅 Trade Detail 数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.trade.detail",

"id": "id generated by client"

}

正确订阅请求参数的例子：


    {
     "sub": "market.BTC-USDT.trade.detail",
     "id": "id7"
    }

请求参数

参数名称 是否必须 类型 描述 取值范围
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.trade.detail，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

之后每当 Trade Detail 有更新时，client 会收到数据，例子：


{
    "ch":"market.BTC-USDT.trade.detail",
    "ts":1603708208346,
    "tick":{
        "id":131602265,
        "ts":1603708208335,
        "data":[
            {
                "amount":2,
                "ts":1603708208335,
                "id":1316022650000,
                "price":13073.3,
                "direction":"buy",
                "quantity": 0.002,
                "trade_turnover": 26.334
            }
        ]
    }
}

返回参数

参数名称 是否必须 类型 描述 取值范围
ch true string 数据所属的 channel，格式： market.$contract_code.trade.detail
ts true long 发送时间
<tick>
id true long 订单唯一id（品种唯一）
ts true long tick数据戳
<data>
amount true decimal 数量（张）。 值是买卖双边之和
ts true long 订单时间戳
id true long 成交唯一id（品种唯一）
price true decimal 价格
direction true string 买卖方向，即taker(主动成交)的方向
quantity true decimal 成交量（币）
trade_turnover true decimal 成交额（计价币种）
</data>
</tick>

WebSocket指数与基差数据接口

【通用】订阅(sub)指数K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.index.$period",

"id": "id generate by client"

}

正确订阅请求参数的例子：


    {
    "sub": "market.BTC-USDT.index.1min",
    "id": "id1"
    }

请求参数

参数名称 是否必须 类型 描述 默认值
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.index.$period，详细参数见sub订阅参数说明
id false string 业务方自主生成的id

sub订单参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 指数标识 支持大小写，"BTC-USDT","ETH-USDT"...
period true string K线类型 仅支持小写,1min, 5min, 15min, 30min, 60min,4hour,1day, 1mon

备注

之后每当 KLine 有更新时，client 会收到数据


{
    "ch":"market.BTC-USDT.index.15min",
    "ts":1607309592214,
    "tick":{
        "id":1607309100,
        "open":"19213.505",
        "close":"19242.05",
        "high":"19248.31",
        "low":"19213.505",
        "amount":"0",
        "vol":"0",
        "count":0
    }
}

返回参数

参数名称 类型 描述 默认值 取值范围
ch string 数据所属的 channel，格式： market.$contract_code.index.$period
ts long 响应生成时间点，单位：毫秒
tick object array tick返回，详情：推送tick参数

推送tick参数

参数名称 类型 描述
id string 指数K线id,也就是K线时间戳，K线起始时间
vol string 成交量张数为0
count decimal 成交笔数为0
open string 开盘指数价
close string 收盘指数价
low string 最低指数价
high string 最高指数价
amount string 数值为0

【通用】请求(req)指数K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.index.$period",

"id": "id generated by client",

"from": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒",

"to": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大",

}

正确订阅请求参数的例子:


    {
    "req": "market.btc-usdt.index.1min",
    "id": "id4",
    "from":1571000000,
    "to":1573098606
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.index.$period，详细参数见req请求参数说明
id false string 业务方自主生成的id
from true long 开始时间,2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒
to true long 结束时间, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大

req请求参数说明：

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 指数标识 支持大小写, "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1mon

说明：

请求成功返回数据的例子：


{
    "id":"id4",
    "rep":"market.BTC-USDT.index.15min",
    "wsid":3673570133,
    "ts":1607310136031,
    "status":"ok",
    "data":[
        {
            "id":1607309100,
            "open":19213.505,
            "close":19207.245,
            "low":19207.245,
            "high":19248.31,
            "amount":0,
            "vol":0,
            "count":0
        },
        {
            "id":1607310000,
            "open":19199.655,
            "close":19174.48,
            "low":19174.48,
            "high":19208.11,
            "amount":0,
            "vol":0,
            "count":0
        }
    ]
}

返回参数

参数名称 类型 描述 默认值 取值范围
req true string 数据所属的 channel，格式：market.$contract_code.index.$period
status true string 请求处理结果 "ok" , "error"
id true string 业务方id
wsid true long wsid
ts true long 响应生成时间点，单位：毫秒
tick object array tick返回，详情：推送tick参数

推送tick参数

参数名称 类型 描述
id decimal 指数K线id,也就是K线时间戳，K线起始时间
vol decimal 成交量张数为0
count decimal 成交笔数为0
open decimal 开盘指数价
close decimal 收盘指数价
low decimal 最低指数价
high decimal 最高指数价
amount decimal 数值为0

【通用】订阅溢价指数K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.premium_index.$period",

"id": "id generated by client"

}

正确订阅请求参数的例子：


    {
     "sub": "market.BTC-USDT.premium_index.1min",
     "id": "id7"
    }

请求参数

参数名称 是否必须 类型 描述 默认值
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.premium_index.$period，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

之后每当溢价指数有更新时，client 会收到数据，例子：


{
    "ch":"market.BTC-USDT.premium_index.1min",
    "ts":1603708380380,
    "tick":{
        "id":1603708380,
        "open":"0.000068125",
        "close":"0.000068125",
        "high":"0.000068125",
        "low":"0.000068125",
        "amount":"0",
        "vol":"0",
        "count":"0"
    }
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
ch true string 数据所属的 channel，格式： market.period
<tick> true object array
id true long 指数K线ID,也就是K线时间戳，K线起始时间
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值（溢价指数）
close true string 收盘值（溢价指数）
low true string 最低值（溢价指数）
high true string 最高值 （溢价指数）
amount true string 成交量(币), 数值为0
</tick>
ts true long 响应生成时间点，单位：毫秒

【通用】请求溢价指数K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.premium_index.$period",

"id": "id generated by client",

"from": " type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒",

"to": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大"

}

数据请求参数的例子：


    {
    "req": "market.BTC-USDT.premium_index.1min",
    "id": "id4",
    "from":1571000000,
    "to":1573098606
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.premium_index.$period，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
from true long 开始时间（时间戳，单位秒）
to true long 结束时间 （时间戳，单位秒）

req请求参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

备注：

请求成功返回数据的例子：


{
    "id":"id4",
    "rep":"market.BTC-USDT.premium_index.15min",
    "wsid":1524762738,
    "ts":1603782744066,
    "status":"ok",
    "data":[
        {
            "id":1603641600,
            "open":"0",
            "close":"0.0000970833333333",
            "low":"0",
            "high":"0.0000997916666666",
            "amount":"0",
            "vol":"0",
            "count":"0"
        }
    ]
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
rep true string 数据所属的 channel，格式： market.period
status true string 请求处理结果 "ok" , "error"
id true string 业务方id
wsid true long wsid
ts true long 响应生成时间点，单位：毫秒
<data> true object array
id true long 指数K线ID,也就是K线时间戳，K线起始时间
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值（溢价指数）
close true string 收盘值（溢价指数）
low true string 最低值 （溢价指数）
high true string 最高值 （溢价指数）
amount true string 成交量(币), 数值为0
</data>

【通用】订阅预测资金费率K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.estimated_rate.$period",

"id": "id generated by client"

}

正确订阅请求参数的例子：


    {
     "sub": "market.btc-usdt.estimated_rate.1min",
     "id": "id7"
    }

请求参数

参数名称 是否必须 类型 描述 默认值
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.estimated_rate.$period，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

之后每当预测资金费率有更新时，client 会收到数据，例子：


{
    "ch":"market.BTC-USDT.estimated_rate.1min",
    "ts":1603708560233,
    "tick":{
        "id":1603708560,
        "open":"0.0001",
        "close":"0.0001",
        "high":"0.0001",
        "low":"0.0001",
        "amount":"0",
        "vol":"0",
        "count":"0",
        "trade_turnover":"0"
    }
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
ch true string 数据所属的 channel，格式： market.period
<tick> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值 （预测资金费率）
close true string 收盘值 （预测资金费率）
low true string 最低值 （预测资金费率）
high true string 最高值 （预测资金费率）
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额 数值为0
</tick>
ts true long 响应生成时间点，单位：毫秒

【通用】请求预测资金费率K线数据

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.estimated_rate.$period",

"id": "id generated by client",

"from": " type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒",

"to": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大"

}

数据请求参数的例子：


    {
    "req": "market.BTC-USDT.estimated_rate.1min",
    "id": "id4",
    "from": 1579247342,
    "to": 1579247342
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.estimated_rate.$period，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
from true long 开始时间（时间戳，单位秒）
to true long 结束时间 （时间戳，单位秒）

req请求参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

备注：

请求成功返回数据的例子：


{
    "id":"id4",
    "rep":"market.BTC-USDT.estimated_rate.15min",
    "wsid":3674722864,
    "ts":1603782867314,
    "status":"ok",
    "data":[
        {
            "id":1603641600,
            "open":"0.0001",
            "close":"0.0001",
            "low":"0.0001",
            "high":"0.0001",
            "amount":"0",
            "vol":"0",
            "count":"0",
            "trade_turnover":"0"
        }
    ]
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
rep true string 数据所属的 channel，格式： market.period
status true string 请求处理结果 "ok" , "error"
id true string 业务方id
wsid true long wsid
ts true long 响应生成时间点，单位：毫秒
<data> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值（预测资金费率）
close true string 收盘值（预测资金费率）
low true string 最低值（预测资金费率）
high true string 最高值 （预测资金费率）
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额 数值为0
</data>

【通用】订阅基差数据

备注

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.basis.$period.$basis_price_type",

"id": "id generated by client"

}

正确订阅请求参数的例子：


    {
     "sub": "market.BTC-USDT.basis.1min.open",
     "id": "id7"
    }

请求参数

参数名称 是否必须 类型 描述 默认值
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.basis.$period.$basis_price_type，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string 周期 1min, 5min, 15min, 30min, 60min,4hour,1day,1week, 1mon
basis_price_type false string 基差价格类型，表示在周期内计算基差使用的价格类型 不填，默认为使用开盘价 开盘价：open，收盘价：close，最高价：high，最低价：low，平均价=（最高价+最低价）/2：average

订阅成功后收到的数据，例子：


{
    "ch":"market.BTC-USDT.basis.1min.open",
    "ts":1617164081549,
    "tick":{
        "id":1617164040,
        "index_price":"58686.78333333333",
        "contract_price":"58765",
        "basis":"78.21666666667",
        "basis_rate":"0.0013327816285723049700163397705562309"
    }
}

返回参数

参数名称 类型 描述 默认值 取值范围
ch string 数据所属的 channel，格式： market.period
<tick> object array
id long 唯一标识
contract_price string 合约最新成交价
index_price string 指数基准价，与基差价格类型匹配
basis string 基差=合约基准价 - 指数基准价
basis_rate string 基差率=基差/指数基准价
</tick>
ts long 响应生成时间点，单位：毫秒

【通用】请求基差数据

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.basis.$period.$basis_price_type",

"id": "id generated by client",

"from": " type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒",

"to": "type: long, 2017-07-28T00:00:00+08:00 至2050-01-01T00:00:00+08:00 之间的时间点，单位：秒，必须比 from 大"

}

数据请求参数的例子：


    {
    "req": "market.btc-usdt.basis.1min.open",
    "id": "id4",
    "from": 1579247342,
    "to": 1579247342
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.basis.$period.$basis_price_type，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
from true long 开始时间（时间戳，单位秒）
to true long 结束时间 （时间戳，单位秒）

req请求参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string 周期 1min, 5min, 15min, 30min, 60min,4hour,1day,1week, 1mon
basis_price_type false string 基差价格类型，表示在周期内计算基差使用的价格类型 不填，默认为使用开盘价 开盘价：open，收盘价：close，最高价：high，最低价：low，平均价=（最高价+最低价）/2：average

请求成功返回数据的例子：


{
    "data":[
        {
            "basis":"-27.593412766666006",
            "basis_rate":"-0.0021317871729511838",
            "contract_price":"12916.2",
            "id":1603641600,
            "index_price":"12943.793412766667"
        }
    ],
    "id":"id4",
    "rep":"market.BTC-USDT.basis.15min.open",
    "status":"ok",
    "ts":1603783024207,
    "wsid":1308653018
}

返回参数

参数名称 类型 描述 默认值 取值范围
rep true string 数据所属的 channel，格式： market.basis
status true string 请求处理结果 "ok" , "error"
id true string 业务方id
wsid true long wsid
ts true long 响应生成时间点，单位：毫秒
<data> object array
id true long 唯一标识
contract_price true string 合约最新成交价
index_price true string 指数基准价，与基差价格类型匹配
basis true string 基差=合约基准价 - 指数基准价
basis_rate true string 基差率=基差/指数基准价
</data>

【通用】订阅标记价格K线数据

备注：

成功建立和 WebSocket API 的连接之后，向 Server发送如下格式的数据来订阅数据：

{

"sub": "market.$contract_code.mark_price.$period",

"id": "id generate by client"

}

正确订阅请求参数的例子：


 {
    "sub": "market.BTC-USDT.mark_price.1min",
    "id": "id1"
 }

请求参数

参数名称 是否必须 类型 描述 默认值
sub true string 需要订阅的主题，该接口固定为：market.$contract_code.mark_price.$period，详细参数见sub订阅参数说明
id false string 选填;Client 请求唯一 ID

sub订阅参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

当标记价格有更新时，client 会收到数据，例如：


{
 "ch": "market.BTC-USDT.mark_price.1min",
 "ts": 1489474082831,
 "tick": 
    {
      "vol": "0",
      "close": "9800.12",
      "count": "0",
      "high": "9800.12",
      "id": 1529898780,
      "low": "9800.12",
      "open": "9800.12",
      "trade_turnover": "0",
      "amount": "0"
    }
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
ch true string 数据所属的 channel，格式： market.period
<tick> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值
close true string 收盘值
low true string 最低值
high true string 最高值
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额, 数值为0
</tick>
ts true long 响应生成时间点，单位：毫秒

【通用】请求标记价格K线数据

备注：

成功建立和 WebSocket API 的连接之后，向Server发送如下格式的数据来请求数据：

{

"req": "market.$contract_code.mark_price.$period",

"id": "id generated by client",

"from": " type: long, 单位：秒",

"to": "type: long,单位：秒，必须比 from 大"

}

请求参数的例子：


    {
    "req": "market.BTC-USDT.mark_price.5min",
    "id": "id4",
    "from": 1579247342,
    "to": 1579247342
    }

请求参数

参数名称 是否必须 类型 描述 默认值
req true string 需要订阅的主题，该接口固定为：market.$contract_code.mark_price.$period，详细参数见req请求参数说明
id false string 选填;Client 请求唯一 ID
from true long 开始时间
to true long 结束时间

req请求参数说明

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 或 合约标识 永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period true string K线类型 1min, 5min, 15min, 30min, 60min,4hour,1day, 1week, 1mon

备注

请求成功返回数据的例子：

{
 "rep": "market.BTC-USDT.mark_price.1min",
 "status": "ok",
 "id": "id4",
 "wsid": 1231323423,
 "ts": 1579489028884,
 "data": [
   {
      "vol": "0",
      "close": "9800.12",
      "count": "0",
      "high": "9800.12",
      "id": 1529898780,
      "low": "9800.12",
      "open": "9800.12",
      "trade_turnover": "0",
      "amount": "0"
   }
 ]
}

返回参数

参数名称 是否必须 类型 描述 默认值 取值范围
req true string 数据所属的 channel，格式： market.period
status true string 请求处理结果 "ok" , "error"
id true string 业务方id
wsid true long wsid
ts true long 响应生成时间点，单位：毫秒
<data> true object array
id true long k线id
vol true string 成交量(张)，数值为0
count true string 成交笔数，数值为0
open true string 开盘值
close true string 收盘值
low true string 最低值
high true string 最高值
amount true string 成交量(币), 数值为0
trade_turnover true string 成交额, 数值为0
</data>

WebSocket订单和用户数据接口

【逐仓】订阅订单成交数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"cid": "cid",

"topic": "orders.$contract_code"

}

正确的订阅请求:


{
  "op": "sub",
  "cid": "40sG903yz80oDFWr",
  "topic": "orders.btc-usdt"
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (orders.$contract_code) 订阅、取消订阅某个合约下的成交订单信息； $contract_code为合约代码（BTC-USDT、ETH-USDT...），如果值为 * 时代表订阅所有合约;

备注：

成交详情通知数据格式说明


{
    "op": "notify", 
    "topic": "orders.btc-usdt", 
    "ts": 1489474082831, 
    "uid": "123456789",
    "symbol": "BTC", 
    "contract_code": "BTC-USDT", 
    "volume": 111, 
    "price": 1111, 
    "order_price_type": "limit",
    "direction": "buy", 
    "offset": "open", 
    "status": 6,
    "lever_rate": 10, 
    "order_id":758684042347171840,
    "order_id_str":"758684042347171840", 
    "client_order_id": 10683, 
    "order_source": "web", 
    "order_type": 1, 
    "created_at": 1408076414000,
    "trade_volume": 1,
    "trade_turnover": 1200, 
    "fee": 0, 
    "liquidation_type": "0",
    "trade_avg_price": 10, 
    "margin_asset": "USDT",
    "margin_frozen": 10, 
    "profit": 2,
    "canceled_at": 1408076414000, 
    "fee_asset": "USDT",
    "margin_mode": "isolated",
    "margin_account": "BTC-USDT",
    "is_tpsl": 0,
    "real_profit": 0,
    "reduce_only": 0,
    "trade": [{
        "trade_id":14469,
        "id":"14469-758684042347171840-1", 
        "trade_volume": 1, 
        "trade_price": 123.4555, 
        "trade_fee": 0.234,
        "fee_asset": "USDT", 
        "trade_turnover": 34.123, 
        "created_at": 1490759594752, 
        "role": "maker",
        "profit": 2,
        "real_profit": 0
  }]
}

成交推送请求数据格式说明

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平, "both"：单向持仓
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string string格式的订单ID
client_order_id true long 客户订单ID
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
created_at true long 订单创建时间
trade_volume true decimal 成交总数量
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 订单总平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
liquidation_type true decimal 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
canceled_at true long 撤单时间
fee_asset true string 手续费币种 “USDT”
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 订单总真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trade> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_fee true decimal 成交手续费
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格 ）
created_at true long 成交创建时间
role true string taker或maker
real_profit true decimal 该笔成交的真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
profit true decimal 该笔成交的平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
fee_asset true string 手续费币种 “USDT”
</trade>

备注：

【逐仓】取消订阅订单成交数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "orders.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                
  "op": "unsub",                   
  "topic": "orders.BTC-USDT",       
  "cid": "40sG903yz80oDFWr"        
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;待取消订阅主题名称:orders.$contract_code，订阅、取消订阅某个合约下的成交订单信息； $contract_code为合约代码（BTC-USDT、ETH-USDT...），如果值为 * 时代表订阅所有合约;

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
orders.* orders.* 允许
orders.contract_code1 orders.* 允许
orders.contract_code1 orders.contract_code1 允许
orders.contract_code1 orders.contract_code2 不允许
orders.* orders.contract_code1 不允许

【全仓】订阅订单成交数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"cid": "cid",

"topic": "orders_cross.$contract_code"

}

正确的订阅请求:


{
  "op": "sub",
  "cid": "40sG903yz80oDFWr",
  "topic": "orders_cross.btc-usdt"
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (orders_cross.$contract_code) 订阅某个合约下的成交订单信息； 详情请查看sub请求参数说明

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

备注：

成交详情通知数据格式说明

{
    "contract_type":"swap",
    "pair":"BTC-USDT",
    "business_type":"swap",
    "op":"notify",
    "topic":"orders_cross.btc-usdt",
    "ts":1639107468139,
    "symbol":"BTC",
    "contract_code":"BTC-USDT",
    "volume":1,
    "price":48284.9,
    "order_price_type":"opponent",
    "direction":"buy",
    "offset":"open",
    "status":6,
    "lever_rate":5,
    "order_id":918828846806306816,
    "order_id_str":"918828846806306816",
    "client_order_id":null,
    "order_source":"api",
    "order_type":1,
    "created_at":1639107468086,
    "trade_volume":1,
    "trade_turnover":48.2849,
    "fee":-0.01931396,
    "trade_avg_price":48284.9,
    "margin_frozen":0,
    "profit":0,
    "trade":[
        {
            "trade_fee":-0.01931396,
            "fee_asset":"USDT",
            "real_profit":0,
            "profit":0,
            "trade_id":86875552122,
            "id":"86875552122-918828846806306816-1",
            "trade_volume":1,
            "trade_price":48284.9,
            "trade_turnover":48.2849,
            "created_at":1639107468102,
            "role":"taker"
        }
    ],
    "canceled_at":0,
    "fee_asset":"USDT",
    "margin_asset":"USDT",
    "uid":"123456789",
    "liquidation_type":"0",
    "margin_mode":"cross",
    "margin_account":"USDT",
    "is_tpsl":1,
    "real_profit":0,
    "reduce_only": 0
}

成交推送请求数据格式说明

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 委托数量
price true decimal 委托价格
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平, "both"：单向持仓
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单
lever_rate true int 杠杆倍数
order_id true long 订单ID
order_id_str true string string格式的订单ID
client_order_id true long 客户订单ID
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
created_at true long 订单创建时间
trade_volume true decimal 成交总数量
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 订单总平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
liquidation_type true decimal 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
canceled_at true long 撤单时间
fee_asset true string 手续费币种 “USDT”
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 订单总真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trade> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_cross_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_fee true decimal 成交手续费
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格 ）
created_at true long 成交创建时间
role true string taker或maker
real_profit true decimal 该笔成交的真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
profit true decimal 该笔成交的平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
fee_asset true string 手续费币种 “USDT”
</trade>

备注：

【全仓】取消订阅订单成交数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "orders_cross.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                
  "op": "unsub",                   
  "topic": "orders_cross.BTC-USDT",       
  "cid": "40sG903yz80oDFWr"        
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;待取消订阅主题名称:orders_cross.$contract_code，取消订阅某个合约下的成交订单信息；详情请查看unsub请求参数说明

unsub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
orders_cross.* orders_cross.* 允许
orders_cross.contract_code1 orders_cross.* 允许
orders_cross.contract_code1 orders_cross.contract_code1 允许
orders_cross.contract_code1 orders_cross.contract_code2 不允许
orders_cross.* orders_cross.contract_code1 不允许

【逐仓】资产变动数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"topic": "accounts.$contract_code",

"cid": "id generated by client",

}

正确的订阅请求: 


{                                   
  "op": "sub",                      
  "cid": "40sG903yz80oDFWr",        
  "topic": "accounts.BTC-USDT"       
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 必填；订阅主题名称，必填 (accounts.$contract_code) 订阅、取消订阅某个合约代码下的资产变更信息，当 $contract_code值为 * 时代表订阅所有合约代码; contract_code支持大小写，比如BTC-USDT

备注：

当资产有更新时，返回的参数示例如下:


{
    "op":"notify",
    "topic":"accounts.btc-usdt",
    "ts":1603711370689,
    "event":"order.open",
    "data":[
        {
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "margin_balance":79.72434662,
            "margin_static":79.79484662,
            "margin_position":1.31303,
            "margin_frozen":4.0662,
            "margin_available":74.34511662,
            "profit_real":0.03405608,
            "profit_unreal":-0.0705,
            "withdraw_available":74.34511662,
            "risk_rate":14.745772976801512484,
            "liquidation_price":92163.420962779156327543,
            "lever_rate":10,
            "adjust_factor":0.075,
            "margin_asset":"USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "uid":"123456789"
}

返回字段说明

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
event true string 资产变化通知相关事件说明 比如订单创建开仓(order.open) 、订单成交(order.match)（除开强平和结算交割）、结算交割(settlement)、订单强平成交(order.liquidation)（对钆和接管仓位）、订单撤销(order.cancel) 、合约账户划转（contract.transfer)（包括外部划转、母子划转和不同保证金账户划转）、系统（contract.system)、其他资产变化(other)、切换杠杆（switch_lever_rate）、初始资金（init）、由系统定期推送触发（snapshot）、ADL成交
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 "BTC-USDT","ETH-USDT"...
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
risk_rate true decimal 保证金率
liquidation_price true decimal 预估强平价
withdraw_available true decimal 可划转数量
lever_rate true int 杠杆倍数
adjust_factor true decimal 调整系数
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

【逐仓】取消订阅资产变动数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "accounts.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                 
  "op": "unsub",                  
  "topic": "accounts.BTC-USDT",    
  "cid": "40sG903yz80oDFWr"       
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;必填；必填；订阅主题名称，必填 (accounts.$contract_code) 订阅、取消订阅某个合约代码下的资产变更信息，当 $contract_code值为 * 时代表订阅所有合约代码;contract_code支持大小写;

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
accounts.* accounts.* 允许
accounts.contract_code1 accounts.* 允许
accounts.contract_code1 accounts.contract_code1 允许
accounts.contract_code1 accounts.contract_code2 不允许
accounts.* accounts.contract_code1 不允许

【全仓】资产变动数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"topic": "accounts_cross.$margin_account",

"cid": "id generated by client",

}

正确的订阅请求: 


{                                   
  "op": "sub",                      
  "cid": "40sG903yz80oDFWr",        
  "topic": "accounts_cross.USDT"       
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 必填；订阅主题名称，必填 (accounts_cross.$margin_account) 订阅、取消订阅某个全仓账户下的资产变更信息，margin_account目前只有一个全仓账户（USDT）

备注：

当资产有更新时，返回的参数示例如下:


{
    "op":"notify",
    "topic":"accounts_cross",
    "ts":1640756528985,
    "event":"snapshot",
    "data":[
        {
            "margin_mode":"cross",
            "margin_account":"USDT",
            "margin_asset":"USDT",
            "margin_balance":20.60340161555383535,
            "margin_static":20.47570161555383535,
            "margin_position":19.30352,
            "margin_frozen":0,
            "profit_real":-0.01911684,
            "profit_unreal":0.1277,
            "withdraw_available":1.17218161555383535,
            "risk_rate":25.683477437733940947,
            "position_mode": "dual_side",
            "contract_detail":[
                {
                    "symbol":"BTC",
                    "contract_code":"BTC-USDT",
                    "margin_position":9.55638,
                    "margin_frozen":0,
                    "margin_available":1.29988161555383535,
                    "profit_unreal":-0.0102,
                    "liquidation_price":27790.709661740085332661,
                    "lever_rate":5,
                    "adjust_factor":0.04,
                    "contract_type":"swap",
                    "pair":"BTC-USDT",
                    "business_type":"swap"
                }
            ],
            "futures_contract_detail":[
                {
                    "symbol":"BTC",
                    "contract_code":"BTC-USDT-220325",
                    "margin_position":9.74714,
                    "margin_frozen":0,
                    "margin_available":1.29988161555383535,
                    "profit_unreal":0.1379,
                    "liquidation_price":28744.509661740085332661,
                    "lever_rate":5,
                    "adjust_factor":0.04,
                    "contract_type":"quarter",
                    "pair":"BTC-USDT",
                    "business_type":"futures"
                }
            ]
        }
    ],
    "uid":"123456789"
}

返回字段说明

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
event true string 资产变化通知相关事件说明 比如订单创建开仓(order.open) 、订单成交(order.match)（除开强平和结算交割）、结算交割(settlement)、订单强平成交(order.liquidation)（对钆和接管仓位）、订单撤销(order.cancel) 、合约账户划转（contract.transfer)（包括外部划转、母子划转和不同保证金账户划转）、系统（contract.system)、其他资产变化(other)、切换杠杆（switch_lever_rate） 、初始资金（init）、由系统定期推送触发（snapshot）、ADL成交
<data> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
margin_asset true string 保证金币种（计价币种）
margin_balance true decimal 账户权益
margin_static true decimal 静态权益
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
profit_real true decimal 已实现盈亏
profit_unreal true decimal 未实现盈亏
withdraw_available true decimal 可划转数量
risk_rate true decimal 保证金率
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
<contract_detail> true object array 支持永续的合约相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续："BTC-USDT" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</contract_detail>
<futures_contract_detail> true object array 支持交割的合约相关字段
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 交割："BTC-USDT-211231" ...
margin_position true decimal 持仓保证金（当前持有仓位所占用的保证金）
margin_frozen true decimal 冻结保证金
margin_available true decimal 可用保证金
profit_unreal true decimal 未实现盈亏
liquidation_price true decimal 预估强平价
lever_rate true decimal 杠杠倍数
adjust_factor true decimal 调整系数
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</futures_contract_detail>
</data>

【全仓】取消订阅资产变动数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "accounts_cross.$margin_account",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                 
  "op": "unsub",                  
  "topic": "accounts_cross.USDT",    
  "cid": "40sG903yz80oDFWr"       
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填；订阅主题名称，必填 (accounts_cross.$margin_account) 订阅、取消订阅某个全仓账户的资产变更信息

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
accounts_cross.* accounts_cross.* 允许
accounts_cross.margin_account1 accounts_cross.* 允许
accounts_cross.margin_account1 accounts_cross.margin_account1 允许
accounts_cross.margin_account1 accounts_cross.margin_account2 不允许
accounts_cross.* accounts_cross.margin_account1 不允许

【逐仓】持仓变动更新数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"topic": "positions.$contract_code",

"cid": "topic to sub"

}

正确的订阅请求:


{                                 
  "op": "sub",                    
  "cid": "40sG903yz80oDFWr",      
  "topic": "positions.BTC-USDT"    
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 必填；订阅主题名称，必填 (positions.$contract_code) 订阅、取消订阅某个合约代码下的持仓变更信息，当 $contract_code值为 * 时代表订阅所有合约代码,contract_code支持大小写;

当持仓有更新时，返回的参数示例如下:


{
    "op":"notify",
    "topic":"positions",
    "ts":1603711371803,
    "event":"snapshot",
    "data":[
        {
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "volume":1,
            "available":0,
            "frozen":1,
            "cost_open":13059.8,
            "cost_hold":13059.8,
            "profit_unreal":-0.0705,
            "profit_rate":-0.05398244996094886,
            "profit":-0.0705,
            "position_margin":1.31303,
            "lever_rate":10,
            "direction":"sell",
            "last_price":13130.3,
            "margin_asset":"USDT",
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "position_mode": "dual_side"
        }
    ],
    "uid":"123456789"
}

返回参数

字段名称 类型 说明
op string
topic string 订阅主题
uid string 账户id
ts long 响应生成时间点，单位：毫秒
event string 持仓变化通知相关事件说明，比如订单创建平仓(order.close) 、订单成交(order.match)（除开强平和结算交割）、结算交割(settlement)、订单强平成交(order.liquidation)（对钆和接管仓位）、订单撤销(order.cancel)、切换杠杆（switch_lever_rate）、 初始持仓（init）、由系统定期推送触发（snapshot） 、ADL成交
<data> array object
symbol string 品种代码 ,"BTC","ETH"...
contract_code string 合约代码，"BTC-USDT"
volume decimal 持仓量
available decimal 可平仓数量
frozen decimal 冻结数量
cost_open decimal 开仓均价
cost_hold decimal 持仓均价
profit_unreal decimal 未实现盈亏
profit_rate decimal 收益率
profit decimal 收益
position_margin decimal 持仓保证金
lever_rate int 杠杆倍数
direction string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price decimal 最新价
margin_asset string 保证金币种（计价币种）
margin_account string 保证金账户 比如“BTC-USDT”
margin_mode string 保证金模式 isolated：逐仓模式
position_mode string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

备注：

【逐仓】取消订阅持仓变动数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "positions.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "positions.BTC-USDT",      
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;必填；必填；订阅主题名称，必填 (positions.$contract_code) 订阅、取消订阅某个合约代码下的资产变更信息，当 $contract_code值为 * 时代表订阅所有合约代码;contract_code支持大小写,比如BTC-USDT

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
positions.* positions.* 允许
positions.contract_code1 positions.* 允许
positions.contract_code1 positions.contract_code1 允许
positions.contract_code1 positions.contract_code2 不允许
positions.* positions.contract_code1 不允许

【全仓】持仓变动更新数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

订阅请求数据格式

{

"op": "sub",

"topic": "positions_cross.$contract_code",

"cid": "topic to sub"

}

正确的订阅请求:


{                                 
  "op": "sub",                    
  "cid": "40sG903yz80oDFWr",      
  "topic": "positions_cross.BTC-USDT"    
}

订阅请求数据格式说明

字段名称 类型 说明
op string 必填；操作名称，订阅固定值为sub
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (positions_cross.$contract_code) 订阅某个合约代码下的持仓变更信息，详情请查看sub请求参数说明

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

当持仓有更新时，返回的参数示例如下:


{
    "op":"notify",
    "topic":"positions_cross.btc-usdt",
    "ts":1639107468139,
    "event":"order.match",
    "data":[
        {
            "contract_type":"swap",
            "pair":"BTC-USDT",
            "business_type":"swap",
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "volume":1,
            "available":1,
            "frozen":0,
            "cost_open":48284.9,
            "cost_hold":48284.9,
            "profit_unreal":-0.0001,
            "profit_rate":-0.000010355204214985,
            "profit":-0.0001,
            "margin_asset":"USDT",
            "position_margin":9.65696,
            "lever_rate":5,
            "direction":"buy",
            "last_price":48284.8,
            "margin_mode":"cross",
            "margin_account":"USDT",
            "position_mode": "dual_side"
        }
    ],
    "uid":"123456789"
}

返回参数

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
event true string 持仓变化通知相关事件说明 比如订单创建平仓(order.close) 、订单成交(order.match)（除开强平和结算交割）、结算交割(settlement)、订单强平成交(order.liquidation)（对钆和接管仓位）、订单撤销(order.cancel) 、切换杠杆（switch_lever_rate）、初始持仓（init）、由系统定期推送触发（snapshot）、ADL成交
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
volume true decimal 持仓量（张）
available true decimal 可平仓数量 （张）
frozen true decimal 冻结数量（张）
cost_open true decimal 开仓均价
cost_hold true decimal 持仓均价
profit_unreal true decimal 未实现盈亏
profit_rate true decimal 收益率
profit true decimal 收益
margin_asset true string 保证金币种（计价币种）
position_margin true decimal 持仓保证金
lever_rate true int 杠杆倍数
direction true string 仓位方向 "buy":买，即多仓 "sell":卖，即空仓
last_price true decimal 最新成交价
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
position_mode true string 持仓模式 single_side：单向持仓；dual_side：双向持仓
</data>

备注：

【全仓】取消订阅持仓变动数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "positions_cross.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "positions_cross.BTC-USDT",      
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (positions_cross.$contract_code) 取消订阅某个合约代码下的资产变更信息，详情请查看unsub请求参数说明

unsub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
positions_cross.* positions_cross.* 允许
positions_cross.contract_code1 positions_cross.* 允许
positions_cross.contract_code1 positions_cross.contract_code1 允许
positions_cross.contract_code1 positions_cross.contract_code2 不允许
positions_cross.* positions_cross.contract_code1 不允许

【逐仓】订阅合约订单撮合数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "40sG903yz80oDFWr",

"topic": "matchOrders.$contract_code"

}

正确的订阅请求:


{                                    
  "op": "sub",                     
  "topic": "matchOrders.BTC-USDT",      
  "cid": "40sG903yz80oDFWr"          
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，(matchOrders.$contract_code) 订阅某个品种下的合约变动信息；$contract_code为品种代码（BTC-USDT、ETH-USDT），如果值为 * 时代表订阅所有品种; contract_code支持大小写;

备注：

返回的参数为：


{
    "op":"notify",
    "topic":"matchOrders.btc-usdt",
    "ts":1600926986125,
    "symbol":"BTC",
    "contract_code":"BTC-USDT",
    "status":6,
    "order_id":758688290195656704,
    "order_id_str":"758688290195656704",
    "client_order_id":null,
    "order_type":1,
    "created_at":1600926984112,
    "trade":[
        {
            "trade_id":14470,
            "id":"14470-758688290195656704-1",
            "trade_volume":1,
            "trade_price":10329.11,
            "trade_turnover":103.2911,
            "created_at":1600926986046,
            "role":"taker"
        }
    ],
    "uid":"123456789",
    "volume":1,
    "trade_volume":1,
    "direction":"buy",
    "offset":"open",
    "lever_rate":5,
    "price":10329.11,
    "order_source":"web",
    "order_price_type":"opponent",
    "margin_mode": "isolated",
    "margin_account": "BTC-USDT",
    "is_tpsl": 0,
    "reduce_only": 0
}

返回参数

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码
status true int 订单状态 (3未成交 4部分成交 5部分成交已撤单 6全部成交 7已撤单)
order_id true long 订单ID
order_id_str true string 订单ID ,字符串类型
client_order_id true long 客户订单id
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
trade_volume true decimal 订单已成交数量
volume true decimal 订单总委托数量
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平, "both"：单向持仓
lever_rate true int 杠杆倍数
price true decimal 委托价格
created_at true long 创建时间
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
is_tpsl true int 是否设置止盈止损 1：是；0：否
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trade> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_price true decimal 成交价格
trade_volume true decimal 成交量（张）
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价）
created_at true long 创建时间
role true string taker或maker
</trade>

【逐仓】取消订阅合约订单撮合数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "matchOrders.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "matchOrders.BTC-USDT",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;必填；必填；订阅主题名称，必填 (matchOrders.$contract_code) 订阅、取消订阅某个合约代码下的资产变更信息，当 $contract_code值为 * 时代表订阅所有合约代码;

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
matchOrders.* matchOrders.* 允许
matchOrders.contract_code1 matchOrders.* 允许
matchOrders.contract_code1 matchOrders.contract_code1 允许
matchOrders.contract_code1 matchOrders.contract_code2 不允许
matchOrders.* matchOrders.contract_code1 不允许

【全仓】订阅合约订单撮合数据（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "40sG903yz80oDFWr",

"topic": "matchOrders_cross.$contract_code"

}

正确的订阅请求:


{                                    
  "op": "sub",                     
  "topic": "matchOrders_cross.BTC-USDT",      
  "cid": "40sG903yz80oDFWr"          
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，(matchOrders_cross.$contract_code) 订阅某个品种下的合约订单撮合数据；详情请查看sub请求参数说明

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

备注：

返回的参数为：


{
    "contract_type":"swap",
    "pair":"BTC-USDT",
    "business_type":"swap",
    "op":"notify",
    "topic":"matchOrders_cross.btc-usdt",
    "ts":1639705640671,
    "uid":"123456789",
    "symbol":"BTC",
    "contract_code":"BTC-USDT",
    "status":6,
    "order_id":921337601229725696,
    "order_id_str":"921337601229725696",
    "client_order_id":null,
    "order_type":1,
    "volume":1,
    "trade_volume":1,
    "created_at":1639705601752,
    "direction":"sell",
    "offset":"open",
    "lever_rate":5,
    "price":47800,
    "order_source":"web",
    "order_price_type":"limit",
    "trade":[
        {
            "trade_id":87890603387,
            "id":"87890603387-921337601229725696-1",
            "trade_volume":1,
            "trade_price":47800,
            "trade_turnover":47.8,
            "created_at":1639705640641,
            "role":"maker"
        }
    ],
    "margin_mode":"cross",
    "margin_account":"USDT",
    "is_tpsl":1,
    "reduce_only": 0
}

返回参数

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
uid true string 用户uid
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
status true int 订单状态 (3未成交 4部分成交 5部分成交已撤单 6全部成交 7已撤单)
order_id true long 订单ID
order_id_str true string 订单ID ,字符串类型
client_order_id true long 客户订单id
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
trade_volume true decimal 订单已成交数量
volume true decimal 订单总委托数量
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平, "both"：单向持仓
lever_rate true int 杠杆倍数
price true decimal 委托价格
created_at true long 创建时间
is_tpsl true int 是否设置止盈止损 1：是；0：否
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true string 订单报价类型 "market": 市价，"limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc": 对手价-IOC下单，"optimal_5_ioc": 最优5档-IOC下单，"optimal_10_ioc": 最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单，"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
<trade> true object array
id true string 全局唯一的交易标识
trade_id true long 与linear-swap-api/v1/swap_cross_matchresults返回结果中的match_id一样，是撮合结果id， 非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果id
trade_price true decimal 成交价格
trade_volume true decimal 成交量（张）
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价）
created_at true long 创建时间
role true string taker或maker
</trade>

【全仓】取消订阅合约订单撮合数据（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "matchOrders_cross.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "matchOrders_cross.BTC-USDT",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填；订阅主题名称，必填 (matchOrders_cross.$contract_code) ,取消订阅某个合约订单撮合数据；详情请查看unsub请求参数说明

unsub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
matchOrders_cross.* matchOrders_cross.* 允许
matchOrders_cross.contract_code1 matchOrders_cross.* 允许
matchOrders_cross.contract_code1 matchOrders_cross.contract_code1 允许
matchOrders_cross.contract_code1 matchOrders_cross.contract_code2 不允许
matchOrders_cross.* matchOrders_cross.contract_code1 不允许

【通用】订阅强平订单数据(免鉴权)（sub）

备注

订阅强平订单数据格式

{

“op”: “sub”,

“topic": "public.$contract_code.liquidation_orders”,

"cid": "id generated by client”,

}

正确的订阅请求:


{
  "op": "sub",
  "cid": "40sG903yz80oDFWr",
  "topic": "public.BTC-USDT.liquidation_orders"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，必填 (public.$contract_code.liquidation_orders) 订阅某个品种下的强平订单信息；详细参数见sub请求参数说明
business_type false string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码,支持大小写 全部：*(请看备注中的说明) ，永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...

备注

当有订单被爆仓账户接管后，返回的参数示例如下：

{
    "op":"notify",
    "topic":"public.O3-USDT.liquidation_orders",
    "ts":1639122193214,
    "data":[
        {
            "symbol":"O3",
            "contract_code":"O3-USDT",
            "direction":"sell",
            "offset":"close",
            "volume":432,
            "price":0.7858,
            "created_at":1639122193172,
            "amount":432,
            "trade_turnover":339.4656,
            "contract_type":"swap",
            "pair":"O3-USDT",
            "business_type":"swap"
        }
    ]
}

返回参数说明

参数名称 是否必须 数据类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
<data> true array object
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...
direction true string 仓位方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平, "both"：单向持仓
volume true decimal 强平数量（张）
amount true decimal 强平数量（币）
trade_turnover true decimal 强平金额（计价币种）
price true decimal 破产价格
created_at true long 订单创建时间
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</data>

【通用】取消订阅强平订单(免鉴权)（unsub）

备注

取消订阅强平订单数据格式

{

“op”: “unsub”,

“topic": "public.$contract_code.liquidation_orders”,

"cid": "id generated by client”,

}

正确的取消订阅请求:


{
  "op": "unsub",
  "topic": "public.BTC-USDT.liquidation_orders",
  "cid": "40sG903yz80oDFWr"
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (public.$contract_code.liquidation_orders) 取消订阅某个品种下的强平订单数据，详细参数见nusub请求参数说明
business_type string 业务类型，不填默认永续。 futures：交割、swap：永续、all：全部

nusub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码,支持大小写 全部：*(请看备注中的说明) ，永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...

备注

订阅与取消订阅规则说明

订阅(sub) 业务类型 取消订阅(unsub) 业务类型 规则
public.*.liquidation_orders all public.*.liquidation_orders all 允许
public.*.liquidation_orders all public.*.liquidation_orders futures 不允许
public.*.liquidation_orders all public.*.liquidation_orders swap 不允许
public.*.liquidation_orders swap public.*.liquidation_orders all 允许
public.*.liquidation_orders futures public.*.liquidation_orders all 允许
public.*.liquidation_orders swap public.*.liquidation_orders futures 不允许
public.*.liquidation_orders swap public.*.liquidation_orders swap 允许
public.*.liquidation_orders futures public.*.liquidation_orders swap 不允许
public.*.liquidation_orders futures public.*.liquidation_orders futures 允许
public.$contract_code(swap).liquidation_orders all public.*.liquidation_orders all 允许
public.$contract_code(futures).liquidation_orders all public.*.liquidation_orders all 允许
public.$contract_code(swap).liquidation_orders all public.*.liquidation_orders futures 不允许
public.$contract_code(futures).liquidation_orders all public.*.liquidation_orders swap 不允许
public.$contract_code(futures).liquidation_orders all public.*.liquidation_orders futures 允许
public.$contract_code(swap).liquidation_orders all public.*.liquidation_orders swap 允许
public.$contract_code.liquidation_orders swap public.*.liquidation_orders swap 允许
public.$contract_code.liquidation_orders futures public.*.liquidation_orders futures 允许
public.$contract_code.liquidation_orders swap public.*.liquidation_orders futures 不允许
public.$contract_code.liquidation_orders futures public.*.liquidation_orders swap 不允许
public.contract_code1.liquidation_orders swap public.contract_code1.liquidation_orders swap 允许
public.contract_code1.liquidation_orders swap public.contract_code1.liquidation_orders futures 不允许
public.contract_code1.liquidation_orders swap public.contract_code1.liquidation_orders all 允许
public.contract_code1.liquidation_orders futures public.contract_code1.liquidation_orders futures 允许
public.contract_code1.liquidation_orders futures public.contract_code1.liquidation_orders swap 不允许
public.contract_code1.liquidation_orders futures public.contract_code1.liquidation_orders all 允许
public.contract_code1.liquidation_orders swap public.contract_code2.liquidation_orders swap 不允许
public.contract_code1.liquidation_orders swap public.contract_code2.liquidation_orders futures 不允许
public.contract_code1.liquidation_orders swap public.contract_code2.liquidation_orders all 不允许
public.contract_code1.liquidation_orders futures public.contract_code2.liquidation_orders futures 不允许
public.contract_code1.liquidation_orders futures public.contract_code2.liquidation_orders swap 不允许
public.contract_code1.liquidation_orders futures public.contract_code2.liquidation_orders all 不允许
public.*.liquidation_orders swap public.contract_code1.liquidation_orders swap 不允许
public.*.liquidation_orders futures public.contract_code1.liquidation_orders futures 不允许
public.*.liquidation_orders futures public.contract_code1.liquidation_orders swap 不允许
public.*.liquidation_orders swap public.contract_code1.liquidation_orders futures 不允许
public.*.liquidation_orders all public.contract_code1.liquidation_orders all 不允许
public.*.liquidation_orders all public.contract_code1.liquidation_orders all 不允许
public.*.liquidation_orders all public.contract_code1.liquidation_orders swap 不允许
public.*.liquidation_orders all public.contract_code1.liquidation_orders futures 不允许

【通用】订阅资金费率推送(免鉴权)（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "40sG903yz80oDFWr",

"topic": "public.$contract_code.funding_rate"

}

正确的订阅请求:


{
  "op": "sub",
  "topic": "public.btc-usdt.funding_rate",
  "cid": "40sG903yz80oDFWr"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，必填 (public.$contract_code.funding_rate) 订阅某个品种下的资金费率；$contract_code为品种代码（BTC-USDT、ETH-USDT），如果值为 * 时代表订阅所有品种; contract_code支持大小写;

当资金费率有更新时，返回的参数示例如下


{
    "op":"notify",
    "topic":"public.BTC-USDT.funding_rate",
    "ts":1603778748166,
    "data":[
        {
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "fee_asset":"USDT",
            "funding_time":"1603778700000",
            "funding_rate":"-0.000220068774978695",
            "estimated_rate":"-0.000684397270167616",
            "settlement_time":"1603785600000"
        }
    ]
}

返回参数

参数名称 是否必须 类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
ts true long 服务端应答时间戳
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码
fee_asset true string 资金费币种 "USDT"...
funding_time true string 当期资金费率时间
funding_rate true string 当期资金费率
estimated_rate true string 下一期预测资金费率
settlement_time true string 结算时间 如"1490759594752"
</data>

【通用】取消订阅资金费率(免鉴权)（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "public.$contract_code.funding_rate",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "public.BTC-USDT.funding_rate",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;必填；必填；订阅主题名称，必填 (public.$contract_code.funding_rate) 订阅、取消订阅某个合约代码下的资金费率，当 $contract_code值为 * 时代表订阅所有合约代码;

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
public.*.funding_rate pubic.*.funding_rate 允许
public.contract_code1.funding_rate public.*.funding_rate 允许
public.contract_code1.funding_rate public.contract_code1.funding_rate 允许
public.contract_code1.funding_rate public.contract_code2.funding_rate 不允许
public.*.funding_rate public.contract_code1.funding_rate 不允许

备注

推送逻辑一般是1分钟一次，但是出现以下情况时不会计算资金费率：

【通用】订阅合约信息变动(免鉴权)（sub）

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "40sG903yz80oDFWr",

"topic": "public.$contract_code.contract_info"

}

正确的订阅请求:


{
  "op": "sub",
  "topic": "public.btc-usdt.contract_info",
  "cid": "40sG903yz80oDFWr"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，必填 (public.$contract_code.contract_info) 订阅某个品种下的合约变动信息；详细参数见sub请求参数说明 ;
business_type false string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码,支持大小写 全部：* (请看备注中的说明) ，永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...

备注

返回的参数为：

{
    "op":"notify",
    "topic":"public.*.contract_info",
    "ts":1639122053894,
    "event":"init",
    "data":[
        {
            "symbol":"MANA",
            "contract_code":"MANA-USDT",
            "contract_size":10,
            "price_tick":0.0001,
            "settlement_date":"1639123200000",
            "create_date":"20210129",
            "contract_status":1,
            "support_margin_mode":"all",
            "delivery_time":"",
            "contract_type":"swap",
            "business_type":"swap",
            "pair":"MANA-USDT",
            "delivery_date":""
        },
        {
            "symbol":"NKN",
            "contract_code":"NKN-USDT",
            "contract_size":10,
            "price_tick":0.00001,
            "settlement_date":"1639123200000",
            "create_date":"20210810",
            "contract_status":1,
            "support_margin_mode":"all",
            "delivery_time":"",
            "contract_type":"swap",
            "business_type":"swap",
            "pair":"NKN-USDT",
            "delivery_date":""
        }
    ]
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
op true string 操作名称，推送固定值为 notify
topic true string 推送的主题
ts true long 响应生成时间点，单位：毫秒
event true string 通知相关事件说明 订阅成功返回的初始合约信息（init），合约信息字段变化触发（update），系统定期推送触发（snapshot）
<data> true object array
symbol true string 品种代码 "BTC","ETH"...
contract_code true string 合约代码 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...
contract_size true decimal 合约面值，即1张合约对应多少标的币种（如BTC-USDT合约则面值单位就是BTC） 10, 100...
price_tick true decimal 合约价格最小变动精度 0.001, 0.01...
settlement_date true string 合约下次结算时间 时间戳，如"1490759594752"
delivery_time true string 交割时间（合约无需交割时，该字段值为空字符串），单位：毫秒
create_date true string 合约上市日期 如"20180706"
contract_status true int 合约状态 合约状态: 0:已下市、1:上市、2:待上市、3:停牌，4:待开盘、5:结算中、6:交割中、7:结算完成、8:交割完成
support_margin_mode true string 合约支持的保证金模式 cross：全仓模式；isolated：逐仓模式；all：全逐仓都支持
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
delivery_date true string 合约交割日期 如"20180720"
</data>

说明：

【通用】取消订阅合约信息变动(免鉴权)（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "public.$contract_code.contract_info",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "public.BTC-USDT.contract_info",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (public.$contract_code.contract_info) 取消订阅某个合约代码下的资产变更信息，详细参数nusub请求参数说明 ;
business_type string 业务类型，不填默认永续 。 futures：交割、swap：永续、all：全部

nusub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码,支持大小写 全部：* (请看备注中的说明) ，永续：“BTC-USDT”... , 交割：“BTC-USDT-210625”...

备注

订阅与取消订阅规则说明

订阅(sub) 业务类型 取消订阅(unsub) 业务类型 规则
public.*.contract_info all public.*.contract_info all 允许
public.*.contract_info swap public.*.contract_info all 允许
public.*.contract_info futures public.*.contract_info all 允许
public.*.contract_info swap public.*.contract_info futures 不允许
public.*.contract_info swap public.*.contract_info swap 允许
public.*.contract_info futures public.*.contract_info swap 不允许
public.*.contract_info futures public.*.contract_info futures 允许
public.$contract_code(swap).contract_info all public.*.contract_info all 允许
public.$contract_code(futures).contract_info all public.*.contract_info all 允许
public.$contract_code(swap).contract_info all public.*.contract_info futures 不允许
public.$contract_code(futures).contract_info all public.*.contract_info swap 不允许
public.$contract_code(futures).contract_info all public.*.contract_info futures 允许
public.$contract_code(swap).contract_info all public.*.contract_info swap 允许
public.$contract_code.contract_info swap public.*.contract_info swap 允许
public.$contract_code.contract_info futures public.*.contract_info futures 允许
public.$contract_code.contract_info swap public.*.contract_info futures 不允许
public.$contract_code.contract_info futures public.*.contract_info swap 不允许
public.$contract_code1.contract_info swap public.$contract_code1.contract_info swap 允许
public.$contract_code1.contract_info swap public.$contract_code1.contract_info futures 不允许
public.$contract_code1.contract_info swap public.$contract_code1.contract_info all 允许
public.$contract_code1.contract_info futures public.$contract_code1.contract_info futures 允许
public.$contract_code1.contract_info futures public.$contract_code1.contract_info swap 不允许
public.$contract_code1.contract_info futures public.$contract_code1.contract_info all 允许
public.$contract_code1.contract_info swap public.$contract_code2.contract_info swap 不允许
public.$contract_code1.contract_info swap public.$contract_code2.contract_info futures 不允许
public.$contract_code1.contract_info swap public.$contract_code2.contract_info all 不允许
public.$contract_code1.contract_info futures public.$contract_code2.contract_info futures 不允许
public.$contract_code1.contract_info futures public.$contract_code2.contract_info swap 不允许
public.$contract_code1.contract_info futures public.$contract_code2.contract_info all 不允许
public.*.contract_info swap public.$contract_code1.contract_info swap 不允许
public.*.contract_info futures public.$contract_code1.contract_info futures 不允许
public.*.contract_info futures public.$contract_code1.contract_info swap 不允许
public.*.contract_info swap public.$contract_code1.contract_info futures 不允许
public.*.contract_info all public.$contract_code1.contract_info all 不允许
public.*.contract_info all public.$contract_code1.contract_info all 不允许
public.*.contract_info all public.$contract_code1.contract_info swap 不允许
public.*.contract_info all public.$contract_code1.contract_info futures 不允许

【逐仓】订阅计划委托订单更新(sub)

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "id generated by client",

"topic": "trigger_order.$contract_code"

}

正确的订阅请求:


{
  "op": "sub",
  "topic": "trigger_order.BTC-USDT",
  "cid": "40sG903yz80oDFWr"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，必填 (trigger_order.$contract_code) 订阅某个品种下的合约计划委托订单更新信息；$contract_code为品种代码（BTC-USDT、ETH-USDT），如果值为 * 时代表订阅所有品种; contract_code支持大小写;

返回示例:


{
    "op":"notify",
    "topic":"trigger_order.btc-usdt",
    "ts":1603778055069,
    "event":"order",
    "uid":"123456789",
    "data":[
        {
            "symbol":"BTC-USDT",
            "contract_code":"BTC-USDT",
            "trigger_type":"ge",
            "volume":1,
            "order_type":1,
            "direction":"sell",
            "offset":"open",
            "lever_rate":10,
            "order_id":5,
            "order_id_str":"5",
            "relation_order_id":"-1",
            "order_price_type":"limit",
            "status":2,
            "order_source":"web",
            "trigger_price":15000,
            "triggered_price":null,
            "order_price":15000,
            "created_at":1603778055064,
            "triggered_at":0,
            "order_insert_at":0,
            "canceled_at":0,
            "margin_mode": "isolated",
            "margin_account": "BTC-USDT",
            "fail_code":null,
            "fail_reason":null,
            "reduce_only": 0
        }
    ]
}

返回参数说明：

参数名称 是否必须 数据类型 描述 取值范围
op true string 操作名称，推送固定值为 notify
topic true string 推送的主题，与订阅的入参一样
ts true long 响应生成时间点，单位：毫秒
uid true string 用户uid
event true string 通知相关事件说明 计划委托订单下单成功（order），计划委托撤单成功（cancel），计划委托触发成功（trigger_success），计划委托触发失败（trigger_fail）
<data> true object array
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单
direction true string 买卖方向 买："buy",卖："sell"
offset true string 开平方向 开："open",平："close" ,"both"：单向持仓
lever_rate true int 杠杆倍数
order_id true decimal 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
order_price_type true string 订单报价类型 "limit":限价，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档
status true int 订单状态 2:已提交、4:报单成功、5:报单失败、6:已撤单
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
triggered_price true decimal 被触发时的价格
order_price true decimal 委托价
created_at true long 订单创建时间
triggered_at true long 触发时间
order_insert_at true long 下order单时间
canceled_at true long 撤单时间
margin_account true string 保证金账户 比如“BTC-USDT”
margin_mode true string 保证金模式 isolated：逐仓模式
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因（英文）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

说明：

【逐仓】取消订阅计划委托订单更新（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "trigger_order.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "trigger_order.BTC-USDT",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 必填;必填；必填；订阅主题名称，必填 (trigger_order.$contract_code) 订阅、取消订阅某个合约代码下的计划委托订单更新信息，当 $contract_code值为 * 时代表订阅所有合约代码;

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
trigger_order.* trigger_order.* 允许
trigger_order.contract_code1 trigger_order.* 允许
trigger_order.contract_code1 trigger_order.contract_code1 允许
trigger_order.contract_code1 trigger_order.contract_code2 不允许
trigger_order.* trigger_order.contract_code1 不允许

【全仓】订阅计划委托订单更新(sub)

备注

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来订阅数据:

{

"op": "sub",

"cid": "id generated by client",

"topic": "trigger_order_cross.$contract_code"

}

正确的订阅请求:


{
  "op": "sub",
  "topic": "trigger_order_cross.BTC-USDT",
  "cid": "40sG903yz80oDFWr"
}

请求参数

参数名称 是否必须 类型 描述 取值范围
op true string 订阅固定值为sub
cid false string Client 请求唯一 ID
topic true string 订阅主题名称，必填 (trigger_order_cross.$contract_code) 订阅某个品种下的合约计划委托订单更新信息；详情请查看sub请求参数说明

sub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

返回示例:


{
    "op":"notify",
    "topic":"trigger_order_cross.*",
    "ts":1639123353369,
    "event":"order",
    "uid":"123456789",
    "data":[
        {
            "contract_type":"swap",
            "pair":"BTC-USDT",
            "business_type":"swap",
            "symbol":"BTC",
            "contract_code":"BTC-USDT",
            "trigger_type":"le",
            "volume":1,
            "order_type":1,
            "direction":"buy",
            "offset":"open",
            "lever_rate":1,
            "order_id":918895474461802496,
            "order_id_str":"918895474461802496",
            "relation_order_id":"-1",
            "order_price_type":"limit",
            "status":2,
            "order_source":"api",
            "trigger_price":40000,
            "triggered_price":null,
            "order_price":40000,
            "created_at":1639123353364,
            "triggered_at":0,
            "order_insert_at":0,
            "canceled_at":0,
            "fail_code":null,
            "fail_reason":null,
            "margin_mode":"cross",
            "margin_account":"USDT",
            "reduce_only": 0
        }
    ]
}

返回参数说明：

参数名称 是否必须 数据类型 描述 取值范围
op true string 操作名称，推送固定值为 notify
topic true string 推送的主题，与订阅的入参一样
ts true long 响应生成时间点，单位：毫秒
uid true string 用户uid
event true string 通知相关事件说明 计划委托订单下单成功（order），计划委托撤单成功（cancel），计划委托触发成功（trigger_success），计划委托触发失败（trigger_fail）
<data> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
trigger_type true string 触发类型 ge大于等于；le小于等于
volume true decimal 委托数量
order_type true int 订单类型 1、报单
direction true string 买卖方向 买："buy",卖："sell"
offset true string 开平方向 开："open",平："close", "both":单向持仓
lever_rate true int 杠杆倍数
order_id true decimal 计划委托单订单ID
order_id_str true string 字符串类型的订单ID
relation_order_id true string 该字段为关联限价单的关联字段，未触发前数值为-1
order_price_type true string 订单报价类型 "limit":限价，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档
status true int 订单状态 2:已提交、4:报单成功、5:报单失败、6:已撤单、7:错单
order_source true string 来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发）
trigger_price true decimal 触发价
triggered_price true decimal 被触发时的价格
order_price true decimal 委托价
created_at true long 订单创建时间
triggered_at true long 触发时间
order_insert_at true long 下order单时间
canceled_at true long 撤单时间
fail_code true int 被触发时下order单失败错误码
fail_reason true string 被触发时下order单失败原因（英文）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</data>

说明：

【全仓】取消订阅计划委托订单更新（unsub）

备注

成功建⽴和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来取消订阅数据:

取消订阅请求数据格式

{

"op": "unsub",

"topic": "trigger_order_cross.$contract_code",

"cid": "id generated by client",

}

正确的取消订阅请求:


{                                    
  "op": "unsub",                     
  "topic": "trigger_order_cross.BTC-USDT",   
  "cid": "40sG903yz80oDFWr"          
}

取消订阅请求数据格式说明

字段名称 类型 说明
op string 必填;操作名称，订阅固定值为 unsub;
cid string 选填;Client 请求唯一 ID
topic string 订阅主题名称，必填 (trigger_order_cross.$contract_code) ，取消订阅某个合约代码下的计划委托订单更新信息，详情请查看unsub请求参数说明

unsub请求参数说明

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码，支持大小写 全部：*（交割和永续）， 永续:“BTC-USDT：... ，交割："BTC-USDT-210625"...

订阅与取消订阅规则说明

订阅(sub) 取消订阅(unsub) 规则
trigger_order_cross.* trigger_order_cross.* 允许
trigger_order_cross.contract_code1 trigger_order_cross.* 允许
trigger_order_cross.contract_code1 trigger_order_cross.contract_code1 允许
trigger_order_cross.contract_code1 trigger_order_cross.contract_code2 不允许
trigger_order_cross.* trigger_order_cross.contract_code1 不允许

WebSocket系统状态更新接口

【通用】订阅系统状态更新

成功建立和 WebSocket API 的连接之后，向 Server 发送如下格式的数据来请求数据：

{

"op": "sub",

"cid": "id generated by client",

"topic ": "public.$service.heartbeat"

}

数据请求参数的例子：


{
    "op": "sub",
    "cid": "id generated by client",
    "topic ": "public.linear-swap.heartbeat"
}

请求参数:

参数名称 是否必须 类型 描述 取值范围
op true string 必填;订阅固定值为sub
cid false string 选填;Client 请求唯一 ID
topic true string 必填;订阅主题名称:public.$service.heartbeat; 订阅U本位合约的系统状态信息

sub订阅参数说明:

参数名称 是否必须 类型 描述 取值范围
service true string 业务代码 linear-swap：U本位合约

返回示例:


{
    "op": "notify",
    "topic": "public.linear-swap.heartbeat",
    "event": "init",
    "ts":1580815422403,
    "data":{
        "heartbeat": 0,
        "estimated_recovery_time": 1408076414000
    }
}

返回参数说明：

参数名称 是否必须 数据类型 描述 取值范围
op true string 操作名称，推送固定值为 notify;
topic true string 推送的主题
event true string 通知相关事件说明 订阅成功返回的初始系统状态信息（init），系统状态变化触发（update）
ts true long 服务端应答时间戳
<data>
heartbeat true int 系统状态 1是可用，0为不可用(即停服维护)
estimated_recovery_time true long 系统预估恢复时间，单位：毫秒 当系统状态为可用时，返回空值
</data>

备注

WebSocket附录

操作类型（OP）说明

类型 描述
ping ⼼跳发起(server)
pong 心跳应答
auth 鉴权
sub 订阅消息
unsub 取消订阅消息
notify 推送订阅消息(server)

主题（topic）类型说明

类型 使用操作类型 描述
orders.$contract_code sub,unsub 订阅、取消订阅指定交易易对的订单变更更消息，当 contract_code 值为 * 时代表订阅所有交易易对

响应码（Err-Code）说明

返回码 返回描述
0 Request successfully.
2001 Invalid authentication.
2002 Authentication required.
2003 Authentication failed.
2004 Number of visits exceeds limit.
2005 Connection has been authenticated.
2007 You don’t have access permission as you have not opened contracts trading.
2010 Topic error.
2011 Contract doesn't exist.
2012 Topic not subscribed.
2013 Authentication type doesn't exist.
2014 Repeated subscription.
2020 This contract does not support cross margin mode.
2021 Illegal parameter margin_account.
2030 Exceeds connection limit of single user.
2040 Missing required parameter.

待下线接口

【通用】批量获取聚合行情

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type false（请看备注） string 业务类型，不填默认永续 futures：交割、swap：永续、all：全部

Response:

{
    "status": "ok",
    "ticks": [
        {
            "id": 1622102803,
            "ts": 1622102804786,
            "ask": [
                18000,
                11
            ],
            "bid": [
                1167.89012345,
                12
            ],
            "business_type": "futures",
            "contract_code": "BTC-USDT-CQ",
            "open": "18000",
            "close": "18000",
            "low": "18000",
            "high": "18000",
            "amount": "0.004",
            "count": 2,
            "vol": "4",
            "trade_turnover": "38.3488642"
        }
    ],
    "ts": 1622102804786
}

返回参数

参数名称 是否必须 数据类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
<ticks> true object array
contract_code true string 合约代码 或 合约标识 永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type true string 业务类型 futures：交割、swap：永续
id true long K线id
amount true string 成交量(币) （最近24（当前时间-24小时）小时成交量币）。 值是买卖双边之和
ask true array [卖1价,卖1量(张)]
bid true array [买1价,买1量(张)]
open true string 开盘价
close true string 收盘价,当K线为最晚的一根时，是最新成交价
count true decimal 成交笔数（当前时间-24小时）小时成交笔数）。 值是买卖双边之和
high true string 最高价
low true string 最低价
vol true string 成交量（张）（最近24（当前时间-24小时）小时成交量张）。 值是买卖双边之和
trade_turnover true string 成交额 （当前时间-24小时）小时成交额）。 值是买卖双边之和
ts true long 时间戳
</ticks>
ts true long 响应生成时间点，单位：毫秒

【通用】查询用户财务记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 "BTC-USDT","USDT"(查询全仓时使用)...
contract_code false string 合约代码，不填查询所有 永续："BTC-USDT"...，交割：“BTC-USDT-210625”
type false string 不填查询全部类型,【查询多类型中间用，隔开】 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入; 38:从其他保证金账户转入; 39:转出到其他保证金账户; 46:ADL平多; 47:ADL平空;
create_date false int 可随意输入正整数，如果参数超过90则默认查询90天的数据，默认7
page_index false int 第几页,不填默认第一页
page_size false int 不填默认20，不得多于50

备注：

Response:


{
    "status": "ok",
    "data": {
        "total_page": 1,
        "current_page": 1,
        "total_size": 2,
        "financial_record": [
            {
                "id": 117840,
                "type": 5,
                "amount": -0.024464850000000000,
                "ts": 1638758435635,
                "contract_code": "BTC-USDT-211210",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            },
            {
                "id": 10328,
                "type": 29,
                "amount": 10000.000000000000000000,
                "ts": 1638517931516,
                "contract_code": "",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            }
        ]
    },
    "ts": 1638759621932
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典类型
<financial_record> true object array
id true long 财务记录ID（品种唯一）
ts true long 创建时间
asset true string 币种 "USDT"...
contract_code true string 合约代码 永续："BTC-USDT"... ，交割：“BTC-USDT-210625”...
margin_account true string 保证金账户 "BTC-USDT","USDT"...
face_margin_account true string 对手方保证金账户，仅在type交易类型为34、35、36、37、38、39时有值，其他类型为空字符串 "BTC-USDT"...
type true int 交易类型 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入; 38:从其他保证金账户转入; 39:转出到其他保证金账户; 46:ADL平多; 47:ADL平空;
amount true decimal 金额（计价货币）
</financial_record>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>

【通用】组合查询用户财务记录

备注：

请求参数

参数名称 是否必须 类型 描述 取值范围
margin_account true string 保证金账户 "BTC-USDT","USDT"(查询全仓时使用)...
contract_code false string 合约代码 永续："BTC-USDT"... ，交割：“BTC-USDT-210625”...
type false string 不填查询全部类型,【查询多类型中间用，隔开】 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;46:ADL平多; 47:ADL平空;
start_time false long 起始时间（时间戳，单位毫秒） 详见备注
end_time false long 结束时间（时间戳，单位毫秒） 详见备注
from_id false long 查询起始id（取返回数据的id ）
size false int 数据条数 默认取20，最大50
direct false string 查询方向 prev 向前；next 向后；默认值取prev

备注：

查询案例如下（特殊错误情况未罗列）：

start_time end_time from_id size direct 查询结果
缺省，取10天前 缺省，取当前时间 缺省 20条 prev 查询最近10天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 prev 查询60天前到50天前之间的数据，从50天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 prev 查询最近5天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 prev 查询20天前到10天前之间的数据，从10天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 缺省 20条 next 查询最近10天的数据，从10天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 next 查询60天前到50天前之间的数据，从60天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 next 查询最近5天的数据，从5天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 next 查询20天前到10天前之间的数据，从20天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 1000 20条 prev 查询最近10天的数据，从id为1000的数据开始往前查20条更旧的数据，id为1000的数据排在第一条，越新的数据排在越前
20天前 10天前 1000 20条 next 查询20天前到10天前之间的数据，从id为1000的数据开始往后查20条更新的数据，id为1000的数据排在最后一条，越新的数据排在越前

Response:


{
    "status": "ok",
    "data": {
        "financial_record": [
            {
                "id": 117840,
                "type": 5,
                "amount": -0.024464850000000000,
                "ts": 1638758435635,
                "contract_code": "BTC-USDT-211210",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            },
            {
                "id": 10328,
                "type": 29,
                "amount": 10000.000000000000000000,
                "ts": 1638517931516,
                "contract_code": "USDT-USD",
                "asset": "USDT",
                "margin_account": "USDT",
                "face_margin_account": ""
            }
        ],
        "remain_size": 0,
        "next_id": null
    },
    "ts": 1638759705140
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object 字典类型
<financial_record> true object array
id true long
ts true long 创建时间
asset true string 币种 "USDT"...
contract_code true string 合约代码 "BTC-USDT"...
margin_account true string 保证金账户 "BTC-USDT","USDT"...
face_margin_account true string 对手方保证金账户，仅在type交易类型为34、35、36、37、38、39时有值，其他类型为空字符串 "BTC-USDT"...
type true int 交易类型 3:平多; 4:平空; 5:开仓手续费-吃单; 6:开仓手续费-挂单; 7:平仓手续费-吃单; 8:平仓手续费-挂单; 9:交割平多; 10:交割平空; 11:交割手续费; 12:强制平多; 13:强制平空; 14:从币币转入; 15:转出至币币; 16:结算未实现盈亏-多仓; 17:结算未实现盈亏-空仓; 19:穿仓分摊; 26:系统; 28:活动奖励; 29:返利; 30:资金费-收入; 31:资金费-支出; 34:转出到子账号合约账户; 35:从子账号合约账户转入; 36:转出到母账号合约账户; 37:从母账号合约账户转入;38:从其他保证金账户转入 ;39:转出到其他保证金账户 ;46:ADL平多; 47:ADL平空;
amount true decimal 金额（计价货币）
</financial_record>
remain_size true int 剩余数据条数（在时间范围内，因受到数据条数限制而未查询到的数据条数）
next_id true long 下一条数据的id（仅在查询结果超过数据条数限制时才有值）
</data>

备注：

【全仓】获取历史成交记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页
page_size false int 不填默认20，不得多于50 [1-50]

Response


{
    "status": "ok",
    "data": {
        "trades": [
            {
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "match_id": 2902136,
                "order_id": 918800256249405440,
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "direction": "buy",
                "offset": "open",
                "trade_volume": 100.000000000000000000,
                "trade_price": 48555.600000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "offset_profitloss": 0E-18,
                "create_date": 1639100651577,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "918800256249405440",
                "id": "2902136-918800256249405440-1",
                "fee_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "real_profit": 0E-18,
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 5
    },
    "ts": 1639102170045
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<trades> true object array
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
id true string 全局唯一的交易标识
match_id true long 撮合结果id, 与订单ws推送orders_cross.$contract_code推送结果中的trade_id是相同的，非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格）
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</trades>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【全仓】组合查询用户历史成交记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
pair false(请看备注) string 交易对 “BTC-USDT”...
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 起始时间（时间戳，单位毫秒） 详见备注
end_time false long 结束时间（时间戳，单位毫秒） 详见备注
from_id false long 查询起始id（取返回数据的query_id字段）
size false int 数据条数 默认取20，最大50
direct false string 查询方向 prev 向前；next 向后；默认值取prev

备注：

查询案例如下（特殊错误情况未罗列）：

start_time end_time from_id size direct 查询结果
缺省，取10天前 缺省，取当前时间 缺省 20条 prev 查询最近10天的数据，从当前时间开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 prev 查询60天前到50天前之间的数据，从50天前开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 prev 查询最近5天的数据，从当前时间开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 prev 查询20天前到10天前之间的数据，从10天前开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 缺省 20条 next 查询最近10天的数据，从10天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 next 查询60天前到50天前之间的数据，从60天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 next 查询最近5天的数据，从5天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 next 查询20天前到10天前之间的数据，从20天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 1000 20条 prev 查询最近10天的数据，从query_id为1000的数据开始往前查20条更旧的数据，成交id为1000的数据排在第一条，越新的数据排在越前
20天前 10天前 1000 20条 next 查询20天前到10天前之间的数据，从query_id为1000的数据开始往后查20条更新的数据，成交id为1000的数据排在最后一条，越新的数据排在越前

Response: 

{
    "status": "ok",
    "data": {
        "trades": [
            {
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "query_id": 136966,
                "match_id": 2902136,
                "order_id": 918800256249405440,
                "symbol": "BTC",
                "contract_code": "BTC-USDT-211210",
                "direction": "buy",
                "offset": "open",
                "trade_volume": 100.000000000000000000,
                "trade_price": 48555.600000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "trade_fee": -2.427780000000000000,
                "offset_profitloss": 0E-18,
                "create_date": 1639100651577,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "918800256249405440",
                "id": "2902136-918800256249405440-1",
                "fee_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "real_profit": 0E-18,
                "reduce_only": 0
            }
        ],
        "remain_size": 0,
        "next_id": null
    },
    "ts": 1639102308193
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<trades> true object array
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</trades>
remain_size true int 剩余数据条数（在时间范围内，因受到数据条数限制而未查询到的数据条数）
next_id true long 下一条数据的query_id（仅在查询结果超过数据条数限制时才有值）
</data>
ts true long 时间戳

备注：

【逐仓】组合查询用户历史成交记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
start_time false long 起始时间（时间戳，单位毫秒） 详见备注
end_time false long 结束时间（时间戳，单位毫秒） 详见备注
from_id false long 查询起始id（取返回数据的query_id字段）
size false int 数据条数 默认取20，最大50
direct false string 查询方向 prev 向前；next 向后；默认值取prev

备注：

查询案例如下（特殊错误情况未罗列）：

start_time end_time from_id size direct 查询结果
缺省，取10天前 缺省，取当前时间 缺省 20条 prev 查询最近10天的数据，从当前时间开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 prev 查询60天前到50天前之间的数据，从50天前开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 prev 查询最近5天的数据，从当前时间开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 prev 查询20天前到10天前之间的数据，从10天前开始往前查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 缺省 20条 next 查询最近10天的数据，从10天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 next 查询60天前到50天前之间的数据，从60天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 next 查询最近5天的数据，从5天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 next 查询20天前到10天前之间的数据，从20天前开始往后查20条数据，返回数据按成交时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 1000 20条 prev 查询最近10天的数据，从query_id为1000的数据开始往前查20条更旧的数据，成交id为1000的数据排在第一条，越新的数据排在越前
20天前 10天前 1000 20条 next 查询20天前到10天前之间的数据，从query_id为1000的数据开始往后查20条更新的数据，成交id为1000的数据排在最后一条，越新的数据排在越前

Response: 

{
    "status": "ok",
    "data": {
        "trades": [
            {
                "query_id": 138798248,
                "match_id": 13752484857,
                "order_id": 807038270541733888,
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "direction": "buy",
                "offset": "close",
                "trade_volume": 9,
                "trade_price": 36580,
                "trade_turnover": 329.22,
                "trade_fee": -0.131688,
                "offset_profitloss": 0.3636,
                "create_date": 1612454517757,
                "role": "Taker",
                "order_source": "android",
                "order_id_str": "807038270541733888",
                "id": "13752484857-807038270541733888-1",
                "fee_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "real_profit": 0.2394,
                "reduce_only": 0
            }
        ],
        "remain_size": 0,
        "next_id": null
    },
    "ts": 1612503560490
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<trades> true object array
id true string 唯一成交id,由于match_id并不是unique的，具体使用方式是用match_id和id作为联合主键，拼接成unique的成交ID。
query_id true long 查询id，可作为下一次查询请求的from_id字段
match_id true long 撮合结果id，不唯一，可能重复
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交总金额
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</trades>
remain_size true int 剩余数据条数（在时间范围内，因受到数据条数限制而未查询到的数据条数）
next_id true long 下一条数据的query_id（仅在查询结果超过数据条数限制时才有值）
</data>
ts true long 时间戳

备注：

【逐仓】获取历史成交记录

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT"...
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 17：买入（单向持仓）, 18：卖出（单向持仓）
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页
page_size false int 不填默认20，不得多于50

Response: 


{
    "status": "ok",
    "data": {
        "trades": [
            {
                "match_id": 131560927,
                "order_id": 770334322963152896,
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "direction": "sell",
                "offset": "open",
                "trade_volume": 1.000000000000000000,
                "trade_price": 13059.800000000000000000,
                "trade_turnover": 13.059800000000000000,
                "trade_fee": -0.005223920000000000,
                "offset_profitloss": 0,
                "create_date": 1603703614715,
                "role": "Taker",
                "order_source": "api",
                "order_id_str": "770334322963152896",
                "id": "131560927-770334322963152896-1",
                "fee_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "total_page": 2,
        "current_page": 1,
        "total_size": 2
    },
    "ts": 1603704407235
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<trades> true object array
id true string 全局唯一的交易标识
match_id true long 撮合结果id, 与订单ws推送orders.$contract_code推送结果中的trade_id是相同的，非唯一，可重复，注意：一个撮合结果代表一个taker单和N个maker单的成交记录的集合，如果一个taker单吃了N个maker单，那这N笔trade都是一样的撮合结果
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
contract_code true string 合约代码 "BTC-USDT" ...
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
trade_volume true decimal 成交数量
trade_price true decimal 成交价格
trade_turnover true decimal 成交金额（成交数量 * 合约面值 * 成交价格）
create_date true long 成交时间
offset_profitloss true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
trade_fee true decimal 成交手续费
role true string taker或maker
fee_asset true string 手续费币种 （"USDT"...）
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</trades>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【全仓】获取合约历史委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
pair false（请看备注） string 交易对 BTC-USDT
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 7:交割平多, 8:交割平空, 11:减仓平多, 12:减仓平空, 17：买入（单向持仓）, 18：卖出（单向持仓）
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
create_date true int 日期，可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页
page_size false int 每页条数，不填默认20 不得多于50
sort_by false string 排序字段（降序），不填默认按照create_date降序 "create_date"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

备注：

所有已撤销且无成交的API限价订单记录只保留最近2小时。

Response

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "order_id": 918800256249405440,
                "contract_code": "BTC-USDT-211210",
                "symbol": "BTC",
                "lever_rate": 5,
                "direction": "buy",
                "offset": "open",
                "volume": 100.000000000000000000,
                "price": 48555.600000000000000000,
                "create_date": 1639100651569,
                "order_source": "api",
                "order_price_type": 3,
                "order_type": 1,
                "margin_frozen": 0E-18,
                "profit": 0E-18,
                "trade_volume": 100.000000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "fee": -2.427780000000000000,
                "trade_avg_price": 48555.6000,
                "status": 6,
                "order_id_str": "918800256249405440",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "margin_asset": "USDT",
                "margin_mode": "cross",
                "margin_account": "USDT",
                "update_time": 1639100651000,
                "is_tpsl": 0,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 4
    },
    "ts": 1639101888331
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<orders> true object array
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 创建时间
update_time true long 订单更新时间，单位：毫秒
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true int 订单报价类型 1：限价单（limit），2：市价单（market），3：对手价（opponent），4：闪电平仓（lightning），5：计划委托（trigger），6：post_only ，7：最优5档（optimal_5） ，8：最优10档（optimal_10） ，9：最优20档（optimal_20），10：FOK ，11：IOC ，12：对手价_IOC（opponent_ioc），13：闪电平仓_IOC（lightning_ioc），14：最优5档_IOC（optimal_5_ioc），15：最优10档_IOC（optimal_10_ioc），16：最优20档_IOC（optimal_20_ioc），17：对手价_FOK（opponent_fok），18：闪电平仓_FOK（lightning_fok），19：最优5档_FOK（optimal_5_fok），40：最优10档_FOK（optimal_10_fok），41：最优20档_FOK（optimal_20_fok）。
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpls true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【全仓】组合查询合约历史委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false（请看备注） string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
pair false（请看备注） string 交易对 "BTC-USDT" ...
trade_type true int 交易类型 0:全部,1:买入开多,2: 卖出开空,3: 买入平空,4: 卖出平多,5: 卖出强平,6: 买入强平,7:交割平多,8: 交割平空, 11:减仓平多, 12:减仓平空, 17：买入（单向持仓）, 18：卖出（单向持仓）
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
order_price_type false string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
start_time false long 起始时间（时间戳，单位毫秒） 详见备注
end_time false long 结束时间（时间戳，单位毫秒） 详见备注
from_id false long 查询起始id（取返回数据的query_id字段）
size false int 数据条数 默认取20，最大50
direct false string 查询方向 prev 向前；next 向后；默认值取prev

备注：

查询案例如下（特殊错误情况未罗列）：

start_time end_time from_id size direct 查询结果
缺省，取10天前 缺省，取当前时间 缺省 20条 prev 查询最近10天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 prev 查询60天前到50天前之间的数据，从50天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 prev 查询最近5天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 prev 查询20天前到10天前之间的数据，从10天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 缺省 20条 next 查询最近10天的数据，从10天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 next 查询60天前到50天前之间的数据，从60天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 next 查询最近5天的数据，从5天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 next 查询20天前到10天前之间的数据，从20天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 1000 20条 prev 查询最近10天的数据，从query_id为1000的数据开始往前查20条更旧的数据，id为1000的数据排在第一条，越新的数据排在越前
20天前 10天前 1000 20条 next 查询20天前到10天前之间的数据，从query_id为1000的数据开始往后查20条更新的数据，id为1000的数据排在最后一条，越新的数据排在越前

Response:

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "query_id": 452057,
                "contract_type": "this_week",
                "pair": "BTC-USDT",
                "business_type": "futures",
                "order_id": 918800256249405440,
                "contract_code": "BTC-USDT-211210",
                "symbol": "BTC",
                "lever_rate": 5,
                "direction": "buy",
                "offset": "open",
                "volume": 100.000000000000000000,
                "price": 48555.600000000000000000,
                "create_date": 1639100651569,
                "order_source": "api",
                "order_price_type": "opponent",
                "order_type": 1,
                "margin_frozen": 0E-18,
                "profit": 0E-18,
                "trade_volume": 100.000000000000000000,
                "trade_turnover": 4855.560000000000000000,
                "fee": -2.427780000000000000,
                "trade_avg_price": 48555.6000,
                "status": 6,
                "order_id_str": "918800256249405440",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "is_tpsl": 0,
                "real_profit": 0,
                "margin_mode": "cross",
                "margin_account": "USDT",
                "reduce_only": 0
            }
        ],
        "remain_size": 0,
        "next_id": null
    },
    "ts": 1639102028275
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<orders> true object array
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT" ... ，交割："BTC-USDT-210625" ...
margin_mode true string 保证金模式 cross：全仓模式；
margin_account true string 保证金账户 比如“USDT”
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 创建时间
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
order_price_type true string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpsl true int 是否设置止盈止损 1：是；0：否
contract_type true string 合约类型 swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
remain_size true int 剩余数据条数（在时间范围内，因受到数据条数限制而未查询到的数据条数）
next_id true long 下一条数据的query_id（仅在查询结果超过数据条数限制时才有值）
</data>
ts true long 时间戳

备注：

【逐仓】组合查询合约历史委托

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code true string 合约代码 "BTC-USDT" ...
trade_type true int 交易类型 0:全部,1:买入开多,2: 卖出开空,3: 买入平空,4: 卖出平多,5: 卖出强平,6: 买入强平,7:交割平多,8: 交割平空, 11:减仓平多, 12:减仓平空, 17：买入（单向持仓）, 18：卖出（单向持仓）
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
order_price_type false string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
start_time false long 起始时间（时间戳，单位毫秒） 详见备注
end_time false long 结束时间（时间戳，单位毫秒） 详见备注
from_id false long 查询起始id（取返回数据的query_id字段）
size false int 数据条数 默认取20，最大50
direct false string 查询方向 prev 向前；next 向后；默认值取prev

备注：

查询案例如下（特殊错误情况未罗列）：

start_time end_time from_id size direct 查询结果
缺省，取10天前 缺省，取当前时间 缺省 20条 prev 查询最近10天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 prev 查询60天前到50天前之间的数据，从50天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 prev 查询最近5天的数据，从当前时间开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 prev 查询20天前到10天前之间的数据，从10天前开始往前查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 缺省 20条 next 查询最近10天的数据，从10天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取60天前 50天前 缺省 20条 next 查询60天前到50天前之间的数据，从60天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
5天前 缺省，取当前时间 缺省 20条 next 查询最近5天的数据，从5天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
20天前 10天前 缺省 20条 next 查询20天前到10天前之间的数据，从20天前开始往后查20条数据，返回数据按创建时间倒序，越新的数据排在越前
缺省，取10天前 缺省，取当前时间 1000 20条 prev 查询最近10天的数据，从query_id为1000的数据开始往前查20条更旧的数据，id为1000的数据排在第一条，越新的数据排在越前
20天前 10天前 1000 20条 next 查询20天前到10天前之间的数据，从query_id为1000的数据开始往后查20条更新的数据，id为1000的数据排在最后一条，越新的数据排在越前

Response:

{
    "status": "ok",
    "data": {
        "orders": [
            {
                "query_id": 13580806498,
                "order_id": 807038270541733888,
                "contract_code": "BTC-USDT",
                "symbol": "BTC",
                "lever_rate": 10,
                "direction": "buy",
                "offset": "close",
                "volume": 9,
                "price": 36580,
                "create_date": 1612454517740,
                "order_source": "android",
                "order_price_type": "opponent",
                "order_type": 1,
                "margin_frozen": 0,
                "profit": 0.3636,
                "trade_volume": 9,
                "trade_turnover": 329.22,
                "fee": -0.131688,
                "trade_avg_price": 36580,
                "status": 6,
                "order_id_str": "807038270541733888",
                "fee_asset": "BTC-USDT",
                "liquidation_type": "0",
                "is_tpsl": 0,
                "real_profit": 0.2394,
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "reduce_only": 0
            }
        ],
        "remain_size": 0,
        "next_id": null
    },
    "ts": 1612503332073
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<orders> true object array
query_id true long 查询id，可作为下一次查询请求的from_id字段
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 创建时间
order_source true string 订单来源 system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发
order_price_type true string 订单报价类型 订单报价类型 "limit":限价，"opponent":对手价 ，"post_only":只做maker单,post only下单只受用户持仓数量限制,"optimal_5"：最优5档，"optimal_10"：最优10档，"optimal_20"：最优20档，"ioc":IOC订单，"fok"：FOK订单, "opponent_ioc"： 对手价-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏
real_profit true decimal 真实收益
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态 1准备提交 2准备提交 3已提交 4部分成交 5部分成交已撤单 6全部成交 7已撤单 11撤单中
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
is_tpsl true int 是否设置止盈止损 1：是；0：否
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
remain_size true int 剩余数据条数（在时间范围内，因受到数据条数限制而未查询到的数据条数）
next_id true long 下一条数据的query_id（仅在查询结果超过数据条数限制时才有值）
</data>
ts true long 时间戳

备注：

【逐仓】获取合约历史委托

备注

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
contract_code true string 合约代码 支持大小写,"BTC-USDT" ...
trade_type true int 交易类型 0:全部, 1:买入开多, 2:卖出开空, 3:买入平空, 4:卖出平多, 5:卖出强平, 6:买入强平, 7:交割平多, 8:交割平空, 11:减仓平多, 12:减仓平空, 17：买入（单向持仓）, 18：卖出（单向持仓）
type true int 类型 1:所有订单,2:结束状态的订单
status true string 订单状态 可查询多个状态，"3,4,5" , 0:全部,3:未成交, 4: 部分成交,5: 部分成交已撤单,6: 全部成交,7:已撤单
create_date true int 日期 可随意输入正整数，如果参数超过90则默认查询90天的数据
page_index false int 页码，不填默认第1页 1
page_size false int 每页条数，不填默认20 20 不得多于50
sort_by false string 排序字段（降序），不填默认按照create_date降序 create_date "create_date"：按订单创建时间进行降序，"update_time"：按订单更新时间进行降序

备注：

Response:


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "order_id": 770336866451992576,
                "contract_code": "BTC-USDT",
                "symbol": "BTC",
                "lever_rate": 10,
                "direction": "sell",
                "offset": "close",
                "volume": 1.000000000000000000,
                "price": 13100.000000000000000000,
                "create_date": 1603704221118,
                "update_time": 1603704221118,
                "order_source": "web",
                "order_price_type": 6,
                "order_type": 1,
                "margin_frozen": 0,
                "profit": 0,
                "trade_volume": 0,
                "trade_turnover": 0,
                "fee": 0,
                "trade_avg_price": 0,
                "status": 3,
                "order_id_str": "770336866451992576",
                "fee_asset": "USDT",
                "liquidation_type": "0",
                "margin_asset": "USDT",
                "margin_mode": "isolated",
                "margin_account": "BTC-USDT",
                "is_tpsl": 0,
                "real_profit": 0,
                "reduce_only": 0
            }
        ],
        "total_page": 10,
        "current_page": 1,
        "total_size": 10
    },
    "ts": 1603704312847
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果
<data> true object
<orders> true object array
order_id true long 订单ID
order_id_str true string string格式的订单ID
symbol true string 品种代码
contract_code true string 合约代码 "BTC-USDT" ...
lever_rate true int 杠杆倍数
direction true string 买卖方向 "buy":买 "sell":卖
offset true string 开平方向 "open":开 "close":平 "both":单向持仓
volume true decimal 委托数量
price true decimal 委托价格
create_date true long 创建时间
update_time true long 订单更新时间，单位：毫秒
order_source true string 订单来源 （system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发）
order_price_type true int 订单报价类型 1：限价单（limit），2：市价单（market），3：对手价（opponent），4：闪电平仓（lightning），5：计划委托（trigger），6：post_only ，7：最优5档（optimal_5） ，8：最优10档（optimal_10） ，9：最优20档（optimal_20），10：FOK ，11：IOC ，12：对手价_IOC（opponent_ioc），13：闪电平仓_IOC（lightning_ioc），14：最优5档_IOC（optimal_5_ioc），15：最优10档_IOC（optimal_10_ioc），16：最优20档_IOC（optimal_20_ioc），17：对手价_FOK（opponent_fok），18：闪电平仓_FOK（lightning_fok），19：最优5档_FOK（optimal_5_fok），40：最优10档_FOK（optimal_10_fok），41：最优20档_FOK（optimal_20_fok）。
margin_asset true string 保证金币种（计价币种）
margin_frozen true decimal 冻结保证金
profit true decimal 平仓盈亏（使用持仓均价计算，不包含仓位跨结算的已实现盈亏。）
trade_volume true decimal 成交数量
trade_turnover true decimal 成交总金额，即sum（每一笔成交张数 * 合约面值 * 成交价格）
fee true decimal 手续费
trade_avg_price true decimal 成交均价
status true int 订单状态
order_type true int 订单类型 1:报单 、 2:撤单 、 3:强平、4:交割
fee_asset true string 手续费币种 （"USDT"...）
liquidation_type true string 强平类型 0:非强平类型，1：多空轧差， 2:部分接管，3：全部接管
margin_mode true string 保证金模式 isolated：逐仓模式
margin_account true string 保证金账户 比如“BTC-USDT”
is_tpsl true int 是否设置止盈止损 1：是；0：否
real_profit true decimal 真实收益（使用开仓均价计算，包含仓位跨结算的已实现盈亏。）
reduce_only true int 是否为只减仓订单 0:表示为非只减仓订单，1:表示为只减仓订单
</orders>
current_page true int 当前页
total_page true int 总页数
total_size true int 总条数
</data>
ts true long 时间戳

备注：

【通用】获取强平订单


curl "https://api.hbdm.com/linear-swap-api/v1/swap_liquidation_orders?contract_code=BTC-USDT&trade_type=0&create_date=90"

备注

请求参数

参数名称 是否必须 类型 描述 取值范围
contract_code false(请看备注) string 合约代码 永续："BTC-USDT"... , 交割："BTC-USDT-210625" ...
pair false(请看备注) string 交易对 "BTC-USDT" ...
trade_type true int 交易类型 0:全部,5: 卖出强平,6: 买入强平
create_date true int 日期 7，90（7天或者90天）
page_index false int 页码,不填默认第1页
page_size false int 不填默认20，不得多于50

Response:


{
    "status": "ok",
    "data": {
        "orders": [
            {
                "contract_code": "BTC-USDT-211210",
                "symbol": "USDT",
                "direction": "sell",
                "offset": "close",
                "volume": 479.000000000000000000,
                "price": 51441.700000000000000000,
                "created_at": 1638593647864,
                "amount": 0.479000000000000000,
                "trade_turnover": 24640.574300000000000000,
                "business_type": "futures",
                "pair": "BTC-USDT"
            },
            {
                "contract_code": "BTC-USDT-211231",
                "symbol": "USDT",
                "direction": "sell",
                "offset": "close",
                "volume": 3999.000000000000000000,
                "price": 53457.900000000000000000,
                "created_at": 1638564308927,
                "amount": 3.999000000000000000,
                "trade_turnover": 213778.142100000000000000,
                "business_type": "futures",
                "pair": "BTC-USDT"
            }
        ],
        "total_page": 1,
        "current_page": 1,
        "total_size": 8
    },
    "ts": 1638756566302
}

返回参数

参数名称 是否必须 类型 描述 取值范围
status true string 请求处理结果 "ok" , "error"
ts true long 响应生成时间点，单位：毫秒
<data> true object
<orders> true object array
symbol true string 品种代码
contract_code true string 合约代码 永续："BTC-USDT", 交割："BTC-USDT-210625" ...
created_at true long 强平时间
direction true string "buy":买 "sell":卖
offset true string "open":开 "close":平 "both":单向持仓
price true decimal 破产价格
volume true decimal 强平数量（张）
amount true decimal 强平数量（币）
trade_turnover true decimal 强平金额（计价币种）
pair true string 交易对 如：“BTC-USDT”
business_type true string 业务类型 futures：交割、swap：永续
</orders>
total_page true int 总页数
current_page true int 当前页
total_size true int 总条数
</data>





shell