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

rToken 交易指南

概述

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

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

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

订单路由与撮合机制

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

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

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

venue 取值行为说明
不传(默认策略,订单详情返回 default)Super Match 优先在交易所内部比价撮合,未成交的部分再路由至外部券商(场外公开市场)。
针对部分周末可交易的币对,仍挂在场外未成交的挂单会被转回场内挂单,如果周末仍未成交,会转到场外继续挂单;
internal_market订单只会在 Super Match Bitget内部撮合,不会提交至美股券商,不受开市/休市切换的影响,也不参与周末/周一开市前对挂单的批量重路由
lit_market订单直接提交至美股券商执行,不在交易所内(Super Match)撮合

下单时可传入的 venue 取值为 internal_market 或 lit_market,不传即为默认策略;订单详情(REST 订单查询及 WebSocket 订单推送)返回的 venue 为 default / internal_market / lit_market 之一。

venue 枚举调整(2026 年 11 月 5 日起生效)

  • 原 internalization 更名为 internal_market,含义不变,请将该枚举值替换为 internal_market。
  • 订单详情中原本展示为 lit_market 的订单(优先场内比价撮合、未成交部分提交至券商),调整后展示为 default,请同步更新订单详情的解析逻辑。
  • 新的 lit_market 含义为"订单提交至券商执行,不在交易所内撮合",与调整前订单详情中的 lit_market 含义不同,请注意区分。

一般使用建议:

  • 若您希望订单流完全保留在 Super Match 内部(如报价/做市场景),使用 internal_market。
  • 若您希望优先在场内比价撮合、未成交的部分也能到达外部券商(如建仓或减仓),不传 venue(默认策略)。
  • 若您希望订单直接提交至美股券商执行、不参与场内撮合,使用 lit_market。

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

暂不支持改单

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

挂单成交逻辑(美股交易时段)

  • 默认策略(不传 venue,订单详情返回 default)

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

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

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

  • venue= internal_market

订单只会在 Super Match Bitget内部撮合,不会路由至外部券商,不受开市/休市切换的影响,也不参与周末/周一开市前对挂单的批量重路由,不受NBBO价格带限制

  • venue= lit_market

订单直接提交至美股券商执行,不在交易所内(Super Match)撮合,不参与场内价格带比价。

吃单成交逻辑(美股交易时段)

  • 默认策略(不传 venue,订单详情返回 default)

当您的订单作为吃单方进入 Super Match 时,系统会先比价,再决定场内撮合与路由至场外的数量:

  1. 比价:Super Match 取场外报价(含 ΔP)与场内最优档位中更优的一方作为最优价:

    • 最优卖价 = MIN(NBO + ΔP, 场内卖一价)
    • 最优买价 = MAX(NBB − ΔP, 场内买一价)

    买单价格 ≥ 最优卖价,或卖单价格 ≤ 最优买价时,订单进入场内撮合。

  2. 场内撮合:订单按价格优先逐档吃掉价格带内的场内挂单——买单最多吃到 NBO + ΔP,卖单最多吃到 NBB − ΔP。成交价为对手方的挂单价格。

  3. 剩余路由:价格带内的场内流动性耗尽后,剩余部分路由至外部券商(受 venue 约束,internal_market 订单不会路由至场外)。若剩余待路由部分的金额不足 2 美元,订单直接进入终态,不再提交至外部券商。

市价单在内部会转换为有效期 2 秒的限价单,限价 = 最新成交价 ×(1 ± 滑点(最大1%)),2 秒后未成交部分自动撤销。

示例:用户市价买入 2.5 股 TSLA,最新价 100 USD、滑点 1%,即以 101 USD 限价进入 Super Match。假设当前 NBO = 100 USD、ΔP = 0.5 USD,场内卖一为 99.8 USD × 1.2 股:

  • 比价:最优卖价 = MIN(100.5, 99.8) = 99.8 USD,买入价 101 ≥ 99.8,进入场内撮合;
  • 场内撮合:99.8 USD 的 1.2 股低于 NBO + ΔP = 100.5,全部成交,成交价 99.8 USD;场内无更多带内挂单,撮合结束;
  • 剩余路由:剩余 1.3 股( ≥ 2 美元)路由至外部券商成交。

最终该订单场内成交 1.2 股、场外成交 1.3 股,订单全部成交。

  • venue= internal_market

订单只会在 Super Match Bitget内部撮合,不会路由至外部券商,不受开市/休市切换的影响,也不参与周末/周一开市前对挂单的批量重路由,不受NBBO价格带限制

  • venue= lit_market

订单直接提交至美股券商执行,不在交易所内(Super Match)撮合,不参与场内价格带比价。

