# 2026 年 10 月


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

接口:<br/>
- /api/v3/cfd/trade/history-order<br/>

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

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

新增接口:<br/>
- /api/v3/market/open-interest-history 获取合约持仓量历史<br/>
- /api/v3/market/interest-rate-history 获取借币利率历史<br/>

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

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

接口:<br/>
- /api/v3/market/instruments<br/>
- /api/v3/trade/place-order<br/>
- /api/v3/trade/place-batch<br/>
- /api/v3/user/set-rate-limit-quota<br/>
- /api/v3/user/rate-limit-quota<br/>
- /api/v3/account/max-open-available<br/>
- /api/v3/trade/unfilled-strategy-orders<br/>

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


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

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

rToken币对将会在10月14日至10月20日分批迁移至新撮合，具体迁移计划请参考[这里](https://www.bitget.com/zh-CN/support/articles/12560603897457)；

### 一、订单说明

**下单**

- **HTTP REST：**`POST /api/v3/trade/place-order`；`POST /api/v3/trade/place-reality-order`<br/>
- **WebSocket Topic**：`place-order`<br/>

升级期间与升级后，现有的下单接口 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)

::::tip{title="风险提示与建议"}

1. 请留意深度频道在工作日与周末的档位推送差异，避免因交易日 `books5` / `books50` 停止推送而引发程序异常<br/>
2. 如需使用rToken分层深度`reality-orderbook-segmented` 接口，请联系您的客户经理申请开启白名单权限<br/>

如有任何疑问，请随时联系 API 官方技术支持团队

::::



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

新增接口:<br/>
- `/api/v3/account/create-stp-groups` 创建自定义 STP 分组<br/>
- `/api/v3/account/stp-groups` 查询 STP 分组列表及成员子账户<br/>
- `/api/v3/account/add-groups-members` 添加子账户到 STP 分组<br/>
- `/api/v3/account/remove-groups-members` 从 STP 分组移除子账户<br/>


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

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