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:
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 |
| Market Data | Stock Reference Data (stock info/market states/market calendar) | Reality-specific endpoint | Public | 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 | rToken can be identified via the isReality field. yes indicates a Reality stock token, no indicates a non-Reality stock token |
| Get Tickers | Pass an rToken symbol (e.g., RMUUSDT) to symbol to get its ticker data |
| Get Reality OrderBook | Get up to 40 levels of rToken order book depth snapshot. Requires whitelist access |
| Reality Orderbook Channel | Subscribe to up to 40 levels of rToken order book depth snapshot. Requires whitelist access |
| Get Kline/Candlestick / Get Kline/Candlestick History | Get rToken candlestick data - Note: For candlesticks before July 9, 2026, volume/turnover may be empty |
| Candlestick Channel | Subscribe to rToken candlestick data |
| Get Reality Fills | Query the latest 100 platform fill records for rToken from the last 3 months. Requires whitelist access |
Notes for Reality (rToken) candlesticks
- rToken only supports the
marketcandlestick type. - rToken only supports the
1m,5m,15m,1H,4H,1Dintervals. - For the WebSocket Candlestick Channel, the
1minterval push data does not includevolume/turnover.
Stock Reference Data
The following endpoints provide reference information about the underlying US stock for Reality (tokenized US stock) trading pairs. These are all public endpoints and do not require whitelist access.
| API | Description |
|---|---|
| Get Stock Info | Get the underlying US stock information for a specified rToken trading pair |
| Get Market States | Get the current US stock market trading session status (pre-market/regular/after-hours/overnight) |
| Get Market Calendar | Get the market holiday and closure calendar for US stocks |
Trading
| API | Description |
|---|---|
| Place Reality Order | rToken order placement endpoint. Default rate limit:5/sec/UID; whitelisted users:30/sec/UID |
| Cancel Reality Order | rToken order cancellation endpoint. Default rate limit:5/sec/UID; whitelisted users:30/sec/UID |
Note: The regular UTA Place Order and Cancel Order endpoints and the WebSocket place-order/cancel-order channels now support Reality trading pairs, subject to a separate rate limit for rToken orders.
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 endpoint to query them.