Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
快速开始
统一账户快速开始最佳实践指南rToken 交易指南CFD 交易指南带单 API 介绍历史数据下载指南FastApi 接入指南
模拟盘
限频规则
API 参考
API 文档枚举
错误码
概览

rToken 交易指南

概述

rToken指 Bitget 的美股代币化交易对,交易对名称以 r 为前缀(如 rAAPLUSDT)。

关于rToken的详情信息,请参考:

  • Reality协议及rToken代币化介绍。
  • Bitget 股票现货交易常见问题:rTokens、分红、费用与交易时间

订单路由与撮合机制

rToken订单通过 Super Match 完成撮合——这是 Bitget 交易引擎与外部券商(用于将未成交的订单流路由至美股市场)之间的一层内部撮合机制。无论美股当前是否开市,每一笔 rToken 现货订单都会先经过 Super Match 评估,未成交的部分才会路由至场外。

下单参数venue:选择订单可成交的范围

venue 参数(在下单与创建Reality股票订单接口均可使用)控制订单的路由行为:

venue 取值行为说明
internalization订单只会在 Super Match Bitget内部撮合,不会路由至外部券商,不受开市/休市切换的影响,也不参与周末/周一开市前对挂单的批量重路由
lit_market(默认)Super Match 优先尝试场内撮合,未成交的部分再路由至外部券商(场外公开市场)

一般使用建议:

  • 若您希望订单流完全保留在 Super Match 内部(如报价/做市场景),使用 internalization。
  • 若您希望未成交的部分也能到达外部券商(如建仓或减仓),使用 lit_market。

订单有效期由 rTokenTimeInForce 单独控制:gtd(当前交易时段内有效)或 gtc(有效期 90 天)。具体的时段边界规则详见下单与创建Reality股票订单接口的字段说明。

暂不支持改单

rToken订单暂不支持改单。如需调整挂单的价格或数量,请先撤单,再重新下单。

挂单成交逻辑(盘中交易时段)

美股交易时段内,Super Match 会围绕 NBBO(全美最优报价)构建一个动态价格带,用于判断您的挂单限价单能否在场内撮合:

  • ΔP 是针对每笔订单实时估算的滑点补偿——即该订单若改为直接路由至外部券商,预计会多承受的滑点。ΔP 按单独订单计算(并非固定常数),会随订单规模相对日均成交量的占比、当前波动率、NBBO 价差,以及当下外部流动性的厚薄而扩大。(当前ΔP暂时设置为0,后续可能会更改)
  • 场内可撮合的 价格带 为 [NBB − ΔP, NBO + ΔP]:
    • 散户买单可与价格不高于 NBO + ΔP 的任意场内挂卖单(ask)撮合;
    • 散户卖单可与价格不低于 NBB − ΔP 的任意场内挂买单(bid)撮合。
  • 价格带内的撮合按 逐档位 进行(不仅限于最优档位),直到来单完全成交或价格带内流动性耗尽。价格带内无法成交的部分将路由至场外(受 venue 约束)。
  • 成交价格始终为您的挂单(报价)价格——而非 NBBO,也非价格带边界价。若您的挂卖单落在价格带内并被吃掉,散户吃单方支付的是您的报价,而不是 NBO + ΔP。这意味着您的报价与 NBBO 之间的全部价差都归您(作为做市方)所得。

美股其他交易时段(盘前/盘后/夜盘/周末/假期)

美股常规交易时段之外没有实时 NBBO(周末/假期),外部券商也不可用,因此 Super Match 的内部订单簿是唯一的定价来源。此时撮合遵循标准的价格优先、时间优先规则,不涉及 ΔP 价格带。为防止休市期间出现异常定价,订单会受到价格保护机制校验:参考价 × 休市期间价格偏离限制。超出该范围的订单将被拒绝。(参考价格为上次收盘价格,价格偏离限制当前限制为20%)

盘前与盘后时段属于中间状态:NBBO 仍然存在,但外部流动性较薄,因此场内可成交的价格范围相比常规时段实际上会更宽。

流动性方向说明

  • 仅 internalization 挂单中被动在 Super Match 内部撮合的部分记为 Maker;其余所有成交——包括全部 lit_market 成交,以及 internalization 订单中主动吃单的部分——均记为 Taker。

核心交易链路

分类功能接口实现开放范围协议支持
行情类币对信息复用现有接口,返回 isReality 标识公开REST
行情类行情复用现有接口公开REST
行情类K 线复用现有接口公开REST + WebSocket
行情类深度Reality 独立接口需白名单REST + WebSocket
行情类平台成交Reality 独立接口需白名单仅支持 REST
行情类股票基础数据(股票信息/市场状态/休市日历)Reality 独立接口公开仅支持 REST
交易类下单Reality 独立接口 + 常规下单接口公开REST + WebSocket
交易类撤单Reality 独立接口 + 常规撤单接口公开REST + WebSocket
交易类改单暂不支持——
交易类批量操作暂不支持——
资产类资产查询复用现有接口公开REST + WebSocket

注意: Reality 行情接口暂时面向白名单用户开放,请联系您的 BD 进行申请。

行情数据

