Copy page

更新日志

2026 年 10 月

[10月15日, 2026] 查询历史订单（CFD）：新增 cursor 参数

接口:

• /api/v3/cfd/trade/history-order
  

调整内容：

• 新增请求参数 cursor，在原有 pageNo 分页方式基础上支持游标分页。首页不需要传入；第二页起必填，传入上一页返回结果中最后一条记录的 orderId
  
• 补充说明：首页返回的条数可能大于传入的 limit 值
  

[10月15日, 2026] 新增历史持仓量及历史借币利率接口

新增接口:

• /api/v3/market/open-interest-history 获取合约持仓量历史
  
• /api/v3/market/interest-rate-history 获取借币利率历史
  

[10月15日, 2026] 新增服务器时间/公告/币种信息 v3 接口；多项 REST 接口增强

新增接口:

• /api/v3/market/time 获取服务器时间（由 /api/v2/public/time 迁移，响应新增 Unix 微秒字段 serverTimeMicros，与原毫秒字段 serverTime 并存）
  
• /api/v3/public/annoucements 获取公告（由 /api/v2/public/annoucements 迁移）
  
• /api/v3/market/coins 获取币种信息（由 /api/v2/spot/public/coins 迁移）
  

接口:

• /api/v3/market/instruments
  
• /api/v3/trade/place-order
  
• /api/v3/trade/place-batch
  
• /api/v3/user/set-rate-limit-quota
  
• /api/v3/user/rate-limit-quota
  
• /api/v3/account/max-open-available
  
• /api/v3/trade/unfilled-strategy-orders
  

调整内容：

• 获取交易产品信息：新增返回字段 fullName、instrumentType（metal/energy/stock/etf/crypto），marketRegion、isin，适用于股票、ETF、Reality（rtoken）等传统金融相关交易对；现有 symbolType 字段保持不变，与 instrumentType 共存返回
  
• 下单、批量下单：均新增请求参数 requestTime 与 receiveWindow，支持为下单设置有效期窗口；若撮合引擎接收到订单的时间超出 requestTime + receiveWindow，订单将被撤销而非提交到订单簿
  
• 设置限频配额、获取限频配额：现已支持子账号使用自身API Key直接调用，自行设置/查询限频配额；子账号调用时 uids/uid 字段非必填（会被忽略），母账号调用时该字段保持必填，其余规则不变
  
• 获取最大可开可用：新增请求参数 marginMode（crossed/isolated，默认crossed）；逐仓模式下，available 计算会剔除合约体验金
  
• 获取当前策略单：新增返回字段 side，与 WebSocket 订单推送中已有的字段保持一致
  

[10月13日, 2026] 关于rToken撮合系统升级的API 调整通知

为了提供更优质的流动性与更极致的交易体验，我们将于近期将rToken股票代币的撮合引擎升级。升级过程中，API 的下单，订单簿及成交数据等接口将同步做出调整。请您仔细阅读以下变更细节，并提前做好策略与系统适配。

rToken币对将会在10月14日至10月20日分批迁移至新撮合，具体迁移计划请参考这里；

一、订单说明

下单

• HTTP REST：POST /api/v3/trade/place-order；POST /api/v3/trade/place-reality-order
  
• WebSocket Topic：place-order
  

升级期间与升级后，现有的下单接口 URL 及参数逻辑保持兼容。您仍然可以使用place-order 及 place-reality-order 接口进行rToken代币下单。请注意，如果您希望修改rToken订单，请先撤单再重新下单。

完成撮合引擎升级后，系统将正式支持通过 venue 参数智能路由流动性池，支持仅场内撮合及公开市场两种渠道。同时将在现有gtd的基础上新增支持gtc执行策略的订单。rToken的gtc订单有效期为90天。

订单信息

• HTTP REST：GET /api/v3/trade/order-info
• WebSocket Topic：order

下单后您可通过REST订单信息接口或WebSocket订单频道来查询venue及rTokenTimeInForce的值

二、 普通深度 Orderbook说明

如果您使用普通深度接口/频道来获取rToken深度信息，撮合系统升级后的调整如下

升级至新撮合系统后，盘口数据可能出现短暂的价格交叉现象，属于常规情况

REST API

• HTTP REST：GET /api/v3/market/orderbook
• 工作日（交易时段）：仅返回第 1 档（BBO）最优买卖价数据。
• 周末（非交易时段）：支持根据请求参数中的 limit 返回对应档位数据。

WebSocket 订阅频道

• books1：全时段推送数据，包含交易及非交易时段
• books5 / books50 / books：仅非交易时段推送数据

三、 rToken 深度说明

rToken 融合深度（reality-orderbook）

• HTTP REST：GET /api/v3/account/reality-orderbook
• WebSocket Topic：reality-orderbook
• 深度档位：最高支持85档数据
• 推送频率：深度副本有变化则500ms推送一次，无变化则10s推送一次
• 特殊说明：升级至新撮合系统后，盘口数据可能出现短暂的价格交叉现象，属于常规情况

rToken 分层深度（reality-orderbook-segmented）

本次升级新增rToken分层深度，为了满足对场内外流动性进行精确区分的交易需求。

该深度仅针对完成撮合引擎升级的交易对有数据，未完成撮合升级的币对将不推送数据。

请注意，分层深度的具体上线时间为：2026年10月20日

• HTTP REST：GET /api/v3/account/reality-orderbook-segmented

• WebSocket Topic：reality-orderbook-segmented

• 深度档位：最高支持85档数据

• 推送频率：深度副本有变化则500ms推送一次，无变化则10s推送一次

• 特殊说明：升级至新撮合系统后，盘口数据可能出现短暂的价格交叉现象，属于常规情况

• 数据结构说明： 推送数据中的 a (Asks/卖方) 与 b (Bids/买方) 数组结构如下：

  • a[0] / b[0]：价格 (String)
  • a[1] / b[1]：场内数量 (String)
  • a[2] / b[2]：场外数量 (String)

[10月13日, 2026] 新增 STP 分组接口

新增接口:

• /api/v3/account/create-stp-groups 创建自定义 STP 分组
  
• /api/v3/account/stp-groups 查询 STP 分组列表及成员子账户
  
• /api/v3/account/add-groups-members 添加子账户到 STP 分组
  
• /api/v3/account/remove-groups-members 从 STP 分组移除子账户
  

[10月5日, 2026] Reality 交易指南：新增 rToken 限价单交易规则

• Reality 交易指南
  调整内容：新增 rToken 限价单交易规则：单个 UID、单个币对在统计周期内终态订单超过 2,000 笔且成交率低于 10% 时，该交易对限价单功能将被限制（错误码 41121）；若下一统计周期未再触发，限制自动解除（每日 04:00 UTC+8 重新评估）