美股其他交易时段

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

流动性方向说明

  • 仅 internal_market 挂单中被动在 Super Match 内部撮合的部分记为 Maker;其余所有成交——包括默认策略(default)与 lit_market 订单的全部成交,以及 internal_market 订单中主动吃单的部分——均记为 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 下单接口。限频按 venue 区分:internal_market(场内)按 Crypto 限频 10次/秒/UID;默认策略(不传 venue)及 lit_market(场外)默认5次/秒/UID,白名单用户30次/秒/UID
撤销Reality股票订单rToken 撤单接口,限频规则与 Crypto 一致

注: 统一账户下单及撤单接口、WebSocket place-order/cancel-order 下单撤单频道现已支持 Reality 交易对。下单限频按 venue 区分(场内按 Crypto 限频,场外按 rToken 限频);撤单限频规则与 Crypto 一致。
暂不支持改单。rToken 交易对暂不支持批量下单与批量撤单——如需调整挂单,请逐笔撤单后重新下单。

rToken 限价单交易规则

适用范围

仅限场外交易,场内交易不受此限制。

一、限制触发条件

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

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

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

二、限制内容

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

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

三、自动解除机制

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

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

交易策略与应用场景

Delta 中性模式(Delta Neutral Mode)

功能介绍及适用场景

Delta 中性模式是统一账户「进阶模式」交易设置中的一个功能开关,面向在统一账户下运行资金费率套利、基差套利等对冲策略的交易者。开启后,符合条件的对冲仓位在自动减仓(ADL)队列中的排名会整体后移——只有当所有不符合条件的仓位都已处理后,才会轮到对冲仓位,从而降低极端行情下对冲仓位被自动减仓、导致策略"断腿"的概率。该模式只影响 ADL 排序优先级,不改变保证金计算、强平规则或风控政策。

Delta 中性模式已支持将 rToken 与其底层股票视为同一资产进行对冲计算。例如 rAAPL 与 AAPL 将被统一计算:用户持有的 rAAPL 现货与 AAPLUSDT 合约仓位可以形成对冲仓位,共同参与对冲判定与 ADL 排名保护。该扩展在满足条件后自动生效,无需额外设置。这意味着用户可以用"真实股票价格"的 rToken 现货作为多头腿,用流动性充足的股票永续合约作为空头腿,在同一个 UTA 内完成对冲,并且现货持仓本身还能继续作为合约保证金使用。

典型适用场景包括:持有 rToken 现货、希望通过做空同标的合约收取正资金费率的资金费率套利;当合约价格相对 rToken 现货出现溢价时,买现货、空合约等待价差收敛的基差套利;以及长期持有美股敞口、但在财报或宏观事件前希望临时锁定价格风险的持仓保护。

开启条件

身份条件: 点击开启时需满足任一身份——VIP3 及以上 / Pro 用户 / 做市商 / 机构借贷用户。身份校验仅在开启时触发一次,之后身份变化不影响已开启状态;模拟盘不受身份限制。

rToken 额外条件: 对应的 rToken 必须是 UTA 支持的保证金币种,rToken 当前支持作为 UTA 保证金的币种名单,请参考 币种抵押率 | Bitget 统一交易账户。

开启方法及详细介绍可参考: 统一账户中的 Delta 中性模式如何运作?

标的资产映射(Underlying Asset Mapping)

rToken 与底层股票、现货及合约交易对的对应关系

每个 rToken 由 Reality 协议发行,背后对应持牌经纪商处 1:1 托管的真实美股或 ETF。在 Bitget 上,同一只底层股票可能同时存在 rToken 现货交易对和 U 本位股票永续合约两种交易工具,命名规则如下:

工具命名规则示例(Apple)API 识别方式
Bitget Spot 交易对R + 股票代码 + USDTRAAPLUSDT获取交易产品信息(category=SPOT)中 isReality = yes
Bitget Futures 交易对股票代码 + USDTAAPLUSDT获取交易产品信息(category=USDT-FUTURES)中 instrumentType = stock / etf

不同资产之间的 Mapping 关系及适用范围

Delta 中性模式下,以下几组币种会被视为同一资产统一计算:rToken 与其底层股票合约(如 rAAPL 与 AAPL)、BGBTC 与 BTC、BGSOL 与 SOL,以及 XAU、XAUT 与 PAXG。

