# 2026 年 5 月 ## [5月28日, 2026] 新增创建 Agent 子账户接口；查询子账户列表新增 agent 类型枚举值 新增接口:
- `/api/v3/user/sub-account/agent-create` 为 AI Agent 实例创建专属子账户
接口:
- `/api/v3/user/sub-list`
调整内容：返回参数 `type` 新增枚举值 `agent`，表示 Agent 子账户
## [5月26日, 2026] 新增提现地址簿查询及撤销提币API 新增接口:
- `/api/v3/account/withdraw-address` 查询账户下已绑定的提现地址簿
- `/api/v3/account/cancel-withdrawal` 对冷静期间的提币申请发起撤销操作
## [5月26日, 2026] 成交频道：category 推送字段枚举值更新为小写 ### websocket 频道:
- UTA 成交频道（`fill`）
调整内容：推送字段 `category` 枚举值更新为小写：`spot` / `margin` / `usdt-futures` / `coin-futures` / `usdc-futures`
## [5月21日, 2026] 查询子账户列表：type 字段枚举值更新 接口:
- `/api/v3/user/sub-list`
调整内容：返回参数 `type` 枚举值更新为小写：`normal` 普通子账户 / `virtual` 虚拟子账户 / `custodian` 托管子账户
## [5月19日, 2026] 统一账户逐仓支持：下单、持仓、WebSocket 多接口新增 marginMode 参数 ### REST 接口:
- /api/v3/trade/place-order
- /api/v3/position/current-position
- /api/v3/account/adjust-account-mode
调整内容：
- `place-order` 新增请求参数 `marginMode`（String）：保证金模式（`crossed` 全仓 / `isolated` 逐仓），不传默认全仓，仅适用于合约。
- `current-position` 响应参数 `positionBalance`、`unrealisedPnl` 描述更新：逐仓模式下分别反映逐仓保证金数量和逐仓未实现盈亏。
- `adjust-account-mode` 请求参数 `mode` 新增枚举值 `isolated`（逐仓模式）。
### WebSocket 频道:
- UTA 下单频道（`place-order`）
- UTA 持仓频道（`position`）
调整内容：
- `place-order` 频道新增请求参数 `marginMode`（String）：保证金模式（`crossed` 全仓 / `isolated` 逐仓），不传默认全仓，仅适用于合约。
- `position` 频道推送参数 `marginMode` 补充枚举说明：`crossed` 全仓 / `isolated` 逐仓。
## [5月19日, 2026] WebSocket 深度频道：删除 checksum 字段 ### websocket **涉及频道：**
- 深度：`books` / `books1` / `books5` / `books50`
- RPI 深度：`rpi-books` / `rpi-books1` / `rpi-books5` / `rpi-books50`
调整内容：
- 推送参数 `checksum` 已从上述深度频道**删除**。请改用 `seq` 与 `pseq` 进行订单簿一致性校验。
## [5月19日, 2026] SBE 频道：新增 sts 和 category 字段 ### websocket (SBE) 接口:
- SBE 50档深度（`books50`）
- SBE 最优买卖价（`books1`）
- SBE 公共成交（`publicTrade`）
调整内容：新增推送字段 `sts`（uint64，流服务推送时间戳，µs）和 `category`（uint8，业务线：`spot` 现货 / `usdt-futures` U本位合约 / `coin-futures` 币本位合约 / `usdc-futures` USDC合约）
## [5月14日, 2026] 新增P2P商家API 新增接口:
- /api/v3/p2p/ad-list 获取公开广告列表
- /api/v3/p2p/exchange-rate 查询汇率
- /api/v3/p2p/fee-simulate 广告前置（手续费试算）
- /api/v3/p2p/ad-limit 发布广告查询限额信息
- /api/v3/p2p/ad-create 创建广告
- /api/v3/p2p/ad-update 更新广告
- /api/v3/p2p/ad-operate 变更广告状态
- /api/v3/p2p/ad-info 获取广告详情
- /api/v3/p2p/my-ads 获取我的广告列表
- /api/v3/p2p/pending-orders 获取进行中订单
- /api/v3/p2p/all-orders 获取全部订单
- /api/v3/p2p/order-info 获取订单详情
- /api/v3/p2p/order-pay 标记订单已付款（确认付款）
- /api/v3/p2p/order-release 释放资产（确认放币）
- /api/v3/p2p/user-info 获取当前商家账户信息
- /api/v3/p2p/currencies 获取支持交易的法币/数字币信息
- /api/v3/p2p/pay-method 获取当前账户支付方式
- /api/v3/p2p/balance 查询当前账户余额
## [5月12日, 2026] Delta中性模式：账户模式切换新增delta枚举及新增获取Delta模式信息接口 接口:
- `/api/v3/account/adjust-account-mode`
- `/api/v3/account/settings`
- `/api/v3/account/delta-info`（新增）
调整内容：
- `adjust-account-mode`：请求参数 `mode` 新增 `delta` 枚举：Delta中性模式
- `settings`：返回参数 `accountLevel` 新增 `isolated`（逐仓模式）和 `delta`（Delta中性模式）枚举
- 新增接口 `/api/v3/account/delta-info`：获取Delta中性模式下的Delta权益比率、阈值及各币种净头寸比例信息
## [5月12日, 2026] 一键平仓：新增支持 X-CHANNEL-API-CODE 接口:
- `/api/v3/trade/close-positions`
调整内容：该接口新增支持请求头 `X-CHANNEL-API-CODE`，用于经纪商返佣归属识别。
## [5月8日, 2026] 跟单交易：新增带单账户最大可转出、划转及划转记录接口 新增接口:
- `/api/v3/copy/futures/max-transferable` 获取带单账户最大可转出金额及可用余额
- `/api/v3/copy/futures/transfer` 带单账户划转（转入/转出）
- `/api/v3/copy/futures/transfer-record` 查询带单账户划转记录
## [5月7日, 2026] WebSocket：订阅响应及交易操作返回报文新增 connId 字段 ### websocket 调整内容：
- 所有**公共频道**（订阅/取消订阅响应）：新增顶层字段 `connId`（连接ID）
- 所有**私有频道**（订阅/取消订阅响应）：新增顶层字段 `connId`
- **交易操作返回报文**（`place-order` / `cancel-order` / `batch-place` / `batch-cancel` / `modify-order` / `batch-modify`）：新增 `connId` 字段
- 注意：ping/pong 报文及正常数据推送报文**不携带** `connId`
## [5月7日, 2026] 深度频道推送数据新增 maxDepth 字段 ### websocket 调整内容：
- `books` 频道推送数据新增 `maxDepth`（最大深度档位）字段
## [5月6日, 2026] 经纪商子账户 API Key：permType 枚举值更新 接口:
- `POST /api/v3/broker/create-sub-apikey`
- `POST /api/v3/broker/modify-sub-apikey`
- `GET /api/v3/broker/query-sub-apikey`
调整内容：`permType` 参数/返回字段枚举值由 `Read/Write` / `Read-only` 调整为 `read_write` / `read_only`