API接入：https://support.hbfile.net/hc/zh-cn/articles/900001603466

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

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

• 接口名称：【通用】批量获取聚合行情
• 接口类型：公共接口
• 接口URL：/linear-swap-ex/market/detail/batch_merged

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

• 接口名称：【通用】获取标记价格的 K 线数据
• 接口类型：公共接口
• 接口URL：/index/market/history/linear_swap_mark_price_kline

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

• 接口名称：【通用】订阅标记价格 K 线数据
• 接口类型：公共接口
• 订阅地址：market.$contract_code.mark_price.$period

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

• 接口名称：【通用】请求标记价格 K 线数据
• 接口类型：公共接口
• 订阅地址：market.$contract_code.mark_price.$period

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

• 接口名称：【逐仓】查询用户结算记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_user_settlement_records

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

• 接口名称：【全仓】查询用户结算记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_user_settlement_records

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

• 接口名称：【逐仓】全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cancelall

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

• 接口名称：【全仓】全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_cancelall

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

• 接口名称：【逐仓】获取合约订单信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_order_info

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

• 接口名称：【全仓】获取合约订单信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_order_info

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

• 接口名称：【逐仓】获取订单明细信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_order_detail

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

• 接口名称：【全仓】获取订单明细信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_order_detail

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

• 接口名称：【逐仓】获取合约当前未成交委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_openorders

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

• 接口名称：【全仓】获取合约当前未成交委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_openorders

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

• 接口名称：【逐仓】获取合约历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_hisorders

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

• 接口名称：【全仓】获取合约历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_hisorders

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

• 接口名称：【逐仓】获取历史成交记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_matchresults

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

• 接口名称：【全仓】获取历史成交记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_matchresults

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

• 接口名称：【逐仓】订阅订单成交数据
• 接口类型：私有接口
• 订阅地址：orders.$contract_code

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

• 接口名称：【全仓】订阅订单成交数据
• 接口类型：私有接口
• 订阅地址：orders_cross.$contract_code

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

• 接口名称：【逐仓】计划委托全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_trigger_cancelall

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

• 接口名称：【全仓】计划委托全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_cancelall

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

• 接口名称：【逐仓】止盈止损订单全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_tpsl_cancelall

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

• 接口名称：【全仓】止盈止损订单全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_tpsl_cancelall

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

• 接口名称：【逐仓】查询计划委托当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_trigger_openorders

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

• 接口名称：【全仓】查询计划委托当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_openorders

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

• 接口名称：【逐仓】查询止盈止损订单当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_tpsl_openorders

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

• 接口名称：【全仓】查询止盈止损订单当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_tpsl_openorders

 

 

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

1、新增获取预估结算价

• 接口名称: 【通用】获取预估结算价
• 接口类型: 公共接口
• 接口URL: /linear-swap-api/v1/swap_estimated_settlement_price

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

• 接口名称: 【逐仓】对仓位设置止盈止损订单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_tpsl_order

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

• 接口名称: 【全仓】对仓位设置止盈止损订单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_tpsl_order

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

• 接口名称: 【逐仓】止盈止损订单撤单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_tpsl_cancel

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

• 接口名称: 【全仓】止盈止损订单撤单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_tpsl_cancel

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

• 接口名称: 【逐仓】止盈止损订单全部撤单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_tpsl_cancelall

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

• 接口名称: 【全仓】止盈止损订单全部撤单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_tpsl_cancelall

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

• 接口名称: 【逐仓】查询止盈止损订单当前委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_tpsl_openorders

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

• 接口名称: 【全仓】查询止盈止损订单当前委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_tpsl_openorders

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

• 接口名称: 【逐仓】查询止盈止损订单历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_tpsl_hisorders

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

• 接口名称: 【全仓】查询止盈止损订单历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_tpsl_hisorders

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

• 接口名称: 【逐仓】查询开仓单关联的止盈止损订单详情
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_relation_tpsl_order

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

• 接口名称: 【全仓】查询开仓单关联的止盈止损订单详情
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_relation_tpsl_order

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

• 接口名称: 【逐仓】合约下单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_order

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

• 接口名称: 【全仓】合约下单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_order

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

• 接口名称: 【逐仓】合约批量下单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_batchorder

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

• 接口名称: 【全仓】合约批量下单
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_batchorder

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

• 接口名称: 【逐仓】获取合约订单信息
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_order_info

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