需要注意适用边界:对冲只在"同一标的"内成立,不同资产之间不能互相对冲。例如用 rQQQ 对冲 NVDAUSDT 空单、用杠杆 ETF rTSLL(Direxion 2 倍做多 TSLA)对冲 TSLAUSDT,都不会被认定为对冲仓位,因为它们的底层资产并不相同。此外,持有大量稳定币或其他资产也不能对冲某一资产的合约仓位;逐仓合约不参与计算;rToken 本身必须在 UTA 保证金币种名单内。

实际交易案例

以下案例中的价格、资金费率均为示意数值,仅用于说明计算方式,实际请以盘口、资金费率及费率等级为准。

案例一:rNVDA + NVDAUSDT 资金费率套利

背景: 用户为 VIP3 机构客户,UTA 进阶模式已开启 Delta 中性开关,账户内有 10,000 USDT。观察到 NVDAUSDT 资金费率持续为正,希望在不承担 NVDA 价格方向风险的情况下收取资金费。

操作步骤:

  1. 美股盘中,以限价单买入 rNVDA,假设成交 50 股、成交均价 200 USDT,名义价值 10,000 USDT(API:创建Reality股票订单,或统一账户下单接口 category=SPOT、symbol=RNVDAUSDT;如需未成交部分路由至美股市场,不传 venue 使用默认策略);
  2. 确认现货腿实际成交 50 股后,在同一 UTA 内以全仓模式做空 50 NVDA 数量的 NVDAUSDT 永续合约(API:统一账户下单接口 category=USDT-FUTURES);
  3. 此时 rNVDA 持仓 50、合约净持仓 −50,方向相反且数量相等,合约净仓位 = 0,比例 0% ≤ 5%,判定为对冲仓位,享受 ADL 排名保护;
  4. 持有期间,股票合约每 8 小时结算一次资金费,资金费率为正时空头收取资金费。

案例二:部分成交导致比例超限与再平衡

背景: 沿用案例一的账户。用户先下了 53 NVDA 数量的合约空单,但 rNVDA 限价买单只成交了 50 股,剩余部分未成交。

判定过程: rNVDA 持仓 50,合约净持仓 −53,方向相反且 |50| < |−53|,合约净仓位 = |50 − 53| = 3;总仓位 = MAX[50 + 0, |0 − 53|] = 53;比例 = 3 ÷ 53 ≈ 5.66% > 5%,不满足对冲条件,该资产按普通规则参与 ADL 排序。

处理方式: 补买至少 1 股 rNVDA,使比例降至 2 ÷ 53 ≈ 3.77%;或减空合约至 52 以内。系统在比例回落后自动恢复对冲仓位判定,无需重新开启开关。实践中建议"先现货、后合约",并以现货腿的实际成交数量驱动合约下单,同时用私有成交频道实时监听两腿成交。注意 rToken 暂不支持改单,调价需撤单后重新下单。

案例三:rTSLA + TSLAUSDT 基差套利

背景: 市场情绪亢奋时,TSLAUSDT 永续合约价格相对 rTSLA 现货出现溢价。假设 rTSLA 现货价格 400 USDT,TSLAUSDT 合约价格 404 USDT,溢价约 1%。

操作步骤: 买入 20 股 rTSLA(约 8,000 USDT),同时做空 20 TSLA 数量的 TSLAUSDT(约 8,080 USDT),组合比例为 0%,判定为对冲仓位。当合约溢价收敛至 0 时,同时平掉两腿:无论 TSLA 价格涨跌,组合锁定的价差收益约为 20 × 4 = 80 USDT(约 1%),持有期间若资金费率为正,空头还可额外收取资金费。

需要关注: 开市时段 rTSLA 的成交价与美股同步,价差主要来自合约侧的溢价,执行时可通过 Reality分层订单簿评估场内外深度;美股休市时段 rToken 依靠 Super Match 场内流动性定价,订单受「参考价 × 休市期间价格偏离限制(当前 20%)」保护,深度更薄,不建议在休市时段大额建仓或平仓。若对手腿出现大幅滑点,可能侵蚀全部基差收益。

资产

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

最佳实践指南CFD 交易指南
On this page
  • 概述
  • 订单路由与撮合机制
    • 下单参数venue:选择订单可成交的范围
    • 挂单成交逻辑(美股交易时段)
    • 吃单成交逻辑(美股交易时段)
    • 美股其他交易时段
    • 流动性方向说明
  • 核心交易链路
  • 行情数据
    • 深度数据:融合深度与分层深度
    • 标准深度频道对 rToken 交易对的行为差异
    • 成交数据覆盖范围
  • 股票基础数据
  • 交易下单
    • rToken 限价单交易规则
  • 交易策略与应用场景
    • Delta 中性模式(Delta Neutral Mode)
    • 标的资产映射(Underlying Asset Mapping)
    • 实际交易案例
  • 资产