更新日志

2026-09-07

• 重要提示：即使不启用双向持仓，以下不兼容改动也可能需要调整
  • 获取合约市场设置和修改合约市场设置不再返回或接受 settle_switch
  • 获取仓位自动结算历史记录已下线
  • 获取仓位资金费用历史记录响应中不再包含 margin_mode
  • 获取合约账户余额和合约账户余额订阅中 available、margin、transferrable 的含义和计算口径已调整
  • 返回仓位信息的相关接口中，margin_avbl、liq_price、bkr_price、cml_position_value 和 max_position_value 的含义或计算口径已调整
• 启用双向持仓：通过修改合约市场设置将 position_mode 设置为 hedge，可通过获取合约市场设置查询当前模式
  • 下单接口：下委托单、下批量委托单、下计划委托单和下批量计划委托单新增 position_side
  • 仓位操作接口：调整仓位杠杆、调整仓位保证金、平仓、设置仓位止盈、设置仓位止损、修改仓位止盈、修改仓位止损、撤销仓位止盈和撤销仓位止损新增 position_side
  • 合约撤单、改单、订单查询、成交查询及用户成交、委托、计划委托 WS 订阅均新增或返回 position_side
• 与双向持仓无关的接口更新
  • 下单接口新增 is_reduce_only，用于创建只减仓委托
  • 返回仓位信息的相关接口及用户仓位订阅新增 risk_rate

2026-06-18

• 更新接口权限要求：
  • 子账号间资产划转 需要交易权限

2026-06-17

• 更新接口权限要求：
  • 子账号间资产划转 需要提现权限
  • 取消申请提现 需要提现权限
  • 资产划转、修改账户设置、创建子账号、冻结子账号、解冻子账号、创建子账号 APIKEY、编辑子账号 APIKEY、删除子账号 APIKEY、更新充值地址、添加 AMM 账户流动性、减少 AMM 账户流动性 需要交易权限
• API Key 的 secret_key 仅在创建时返回；获取子账号 APIKEY 详情 和 编辑子账号 APIKEY 的响应中不再返回 secret_key

2026-04-15

• 新增合约溢价指数订阅

2025-12-18

• 合约止盈止损功能升级，支持同一仓位设置多个止盈止损单（最多20个）
• 新增合约修改止损单
• 新增合约修改止盈单
• 新增合约撤销止损单
• 新增合约撤销止盈单
• 更新合约设置仓位止损，新增 stop_loss_amount 参数
• 更新合约设置仓位止盈，新增 take_profit_amount 参数
• 更新返回仓位数据的相关接口，响应中新增 stop_loss_list 和 take_profit_list 字段
• 更新合约用户仓位订阅，推送数据中新增 stop_loss_list 和 take_profit_list 字段

2025-11-13

• 新增推荐返佣获取直客邀请列表
• 新增推荐返佣获取直客返佣记录
• 新增推荐返佣获取直客返佣明细
• 新增推荐返佣获取代理邀请列表
• 新增推荐返佣获取代理返佣记录
• 新增推荐返佣获取代理返佣明细

2025-10-30

• 新增 获取子账号余额

2025-08-14

• 新增 现货批量修改委托单
• 新增 合约批量修改委托单

2025-04-16

• 新增 获取 AMM 流动性池
• 新增 获取 AMM 收益记录

2025-01-09

• 将批量下单和批量撤单分组中的部分接口分别调整至对应的下单和撤单分组
• 对应的批量请求不再按其请求次数进行限频，而是按请求中包含的子请求数进行限频
• 具体的改动参见限频规则

2024-09-25

• 下线 v1 版本的 API 服务

2024-09-12

• 修复合约市场状态订阅接口响应中latest_funding_time和next_funding_time字段的精度问题，修复后统一为毫秒级时间戳

2024-09-05

• 新增 获取现货账户交易流水

2024-8-22

• 优化改单逻辑，新的改单逻辑不会再撤销原有订单，而是直接修改原有订单(修改计划单逻辑暂未修改)
  • 现货用户委托单订阅 新增 modify 推送事件
  • 合约用户委托单订阅 新增 modify 推送事件
• 修复现货下批量委托单接口响应结构与文档不符的问题，正确结构请参考文档示例

2024-07-18

• 新增 stp_mode，在下委托单的相关的接口中可以使用这个参数来阻止自成交，例如下列接口
  • 下委托单
  • 下批量委托单

2024-07-08

• 新增 获取币种资料

2024-06-27

• 新增 获取市场溢价指数历史记录

2024-04-18

• 变更 认证 中 步骤二：生成认证参数 部份，主要包括以下内容：
  • request_path 的组成去除 secret_key 部份
  • SHA256签名方法更换为HMAC-SHA256签名，其中以 secret_key 作为key
  • 新特性暂时兼容旧的签名方法，请尽快迁移使用新的签名方法，旧的签名方法将择期弃用

2024-01-25

• 新版本 API 文档发布，主要包括以下内容：
  • 大部分 HTTP、WS 接口请求路径、请求参数和请求响应的调整
  • 签名算法统一，现在现货、合约两个模块的签名算法一致了
  • API 限频策略的调整，详细见限频规则
  • 其他的改动详细见API简介