> For the complete documentation index, see [llms.txt](https://bubblegum-reality.gitbook.io/bubblegum-reality-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bubblegum-reality.gitbook.io/bubblegum-reality-docs/readme.md).
# Bubblegum Reality
Bubblegum Reality is a non-custodial execution terminal for Robinhood Chain stock tokens: live reference pricing, transparent execution scoring, and wallet-signed swaps.
The reference image behind the design system: warm, filmic, slightly worn.
**Bubblegum Reality** is a full-stack web application that sits between the *quoted* value of a tokenized equity and the price you can actually execute at.
Live deployment:
It does three things and refuses to fake any of them:
1. **Discovers** the canonical Robinhood Stock Token registry on Robinhood Chain (chain ID `4663`).
2. **Prices** each token against its multiplier-adjusted underlying reference, then against real executable liquidity from the 0x Swap API.
3. **Executes** swaps non-custodially — exact-amount approvals, wallet-signed transactions, no custody, no simulated success states.
> **Not affiliated with Robinhood Markets, Inc.** Bubblegum Reality is an independent interface. It uses no Robinhood trademarks and holds no relationship with Robinhood. See [Independence & Disclaimers](/bubblegum-reality-docs/compliance/disclaimers.md).
## Why it exists
A tokenized stock has two prices that rarely agree:
| Price | What it is | Where it comes from |
| ------------------------ | ------------------------------------------ | ------------------------- |
| **Underlying reference** | Raw price of the underlying equity | Robinhood market data |
| **Token reference** | Underlying × `currentMultiplier` | Computed per asset |
| **Executable price** | What on-chain liquidity will actually fill | 0x Swap API, chain `4663` |
The gap between the last two is the part most interfaces hide. Bubblegum Reality quantifies it as the [Reality Score](/bubblegum-reality-docs/architecture/reality-score.md) and shows every input that produced it.
## Documentation map
| Section | Start here if you want to… |
| ------------------------------------------------------------------------ | ------------------------------------------------- |
| [Getting Started](/bubblegum-reality-docs/getting-started/quickstart.md) | Run the app locally |
| [Architecture](/bubblegum-reality-docs/architecture/overview.md) | Understand how the pieces fit |
| [Reference](/bubblegum-reality-docs/reference/server-functions.md) | Call the server functions or read the data shapes |
| [Operations](/bubblegum-reality-docs/operations/testing.md) | Test, deploy, and monitor |
| [Compliance](/bubblegum-reality-docs/compliance/eligibility.md) | Understand the gating and legal posture |
## Status
Shipped and live:
* Landing → wallet → terminal → live quote → wallet-signed swap
* `/markets` — full canonical registry (96 tokens) with search, live multiplier-adjusted quotes, spread and condition chips
* `/portfolio` — real batched balance reads, valuation and concentration metrics
* Cloud backend — full schema with RLS and grants on every table
* [Reality Check (AI)](/bubblegum-reality-docs/architecture/reality-check-ai.md) — bounded execution-condition analysis with cached verdicts
Still open: auth UI, alerts evaluator, trade-history writes. Tracked in [Roadmap](/bubblegum-reality-docs/operations/roadmap.md).
## Nothing here is advice
The Reality Score is a deterministic execution-quality metric, not a recommendation. Tokenized equities are debt-like instruments with issuer, protocol, and smart-contract risk. Read [Risk Disclosure](/bubblegum-reality-docs/compliance/risk-disclosure.md) before doing anything with real funds.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://bubblegum-reality.gitbook.io/bubblegum-reality-docs/readme.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
