更新日志
[4月14日, 2025] 新增获取独立经济商(ND Broker)子账户充提记录接口
接口：/api/v2/broker/all-sub-deposit-withdrawal
调整内容：
- 新增获取独立经纪商(ND Broker)获取子账户最近90天的充值、提币记录
[4月10日, 2025] 虚拟子账户API Key相关接口调整
接口：/api/v2/user/create-virtual-subaccount-apikey，/api/v2/user/modify-virtual-subaccount-apikey，/api/v2/user/virtual-subaccount-apikey-list
调整内容：
- 新建、修改、查询子账户API key接口 permList 添加
transfer钱包划转权限 - 修改、查询子账户API Key接口新增支持普通子账户
[4月10日, 2025] 现货获取交易对信息接口响应信息调整
接口：/api/v2/spot/public/symbols
调整内容：
- 接口响应新增
offTime字段 - maxTradeAmount响应参数固定返回
900000000000000000000，请忽略这个响应参数
[04.09, 2025] 新增ADL排名接口；
接口：/api/v2/mix/position/adlRank
新增内容：
- 支持获取用户各个交易对的ADL排名。
[04.08, 2025] 新增 新版带单员创建带单API Key接口；新版跟随者跟单设置接口；
接口：/api/v2/copy/mix-trader/create-copy-api
新增内容：
- 新版带单员创建带单API Key接口。
接口：/api/v2/copy/mix-follower/copy-settings
新增内容：
- 新版跟随者跟单设置接口。
[04.02,2025] 预估利息及可借数量入参调整
接口：/api/v2/earn/loan/public/hour-interest, /api/v2/earn/loan/borrow
- 新增内容：
入参质押天数调整为
SEVEN: 7天THIRTY: 30天FLEXIBLE: 活期
[03.27, 2025] 合约账户信息接口、资金费率接口返回值新增字段；现货成交明细入参调整；
接口：/api/v2/mix/account/accounts
新增内容：
- 合约账户接口信息返回值新增联合保证金当前币种最大可转出
available字段。
接口：/api/v2/mix/market/current-fund-rate
新增内容：
- 获取当前资金费率接口返回值新增 结算周期、资金费率上下限、下次更新时间参数。
接口：/api/v2/spot/trade/fills
变更内容：
- 请求参数中的
symbol由必填修改为非必填。
[03.22, 2025] Websocket 合约账户频道新增响应字段
频道：合约 - 私有频道 - 账户频道
改动点：推送信息新增"crossedRiskRate"（全仓时风险率）和"unrealizedPL"（未实现盈亏）字段
[03.20, 2025] 现货订单查询类接口, 根据ClientOid可查询订单信息调整为只能查询2小时内数据
接口：现货查询订单信息类接口
改动点：通过ClientOid只能查询2小时内订单信息
[03.18,2025] 修改子账户ApiKey权限 入参说明调整
接口：/api/v2/broker/manage/modify-subaccount-apikey
变更内容：
- 修改子账户Apikey权限 入参
permType权限类型 改为必填。
[03.12,2025] 获取合约主动买卖量信息 period入参调整
接口：/api/v2/mix/market/long-short
变更内容：
- 入参
period字段1d改为1Dutc。
[03.11,2025] 合约新增OI 限仓信息API
接口：/api/v2/mix/market/oi-limit
新增内容：
- 合约新增OI 限仓信息API。
[02.19,2025] 添加现货杠杆公有频道instId描述
变更内容：
- 添加现货杠杆公有频道instId描述 只支持：
default(全部币对)
[02.18,2025] Broker子账户充值记录添加userId响应字段
接口：/api/v2/broker/subaccount-deposit
变更内容：
- Broker子账户充值记录添加userId响应字段
[02.07,2025] 新增经典账户模拟盘调用说明
新增内容：
- Websocket 订阅模拟盘消息方法说明
- RestApi 调用模拟盘进行API交易方法说明
[02.03,2025] 合约错误码新增code 22067
新增内容：
- 合约错误码新增
code 22067: ADL处理中，禁止操作
[01.16,2025] 合约财务记录增加futureTaxType参数枚举
接口：/api/v2/tax/future-record
新增内容：
- 增加返回值futureTaxType参数枚举类型和说明
[01.15,2025] Bitget 关于 USDC 永续合约指数价格由 USD 计价调整为 USDC 计价的公告
主要调整
- 指数价格和标记价格：USDC 永续合约的指数价格和标记价格将采用 USDC 报价。
- 订单簿报价：USDC 永续合约的订单簿报价也将采用 USDC 计价。
详情请参考：https://www.bitget.com/zh-CN/support/articles/12560603820643
[12.24,2024] 【闪兑】接口限频调整
/api/v2/convert/trade, 限频从10次/秒/UID，调整成5次/秒/UID
[12.16,2024] 现货账户获取划转记录接口废弃idLessThan参数，新增pageNum参数
接口：现货账户获取划转记录接口 改动点：现货账户获取划转记录接口废弃idLessThan参数，新增pageNum参数，实现分页
[11.22, 2024] Websocket连接限制规则更新
连接说明：
连接限制：300次连接请求/IP/5分钟，单个IP最多可以创建100个连接
订阅限制：240次/小时/连接，单个连接最多可以订阅1000个频道
为了保持连接有效且稳定，建议您进行以下操作：
- Websocket连接强制24小时断一次，请您在代码中添加重连机制
- 用户设置一个定时器，每30秒发送字符串"ping", 并期待一个字符串"pong"作为回应。如果未收到字符串"pong"响应，请重新连接
- 如果2分钟内服务端没收到"ping"，会自动断开连接
- Websocket服务器每秒每连接最多接受10个消息。消息包括:
- 字符串"ping"
- JSON格式的消息，比如订阅，断开订阅
- 如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽
- 为了保持连接的稳定性，强烈建议单个连接不要订阅超过50个频道。订阅频道数越少的连接，稳定性会更高。
[10.17,2024] 合约和现货的获取行情接口，更新change24h字段计算方式
接口：
- /api/v2/spot/market/tickers 现货获取行情信息接口
- /api/v2/mix/market/ticker 合约获取单个交易对行情接口
- /api/v2/mix/market/tickers 合约获取全部交易对行情接口
改动点：
API响应中的change24h字段的计算将会从东八区0点到当前时间的涨跌幅更换成当前时间往前推24小时的涨跌幅数值
[09.24,2024] U本位联合保证金需求相关API上线
接口：U本位联合保证金需求相关API上线，涉及设置保证金模式接口，合约账号查询接口，合约仓位查询接口
[08.28,2024] p2p商家广告单接口调整limit参数最大值为20
接口：p2p商家广告单接口 改动点：调整limit参数最大值为20
[08.15,2024] API接口限频调整
| 接口 | 原始限频 | 修改后限频 |
|---|---|---|
| /api/v2/copy/mix-trader/order-close-positions | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/order-current-track | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/query-current-orders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/query-history-orders | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/order-history-track | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/profits-group-coin-date | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/profit-history-summarys | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/profit-history-details | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/profit-details | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/order-modify-tpsl | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/order-total-detail | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-broker/query-traders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/settings | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/close-positions | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/setting-tpsl | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/query-settings | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/cancel-trader | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/config-settings-base | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-follower/query-traders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/config-query-followers | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/config-remove-follower | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/config-query-symbols | 20次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-trader/config-setting-symbols | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/mix-broker/query-history-traces | 10次/秒/UID | 5次/秒/UID |
| /api/v2/spot/trade/batch-cancel-plan-order | 10次/秒/UID | 5次/秒/UID |
| /api/v2/spot/account/deduct-info | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-follower/query-current-orders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-follower/query-settings | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-follower/query-history-orders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-follower/query-traders | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/config-query-settings | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/order-history-track | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/profit-summarys | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/profit-history-details | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/profit-details | 10次/秒/UID | 5次/秒/UID |
| /api/v2/copy/spot-trader/order-total-detail | 10次/秒/UID | 5次/秒/UID |
| /api/v2/user/virtual-subaccount-apikey-list | 10次/秒/UID | 5次/秒/UID |
| /api/v2/broker/account/subaccount-withdrawal | 10次/秒/UID | 1次/秒/UID |
| /api/v2/spot/account/switch-deduct | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-follower/order-close-tracking | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-follower/cancel-trader | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-follower/stop-order | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-follower/settings | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-follower/setting-tpsl | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-trader/order-close-tracking | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-trader/config-setting-symbols | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-trader/config-remove-follower | 10次/秒/UID | 1次/秒/UID |
| /api/v2/copy/spot-trader/order-modify-tpsl | 10次/秒/UID | 1次/秒/UID |
[07.03,2024] 提币和获取充值地址支持比特币闪电网络
接口：提币，获取充币地址，获取子账户充币地址 改动点：获取充币地址支持获取比特币闪电网络发票地址，提币接口支持比特币闪电网络发票地址提币
[06.25,2024] 获取p2p商家列表接口调整
获取p2p商家列表接口不再返回merchantId字段
[03.15,2024] 历史计划委托的记录时效及查询时间范围调整
接口：获取历史计划委托
改动点：
startTime和endTime间隔调整为90天- 仅支持90天内的历史记录查询
[02.06,2024] Websocket现货订单频道推送参数新增newSize
现货订单频道推送新增newSize参数，后续会逐步替换size参数
newSize表示订单委托数量。规则如下:
- 当
orderType=limit时，newSize表示base coin数量; - 当
orderType=market且side=buy时，newSize表示quote coin数量； - 当
orderType=market且side=sell时，newSize表示base coin数量
[01.19,2024] 税务接口查询时间范围调整
接口：现货财务记录，合约财务记录，杠杆财务记录，p2p财务记录
改动点：startTime和endTime间隔由一年调整为30天
[12.27,2023] Broker子账户提币接口调整
请求参数dest不再支持传入internal_transfer
请求参数toType移除
[11.16,2023] 批量撤单接口响应新增errorCode参数
批量撤单接口新增响应参数errorCode