接口说明
获取交易产品信息rToken可以通过 isReality 字段识别。yes 表示 Reality 股票代币,no 表示非 Reality 股票代币
获取行情数据symbol传入rToken即可获取行情数据,如RMUUSDT
获取Reality深度数据获取融合(场内+场外)深度快照。需白名单权限
Reality深度频道订阅融合(场内+场外)深度数据。需白名单权限
获取Reality分层订单簿获取深度快照,各档位场内(内部)与场外(外部)数量分别展示。需白名单权限
Reality分层订单簿频道订阅分层深度数据(场内/场外数量分别展示)。需白名单权限
K线数据 / 历史k线数据获取 rToken K线数据
- 注:2026年7月9日之前的K线数据,volume/turnover可能为空
K线频道订阅 rToken K线数据
获取平台近期成交数据返回 rToken 交易对在场内(内部)成交的 Bitget 平台成交数据
最新成交频道美股休市时段,该频道同样会推送 rToken 交易对场内(内部)成交数据
获取Reality平台成交数据查询 rToken 近3个月最新的100条平台成交记录,覆盖开市与休市时段,需白名单权限

Reality(rToken)K线注意事项

  • rToken仅支持 market 类型K线。
  • rToken仅支持 1m、5m、15m、1H、4H、1D 时间粒度。
  • WebSocket K线频道的1m 粒度推送数据不包含 volume 和 turnover。

深度数据:融合深度与分层深度

获取Reality深度数据 / Reality深度频道 返回的是融合深度——将场内(Super Match 内部)与场外(外部券商)的流动性合并展示在同一档位视图中,不区分流动性来源。

获取Reality分层订单簿 / Reality分层订单簿频道 返回相同的价格档位,但会分别展示每个档位的场内与场外数量,让您能看出某个价位的深度中有多少来自场内、多少来自场外。

两个Websocket频道的推送频率一致:深度副本有变化则每 500ms 推送一次,无变化则每 10s 推送一次。

其他说明

开市时段(盘前/盘中/盘后),Bitget API/Websocket会返回/推送除了美股市场L2数据中的最优档位数据外,也会推送做市商的深度数据;而App/Web用户展示的订单簿会过滤掉未出现在美股市场 L2 数据中的最优档位,并对展示数量向下取整、按更粗的精度合并档位。
这只是面向Web/App的展示层行为——不影响 Super Match 实际可撮合的档位。

标准深度频道对 rToken 交易对的行为差异

除上述 rToken 专用接口外,标准深度频道对 rToken交易对的行为也有所不同:

频道/接口美股开市时段美股休市时段
WebSocket books1正常推送融合最优买卖价继续推送融合最优买卖价
WebSocket books5 / books50 / books不针对 rToken 交易对推送仅推送场内(内部)深度;无变化时每 10s 推送一次
REST 标准深度(orderbook)针对 rToken 交易对仅返回1档返回完整场内(内部)深度,最多至请求的档位数上限

成交数据覆盖范围

数据来源美股开市时段美股休市时段
最新成交频道(publicTrades)不支持 rToken 交易对推送场内(内部)成交
获取平台近期成交数据(fills)仅场内(内部)成交仅场内(内部)成交
获取Reality平台成交数据(需白名单)全量覆盖(场内+场外)全量覆盖(场内+场外)
私有快速成交频道覆盖您自己订单的场内与场外成交覆盖您自己订单的场内与场外成交

股票基础数据

以下接口用于查询 rToken(美股代币化交易对)底层股票的基础信息,均为公开接口,无需白名单权限。

接口说明
获取股票信息获取指定 rToken 交易对对应的美股股票信息
获取市场状态获取美股市场当前所处的交易时段状态(盘前/持续交易/盘后/夜盘)
获取休市日历获取美股市场的休市日历信息

交易下单

接口说明
创建Reality股票订单rToken 下单接口,限频默认为5次/秒/UID。白名单用户限频30次/秒/UID
撤销Reality股票订单rToken 撤单接口,限频默认为5次/秒/UID。白名单用户限频30次/秒/UID

注: 统一账户下单及撤单接口、WebSocket place-order/cancel-order 下单撤单频道现已支持 Reality 交易对,rToken 订单适用独立限频规则。
暂不支持改单。rToken 交易对暂不支持批量下单与批量撤单——如需调整挂单,请逐笔撤单后重新下单。

rToken 限价单交易规则

一、限制触发条件

系统将按统计周期监测单个 UID 在单个币对下的终态订单情况。若同时满足以下条件,将触发限价单功能限制:

  • 单个 UID、单个币对在统计周期内的终态订单总数超过 2,000 笔;
  • 成交率低于 10%。

成交订单:完全成交订单;
成交率 = 成交订单数 / 总订单数。

二、限制内容

触发上述条件后,该 UID 对应币对的现货限价单功能将被限制。
用户尝试提交限价单时,系统将提示:

Code
41121 异常交易,限价功能已限制。

三、自动解除机制

  • 若该 UID 在下一个统计周期内再次触发上述条件,限价单限制将继续生效;
  • 若在新的统计周期内未再次触发限制指标,系统将自动解除限制,限价单功能恢复正常;
  • 系统将在进入下一统计周期时(每日 04:00 UTC+8)重新进行计算和评估。

请用户合理使用限价单功能,避免高频、大量低成交率的异常挂单行为。感谢您的理解与支持。

资产

rToken 资产没有独立的资产查询接口,如需获取请复用现有的获取账户资产 接口查询。

最佳实践指南CFD 交易指南
On this page
  • 概述
  • 订单路由与撮合机制
    • 下单参数venue:选择订单可成交的范围
    • 挂单成交逻辑(盘中交易时段)
    • 美股其他交易时段(盘前/盘后/夜盘/周末/假期)
    • 流动性方向说明
  • 核心交易链路
  • 行情数据
    • 深度数据:融合深度与分层深度
    • 标准深度频道对 rToken 交易对的行为差异
    • 成交数据覆盖范围
  • 股票基础数据
  • 交易下单
    • rToken 限价单交易规则
  • 资产