# Reality Trading Guide

## Overview

Reality refers to Bitget's tokenized US stock trading pairs, identified by symbols prefixed with `r` (e.g.,
`rAAPLUSDT`).

For more details about Reality, please refer to:

- [Introduction to the Reality Protocol and rToken Tokenization](https://www.bitget.com/academy/what-is-reality-protocol-and-rtokens-rwa-tokenization-defi-guide).

## Core Trading Capabilities

| Category    | Function          | Implementation                                     | Access             | Protocol Support                        |
|:------------|:------------------|:---------------------------------------------------|:-------------------|:----------------------------------------|
| Market Data | Instruments       | Reused existing endpoint, returns `isReality` flag | Public             | REST                                    |
| Market Data | Ticker            | Reused existing endpoint                           | Public             | REST                                    |
| Market Data | Candlesticks      | Reused existing endpoint                           | Public             | REST + WebSocket                        |
| Market Data | OrderBook (Depth) | Reality-specific endpoint                          | Whitelist required | REST + WebSocket                        |
| Market Data | Platform Fills    | Reality-specific endpoint                          | Whitelist required | REST only                               |
| Trading     | Place Order       | Reality-specific endpoint + regular UTA place-order endpoint | Public | REST + WebSocket |
| Trading     | Cancel Order      | Reality-specific endpoint + regular UTA cancel-order endpoint | Public | REST + WebSocket |
| Trading     | Modify Order      | Not supported yet                                  | —                  | —                                       |
| Trading     | Batch Operations  | Not supported yet                                  | —                  | —                                       |
| Assets      | Asset Balances    | Reused existing endpoint                           | Public             | REST + WebSocket                        |

**Note:** Reality market data endpoints are currently only open to whitelisted users. Please contact your BD to apply.

## Market Data

| API                                                                                                                                                                                     | Description                                                                                                                         |
|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------|
| [Get Instruments](/docs/catalog/market/market-data#get-instruments)                                                                                                                | rToken can be identified via the `isReality` field. `yes` indicates a Reality stock token, `no` indicates a non-Reality stock token |
| [Get Tickers](/docs/catalog/market/market-data#get-tickers)                                                                                                                        | Pass an rToken symbol (e.g., `RMUUSDT`) to `symbol` to get its ticker data                                                          |
| [Get Reality OrderBook](/docs/catalog/reality/market-data#get-reality-orderbook)                                                                                            | Get up to 40 levels of rToken order book depth snapshot. Requires whitelist access                                                  |
| [Reality Orderbook Channel](/docs/uta/websocket/reality/public/Reality-OrderBook-Channel)                                                                             | Subscribe to up to 40 levels of rToken order book depth snapshot. Requires whitelist access                                         |
| [Get Kline/Candlestick](/docs/catalog/market/market-data#get-kline-candlestick) / [Get Kline/Candlestick History](/docs/catalog/market/market-data#get-kline-candlestick-history) | Get rToken candlestick data<br/>  - Note: For candlesticks before July 9, 2026, `volume`/`turnover` may be empty                    |
| [Candlestick Channel](/docs/uta/websocket/public/Candlesticks-Channel)                                                                                         | Subscribe to rToken candlestick data<br/>                                                                                           |
| [Get Reality Fills](/docs/catalog/reality/market-data#get-reality-fills)                                                                                                    | Query the latest 100 platform fill records for rToken from the last 3 months. Requires whitelist access                             |

:::warning{title="Notes for Reality (rToken) candlesticks"}

- rToken only supports the `market` candlestick type.
- rToken only supports the `1m`, `5m`, `15m`, `1H`, `4H`, `1D` intervals.
- For the WebSocket Candlestick Channel, the `1m` interval push data does not include `volume`/`turnover`.
:::

## Trading

| API                                                                                           | Description                                                                                    |
|:----------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------|
| [Place Reality Order](/docs/catalog/reality/trading#place-reality-order)   | rToken order placement endpoint. Default rate limit:5/sec/UID; whitelisted users:30/sec/UID    |
| [Cancel Reality Order](/docs/catalog/reality/trading#cancel-reality-order) | rToken order cancellation endpoint. Default rate limit:5/sec/UID; whitelisted users:30/sec/UID |

**Note:** The regular UTA [Place Order](/docs/catalog/trading/order-management#place-order) and [Cancel Order](/docs/catalog/trading/order-management#cancel-order) endpoints and the WebSocket [place-order](/docs/uta/websocket/private/Place-Order-Channel)/[cancel-order](/docs/uta/websocket/private/Cancel-Order-Channel) channels now support Reality trading pairs, subject to a separate rate limit for rToken orders.<br/>
Order modification and batch order/cancel operations are not supported yet.

## Assets

Reality assets have no dedicated asset query endpoint — reuse the
existing [Get Account Assets](/docs/catalog/account/assets-balance#get-account-assets) endpoint to query them.