Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
更新预告
2026
10 月9 月8 月7 月6 月5 月4 月3 月2 月1 月
2025
12 月11 月10 月9 月8 月7 月6 月5 月
更新日志

2026 年 10 月

[10月22日, 2026] 新增获取全部杠杆借币信息接口;多个 REST 接口调整

新增接口:

  • /api/v3/market/margin-loans-all 获取全部币种的杠杆借币信息,coin 参数改为非必填

接口:

  • /api/v3/market/oi-limit
  • /api/v3/account/info
  • /api/v3/trade/place-order
  • /api/v3/trade/unfilled-strategy-orders
  • /api/v3/trade/history-strategy-orders
  • /api/v3/market/current-fund-rate

调整内容:

  • 获取合约OI限仓信息:新增返回参数 singlePositionRatio(单 UID 合约持仓占比)、totalPositionRatio(子母账户合约持仓占比),均为小数形式,如 0.1 代表 10%
  • 获取账户信息:新增返回参数 traderType(trader 交易员 / not_trader 非交易员)
  • 下单:新增请求参数 bboLevel(queue1/queue5/counterparty1/counterparty5,仅限价单支持)和 slippageTolerance(仅市价单支持,默认 2%,范围 [0.01, 0.05])
  • 获取当前策略单 / 获取历史策略单:新增返回参数 marginMode(crossed 全仓 / isolated 逐仓)。创建策略单接口的请求参数此前已支持 marginMode。
  • 实时资金费率:新增返回参数 lastFundingRate、nextFundingRate、baseInterestRate、impactMarginNotional

[10月22日, 2026] 新增跟单账户最大可转出接口

新增接口:

  • /api/v3/copy/futures/copy-max-transferable 根据指定币种查询跟单账户的最大可转出数量

[10月20日, 2026] 理财业务线新增现金宝(Cash+)接口

新增接口:

  • /api/v3/earn/cashplus/subscribe-info 获取现金宝申购前置信息,包括当前年化及可申购币种列表
  • /api/v3/earn/cashplus/subscribe 现金宝申购
  • /api/v3/earn/cashplus/subscribe-result 获取现金宝申购订单结果
  • /api/v3/earn/cashplus/redeem-info 获取现金宝赎回前置信息,包括赎回到账币种列表及可赎回持仓
  • /api/v3/earn/cashplus/redeem 现金宝赎回
  • /api/v3/earn/cashplus/redeem-result 获取现金宝赎回订单结果
  • /api/v3/earn/cashplus/positions 获取现金宝持仓、累计收益及年化收益率
  • /api/v3/earn/cashplus/history-orders 使用游标分页获取现金宝历史记录

母账户与子账户均可调用。

[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)

风险提示与建议

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

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

[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 重新评估)
更新预告9 月
On this page
  • [10月22日, 2026] 新增获取全部杠杆借币信息接口;多个 REST 接口调整
  • [10月22日, 2026] 新增跟单账户最大可转出接口
  • [10月20日, 2026] 理财业务线新增现金宝(Cash+)接口
  • [10月15日, 2026] 查询历史订单(CFD):新增 cursor 参数
  • [10月15日, 2026] 新增历史持仓量及历史借币利率接口
  • [10月15日, 2026] 新增服务器时间/公告/币种信息 v3 接口;多项 REST 接口增强
  • [10月13日, 2026] 关于rToken撮合系统升级的API 调整通知
    • 一、订单说明
    • 二、 普通深度 Orderbook说明
    • 三、 rToken 深度说明
  • [10月13日, 2026] 新增 STP 分组接口
  • [10月5日, 2026] Reality 交易指南:新增 rToken 限价单交易规则