• 接口名称: 【全仓】获取合约订单信息
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_order_info

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

• 接口名称: 【逐仓】获取订单明细信息
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_order_detail

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

• 接口名称: 【全仓】获取订单明细信息
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_order_detail

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

• 接口名称: 【逐仓】获取合约当前未成交委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_openorders

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

• 接口名称: 【全仓】获取合约当前未成交委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_openorders

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

• 接口名称: 【逐仓】获取合约历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_hisorders

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

• 接口名称: 【全仓】获取合约历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_hisorders

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

• 接口名称: 【逐仓】订阅订单成交数据
• 接口类型: 私有接口
• 订阅主题: orders.$contract_code

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

• 接口名称: 【全仓】订阅订单成交数据
• 接口类型: 私有接口
• 订阅主题: orders_cross.$contract_code

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

• 接口名称: 【逐仓】订阅订单撮合数据
• 接口类型: 私有接口
• 订阅主题: matchOrders.$contract_code

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

• 接口名称: 【全仓】订阅订单撮合数据
• 接口类型: 私有接口
• 订阅主题: matchOrders_cross.$contract_code

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

• 接口名称: 【逐仓】获取计划委托历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_trigger_hisorders

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

• 接口名称: 【全仓】获取计划委托历史委托
• 接口类型: 私有接口
• 接口URL: /linear-swap-api/v1/swap_cross_trigger_hisorders

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

• 接口名称: 【通用】获取当前可用合约总持仓量
• 接口类型: 公共接口
• 接口URL: /linear-swap-api/v1/swap_open_interest

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

• 接口名称: 【通用】订阅Market Detail数据
• 接口类型: 公共接口
• 订阅主题: market.$contract_code.detail

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

• 接口名称: 【通用】获取合约信息
• 接口类型: 公共接口
• 接口URL: /linear-swap-api/v1/swap_contract_info

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

• 接口名称: 【通用】订阅合约信息变动
• 接口类型: 公共接口
• 订阅主题: public.$contract_code.contract_info

 

 

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

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

• 接口名称：【通用】订阅系统状态更新
• 接口类型: 公共接口
• 订阅主题：public.$service.heartbeat

 

 

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

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

• 接口名称：【全仓】查询平台阶梯调整系数
• 接口类型：公共接口
• 接口URL：/linear-swap-api/v1/swap_cross_adjustfactor

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

• 接口名称：【全仓】查询系统划转权限
• 接口类型：公共接口
• 接口URL：/linear-swap-api/v1/swap_cross_transfer_state

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

• 接口名称：【全仓】查询系统交易权限
• 接口类型：公共接口
• 接口URL：/linear-swap-api/v1/swap_cross_trade_state

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

• 接口名称：【全仓】获取用户账户信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_account_info

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

• 接口名称：【全仓】获取用户持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_position_info

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

• 接口名称：【全仓】查询母账户下所有子账户资产信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_sub_account_list

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

• 接口名称：【全仓】查询单个子账户资产信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_sub_account_info

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

• 接口名称：【全仓】查询单个子账户持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_sub_position_info

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

• 接口名称：【全仓】查询用户当前的划转限制
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_transfer_limit

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

• 接口名称：【全仓】用户持仓量限制的查询
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_position_limit

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

• 接口名称：【全仓】获取用户资产和持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_account_position_info

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

• 接口名称：【全仓】查询用户可用杠杆倍数
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_available_level_rate

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

• 接口名称：【全仓】切换杠杆
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_switch_lever_rate

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

• 接口名称：【全仓】合约下单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_order

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

• 接口名称：【全仓】合约批量下单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_batchorder

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

• 接口名称：【全仓】撤销订单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_cancel

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

• 接口名称：【全仓】全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_cancelall

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

• 接口名称：【全仓】获取合约订单信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_order_info

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

• 接口名称：【全仓】获取订单明细信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_order_detail

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

• 接口名称：【全仓】获取合约当前未成交委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_openorders

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

• 接口名称：【全仓】获取合约历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_hisorders

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

• 接口名称：【全仓】获取历史成交记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_matchresults

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

• 接口名称：【全仓】闪电平仓下单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_lightning_close_position

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

• 接口名称：【全仓】合约计划委托下单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_order

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

• 接口名称：【全仓】合约计划委托撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_cancel

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

• 接口名称：【全仓】合约计划委托全部撤单
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_cancelall

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

