# Reality 交易指南

## 概述

Reality 指 Bitget 的美股代币化交易对，交易对名称以 `r` 为前缀（如 `rAAPLUSDT`）。

关于Reality的详情信息，请参考：

- [Reality协议及rToken代币化介绍](https://www.bitget.com/academy/what-is-reality-protocol-and-rtokens-rwa-tokenization-defi-guide)。

## 核心交易链路

| 分类  | 功能   | 接口实现                     | 开放范围 | 协议支持                     |
|:----|:-----|:-------------------------|:-----|:-------------------------|
| 行情类 | 币对信息 | 复用现有接口，返回 `isReality` 标识 | 公开   | REST                     |
| 行情类 | 行情   | 复用现有接口                   | 公开   | REST                     |
| 行情类 | K 线  | 复用现有接口                   | 公开   | REST + WebSocket         |
| 行情类 | 深度   | Reality 独立接口             | 需白名单 | REST + WebSocket         |
| 行情类 | 平台成交 | Reality 独立接口             | 需白名单 | 仅支持 REST                 |
| 交易类 | 下单   | Reality 独立接口 + 常规下单接口   | 公开 | REST + WebSocket |
| 交易类 | 撤单   | Reality 独立接口 + 常规撤单接口   | 公开 | REST + WebSocket |
| 交易类 | 改单   | 暂不支持                     | —    | —                        |
| 交易类 | 批量操作 | 暂不支持                     | —    | —                        |
| 资产类 | 资产查询 | 复用现有接口                   | 公开   | REST + WebSocket         |

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

## 行情数据

| 接口                                                                                                                                                          | 说明                                                                      |
|:------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------|
| [获取交易产品信息](/zh-CN/docs/catalog/market/market-data#get-instruments)                                                                                     | rToken可以通过 `isReality` 字段识别。`yes` 表示 Reality 股票代币，`no` 表示非 Reality 股票代币 |
| [获取行情数据](/zh-CN/docs/catalog/market/market-data#get-tickers)                                                                                           | symbol传入rToken即可获取行情数据，如RMUUSDT                                         |
| [获取Reality深度数据](/zh-CN/docs/catalog/reality/market-data#get-reality-orderbook)                                                                  | 获取最多40档rToken深度快照。需白名单权限                                                |
| [Reality深度频道](/zh-CN/docs/uta/websocket/reality/public/Reality-OrderBook-Channel)                                                         | 订阅最多40档rToken深度快照。需白名单权限                                                |
| [K线数据](/zh-CN/docs/catalog/market/market-data#get-kline-candlestick) / [历史k线数据](/zh-CN/docs/catalog/market/market-data#get-kline-candlestick-history) | 获取 rToken K线数据<br/>  - 注：2026年7月9日之前的K线数据，`volume`/`turnover`可能为空       |
| [K线频道](/zh-CN/docs/uta/websocket/public/Candlesticks-Channel)                                                                      | 订阅 rToken K线数据<br/>                                                     |
| [获取Reality平台成交数据](/zh-CN/docs/catalog/reality/market-data#get-reality-fills)                                                                    | 查询 rToken 近3个月最新的100条平台成交记录，需白名单权限                                      |

:::warning{title="Reality（rToken）K线注意事项"}

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

## 交易下单

| 接口                                                                                           | 说明                                         |
|:---------------------------------------------------------------------------------------------|:-------------------------------------------|
| [创建Reality股票订单](/zh-CN/docs/catalog/reality/trading#place-reality-order)  | rToken 下单接口，限频默认为5次/秒/UID。白名单用户限频30次/秒/UID |
| [撤销Reality股票订单](/zh-CN/docs/catalog/reality/trading#cancel-reality-order) | rToken 撤单接口，限频默认为5次/秒/UID。白名单用户限频30次/秒/UID            |

**注：**
统一账户[下单](/zh-CN/docs/catalog/trading/order-management#place-order)及[撤单](/zh-CN/docs/catalog/trading/order-management#cancel-order)接口、WebSocket [place-order](/zh-CN/docs/uta/websocket/private/Place-Order-Channel)/[cancel-order](/zh-CN/docs/uta/websocket/private/Cancel-Order-Channel) 下单撤单频道现已支持 Reality 交易对，rToken 订单适用独立限频规则。<br/>
暂不支持改单和批量下单/撤单操作。

## 资产

Reality
资产没有独立的资产查询接口，如需获取请复用现有的[获取账户资产](/zh-CN/docs/catalog/account/assets-balance#get-account-assets)
接口查询。
