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

2026 年 11 月

[11月5日, 2026] rToken 订单路由策略(venue)枚举调整公告

  • 生效时间:2026 年 11 月 5 日

rToken 下单及订单查询接口(REST、WebSocket)的 venue(订单路由策略)参数枚举调整如下:

调整前调整后说明
internalizationinternal_market订单在交易所内撮合,不提交美股券商
-lit_market订单提交至美股券商,不在交易所内撮合
lit_market不传/default优先交易所内部比价撮合,未成交部分提交至券商

重要提示:

  1. internalization 更名为 internal_market,含义不变,含义为"订单在交易所内撮合,不提交美股券商"。请将该枚举值替换为 internal_market。
  2. 订单详情中原本展示为 lit_market 的订单,调整后展示为 default,含义为"优先交易所内部比价撮合,未成交部分提交至券商"。请同步更新您侧订单详情的结果解析逻辑。
  3. 新的 lit_market 含义为"订单提交至券商执行,不在交易所内撮合",与调整前订单详情展示的 lit_market 含义不同,请注意区分。
  4. 下单时不传 venue 即为默认策略;下单接口可传入的枚举值为 internal_market 或 lit_market。
  5. 订单详情返回的 venue 将统一使用调整后的枚举值。

请您根据自身交易策略评估并调整 venue 参数的使用方式,以确保订单按预期路由。详细的路由与撮合规则请参考 rToken 交易指南。
如您在 11 月 5 日后遇到参数校验或枚举解析异常,请及时与我们联系,我们将提供协助。

[11月4日, 2026] 统一账户新增代理商、理财宝、鲨鱼鳍与经纪商接口

新增接口:

代理商(/api/v3/affiliate/*):

  • GET /api/v3/affiliate/customer-list 获取直客列表
  • GET /api/v3/affiliate/customer-asset 获取直客余额
  • GET /api/v3/affiliate/customer-trade-volume 获取直客交易量
  • GET /api/v3/affiliate/customer-deposit 获取直客充值记录
  • GET /api/v3/affiliate/customer-kyc-result 获取直客认证结果
  • GET /api/v3/affiliate/customer-commission 获取直客佣金
  • GET /api/v3/affiliate/sub-customer-list 获取直客下级信息
  • GET /api/v3/affiliate/sub-affiliate-info 获取子代理信息
  • GET /api/v3/affiliate/sub-affiliate-commission 获取子代理佣金

理财宝(/api/v3/earn/savings/*):

  • GET /api/v3/earn/savings/product 理财宝产品列表
  • GET /api/v3/earn/savings/account 理财宝账户信息
  • GET /api/v3/earn/savings/assets 理财宝资产信息
  • GET /api/v3/earn/savings/records 理财宝历史记录
  • GET /api/v3/earn/savings/subscribe-info 理财宝申购详情
  • POST /api/v3/earn/savings/subscribe 理财宝申购
  • GET /api/v3/earn/savings/subscribe-result 理财宝申购结果
  • POST /api/v3/earn/savings/redeem 理财宝赎回
  • GET /api/v3/earn/savings/redeem-result 理财宝赎回结果

鲨鱼鳍(/api/v3/earn/sharkfin/*):

  • GET /api/v3/earn/sharkfin/product 鲨鱼鳍产品列表
  • GET /api/v3/earn/sharkfin/account 鲨鱼鳍账户信息
  • GET /api/v3/earn/sharkfin/assets 鲨鱼鳍资产信息
  • GET /api/v3/earn/sharkfin/records 鲨鱼鳍历史记录
  • GET /api/v3/earn/sharkfin/subscribe-info 鲨鱼鳍申购详情
  • POST /api/v3/earn/sharkfin/subscribe 鲨鱼鳍申购
  • GET /api/v3/earn/sharkfin/subscribe-result 鲨鱼鳍申购结果

经纪商(/api/v3/broker/*):

  • POST /api/v3/broker/modify-subaccount-email 子账户绑定邮箱
  • GET /api/v3/broker/subaccount-email 获取子账户邮箱
  • GET /api/v3/broker/trade-volume 获取经纪商子账户交易记录
  • GET /api/v3/broker/total-commission 获取经纪商佣金数据
  • GET /api/v3/broker/order-commission 获取经纪商订单返佣数据
  • GET /api/v3/broker/rebate-info 获取用户的经纪商返佣信息

[11月3日, 2026] 接口参数调整

接口:

  • /api/v3/account/sub-transfer
  • /api/v3/cfd/account/instruments
  • WebSocket place-order 频道
  • WebSocket liquidation 频道

调整内容:
/api/v3/account/sub-transfer:请求参数 clientOid 的最大长度由 64 个字符调整为 50 个字符。
/api/v3/cfd/account/instruments:新增返回参数 currentTimezone,产品交易时区,以 UTC 偏移小时数表示(如 +2 表示 UTC+2)。
WebSocket place-order 频道:新增请求参数 bboLevel(限价单 BBO 档位,queue1/queue5/counterparty1/counterparty5,市价单时无效)、slippageTolerance(市价单滑点百分比,默认值 2%,范围 [0.01, 0.05])。
WebSocket liquidation 频道:新增请求参数 symbol,传入后该频道仅推送指定交易对的公共强平数据。

[11月2日, 2026] FastAPI 签名算法升级

  • 上线日期:2026 年 11 月 3 日

FastAPI 的请求签名算法由 MD5withRSA 升级为 SHA256withRSA;您只需将签名代码及回调验签代码中的哈希算法由 MD5 改为 SHA-256。以 Java 为例:将 Signature.getInstance("MD5withRSA") 替换为 Signature.getInstance("SHA256withRSA"),其他语言同理。预估工作量在一小时以内,另加沙盒测试。
签名和 RSA 加密解密的代码示例请参考FastAPI 接入指南
具体切换时间线请参考Bitget FastAPI 签名算法升级通知

更新预告10 月
On this page
  • [11月5日, 2026] rToken 订单路由策略(venue)枚举调整公告
  • [11月4日, 2026] 统一账户新增代理商、理财宝、鲨鱼鳍与经纪商接口
  • [11月3日, 2026] 接口参数调整
  • [11月2日, 2026] FastAPI 签名算法升级