• 接口名称：【全仓】获取计划委托当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_openorders

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

• 接口名称：【全仓】获取计划委托历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_cross_trigger_hisorders

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

• 接口名称：【全仓】订阅订单成交数据
• 接口类型：私有接口
• 订阅主题：orders_cross.$contract_code

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

• 接口名称：【全仓】订阅资产变动数据
• 接口类型：私有接口
• 订阅主题：accounts_cross.$margin_account

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

• 接口名称：【全仓】订阅持仓变动更新数据
• 接口类型：私有接口
• 订阅主题：positions_cross.$contract_code

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

• 接口名称：【全仓】订阅撮合订单成交数据
• 接口类型：私有接口
• 订阅主题：matchOrders_cross.$contract_code

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

• 接口名称：【全仓】订阅计划委托订单变动
• 接口类型：私有接口
• 订阅主题：trigger_order_cross.$contract_code

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

• 接口名称：查询合约信息
• 接口类型：公共接口
• 接口URL：linear-swap-api/v1/swap_contract_info

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

• 接口名称：查询平台阶梯调整系数
• 接口类型：公共接口
• 接口URL：/linear-swap-api/v1/swap_adjustfactor

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

• 接口名称：查询系统状态
• 接口类型：公共接口
• 接口URL：/linear-swap-api/v1/swap_api_state

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

• 接口名称：获取用户账户信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_account_info

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

• 接口名称：查询单个子账户资产信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_sub_account_info

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

• 接口名称：查询用户账户和持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_account_position_info

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

• 接口名称：查询母账户下所有子账户资产信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_sub_account_list

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

• 接口名称：获取用户持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_position_info

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

• 接口名称：获取单个子账户持仓信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_sub_position_info

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

• 接口名称：查询财务记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_financial_record

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

• 接口名称：获取订单明细信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_order_detail

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

• 接口名称：获取合约当前未成交委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_openorders

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

• 接口名称：获取合约历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_hisorders

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

• 接口名称：获取历史成交记录
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_matchresults

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

• 接口名称：获取计划委托当前委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_trigger_openorders

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

• 接口名称：获取计划委托历史委托
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_trigger_hisorders

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

• 接口名称：获取用户合约划转限制
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_transfer_limit

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

• 接口名称：获取用户合约持仓量限制
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_position_limit

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

• 接口名称：获取用户当前合约杠杆倍数
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_available_level_rate

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

• 接口名称：切换杠杆
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_switch_lever_rate

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

• 接口名称：订阅订单成交数据
• 接口类型：私有接口
• 订阅主题：orders.$contract_code

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

• 接口名称：订阅撮合订单成交数据
• 接口类型：私有接口
• 订阅主题：matchOrders.$contract_code

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

• 接口名称：订阅计划委托订单更新
• 接口类型：私有接口
• 订阅主题：trigger_order.$contract_code

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

• 接口名称：订阅持仓变动数据
• 接口类型：私有接口
• 订阅主题：positions.$contract_code

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

• 接口名称：订阅资产变动数据
• 接口类型：私有接口
• 订阅主题：accounts.$contract_code

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

• 接口名称：订阅合约信息变动数据
• 接口类型：公共接口
• 订阅主题：public.$contract_code.contract_info

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

• 接口名称：获取合约订单信息
• 接口类型：私有接口
• 接口URL：/linear-swap-api/v1/swap_order_info

 

 

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

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

• 接口名称：获取订单明细信息
• 接口类型：私有接口
• 接口URL：linear-swap-api/v1/swap_order_detail

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

• 接口名称：获取合约历史委托
• 接口类型：私有接口
• 接口URL：linear-swap-api/v1/swap_hisorders

 

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

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

• 接口名称：查询平台历史结算记录
• 接口类型：公共接口
• 接口URL：linear-swap-api/v1/swap_settlement_records

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

• 接口名称：获取强平订单接口
• 接口类型：公共接口
• 接口URL：linear-swap-api/v1/swap_liquidation_orders

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

• 接口名称：订阅强平订单数据
• 接口类型：公共接口
• 订阅主题：public.$contract_code.liquidation_orders

 

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

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

• 接口名称：订阅资产变动数据

• 接口类型：私有接口

• 订阅主题：accounts.$contract_code

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

• 接口名称：订阅持仓变动数据

• 接口类型：私有接口

• 订阅主题：positions.$contract_code

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