Copy page

更新日志

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