Methodology

Robinhood Stock Tokens trade onchain in Uniswap pools against USDG. Gapwatch asks one question per token: is the pool price close to what the stock is worth right now?

Premium = (pool price − reference price) ÷ reference price, in percent. A positive premium means the token is trading above its reference; a negative one, below. Within ±1% is shown as “in line”, 1–5% as elevated, above 5% as a large gap. Every premium says which reference it used.

Gapwatch also shows 2% depth (how much money moves the pool price 2%), the US market session and the issuer's mint window, and checks whether a contract address is an official Robinhood Stock Token.

• Official token list: Robinhood's own Stock Token API, /rhj/assets (opens in a new tab) (documented at docs.robinhood.com (opens in a new tab)). Today it lists 195 tokens. Only an address in this list counts as official.
• Pool price: read onchain from the token's main USDG pool on Uniswap (v3 slot0(), or hookless v4 through the official StateView (opens in a new tab) contract). The main pool is the one holding the most USDG, chosen from the official Uniswap factories and reviewed by hand. 60 of 195 tokens have one today.
• Chainlink reference (preferred, 25 tokens): the Chainlink tokenized-equity feed for that token, read onchain with latestRoundData(). Feeds come from Chainlink's directory (opens in a new tab) and are matched to a token only on exact documented fields. The feed already includes the token's share multiplier.
• Robinhood quote (every other token): the midpoint of the token bid and ask from /rhj/prices/<symbol> (opens in a new tab), already adjusted for the multiplier. On Chainlink tokens, the token page also shows it as a cross-check.
• Chain: Robinhood Chain mainnet only (chain ID 4663). Every read checks the chain ID and fails loudly on any other network. Every number links to its contract on the Blockscout explorer (opens in a new tab).

• LIVE: read successfully and recent enough. Prices refresh every 30 seconds (depth every 5 minutes).
• STALE: there is a value, but it may be out of date, and the reason is always shown. A Chainlink feed is stale when its last update is older than its 24-hour heartbeat plus 1 hour while the market is trading, or when the token's oracle is paused for a corporate action. A Robinhood quote is stale when it is more than 2 minutes old, or during a trading halt. A pool price is stale when the issuer has paused the token.
• UNAVAILABLE: the value couldn't be read. Gapwatch shows why and never fills the gap with a guess.
• Weekends: when the US market is closed, Chainlink feeds hold their last published price by design. Gapwatch shows it as the last published price with its time (for example “Fri 20:00 UTC”), so a weekend premium compares against the last close.

Buy depth is the USDG you would pay to push the pool price up 2%. Sell depth is the USDG you would receive when selling enough tokens to push it down 2%. If either side is under $5,000, the pool is marked thin: small trades can move its price a lot, so a large premium there means less.

• Uniswap v3 pools: simulated with the official QuoterV2 (opens in a new tab) contract (a read-only call; no trade is ever sent). A search finds the trade size that moves the price 2%.
• Uniswap v4 pools (10 today): the v4 quoter doesn't report the price after a trade, so depth is an estimate from the pool's active liquidity, marked with ≈.

Paste an address on Check a token. Gapwatch compares it with Robinhood's live list (cached 10 minutes; a saved copy is used, and clearly labelled, if the live list is down), then reads the contract's own symbol(), name() and decimals(). A matching name or symbol proves nothing; only the contract address does.

• Official: the address is in Robinhood's list.
• Impersonation (strong signal): not in the list, but its name copies an official Robinhood token's name, or contains “Robinhood”. Gapwatch shows the real official address next to it.
• Similar symbol, different issuer (neutral): not in the list, and its symbol resembles an official one (for example TSLAx), but it doesn't claim to be Robinhood's. It may be a legitimate token from another issuer; Gapwatch only verifies Robinhood's tokens.
• Not an official Stock Token, Not a token contract (a wallet, or a contract that isn't an ERC-20), or Can't tell right now (the contract couldn't be read).

• Only USDG pools on Uniswap v3 and hookless v4 are covered. Pools with custom hooks, other DEXs and other quote tokens are not.
• US market holidays and early closes are not included: on those days the session shows the normal weekday schedule.
• Prices refresh every 30 seconds, so a fast move can take that long to show.
• v4 depth is an estimate (≈), not a simulated trade.
• Tokens Robinhood adds after the last pool-list refresh don't get a token page until the list is refreshed. The checker still recognises them, because it uses the live list.

Not financial advice. Gapwatch describes prices; it doesn't recommend any trade. It is read-only: no wallets, no transactions.

Free, read-only JSON for bots and AI agents. No key needed. Every response comes from the same cached snapshot as the website, so calling the API never triggers extra chain reads.

• GET /api/fair-price/<symbol>: one official token (symbol is case-insensitive). Unknown symbols return 404.
• GET /api/board: every token with an active USDG pool, plus coverage counts.
• GET /api/check/<address>: the official-check verdict (official, impersonation, similar-symbol, not-official, not-token or unknown), with the matched official token, explorer links and which list was used.

curl https://gapwatch.xyz/api/fair-price/NVDA

Example response (shortened):

{
  "symbol": "NVDA",
  "name": "NVIDIA • Robinhood Token",
  "tokenAddress": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
  "official": true,
  "chainId": 4663,
  "hasPool": true,
  "poolPrice": {
    "usd": "217.27", "status": "LIVE", "reason": null,
    "source": { "label": "Uniswap v3 NVDA/USDG 0.05% pool", "url": "…" },
    "pool": { "version": "v3", "id": "0xd4EB…14a3", "feeTier": 500, "feePct": "0.05%", … },
    "observedAt": "2026-10-20T06:00:00.000Z", "blockNumber": 93197907
  },
  "reference": {
    "usd": "218.18", "kind": "chainlink", "status": "LIVE", "reason": null,
    "label": "Chainlink feed, updated 3h ago", "source": { … },
    "feedAddress": "0x379E…9F15", "updatedAt": "2026-10-20T03:00:00.000Z"
  },
  "premiumPct": {
    "value": "-0.42", "status": "LIVE", "reason": null,
    "description": "0.42% below reference",
    "summary": "NVDA token is trading in line with its Chainlink reference (0.42% below)."
  },
  "depth": {
    "buyUsd": "371052.77", "sellUsd": "402114.10", "method": "quoter",
    "thin": false, "thinThresholdUsd": "5000", "status": "LIVE", "reason": null,
    "measuredAt": "…"
  },
  "market": { "usSession": "after-hours", "mintWindowOpen": true, "nextMintWindowChangeAt": "…" },
  "snapshot": { "blockNumber": 93197907, "generatedAt": "2026-10-20T06:00:01.000Z" },
  "disclaimer": "Read-only market data. Not financial advice."
}

• Numbers are strings (exact decimals, for example "217.27"), never floating-point numbers.
• Every value has a status (LIVE, STALE, UNAVAILABLE) and a reason (null when there's nothing to explain). A value that couldn't be read is null with status UNAVAILABLE.
• Errors always look like { "error": { "code": "not_found", "message": "…" } }. Codes: invalid_symbol, invalid_address (400), not_found (404), rate_limited (429), upstream_unavailable (503), internal_error (500).
• Caching: prices and the board are cached 30 seconds; checks 5 minutes.
• Rate limit: 60 requests per minute per IP. Above that you get 429 with a Retry-After header. The limit is counted per server instance, so treat it as a courtesy limit, not an exact quota.
• CORS: GET is allowed from any origin, so browser apps can call it directly.

Gapwatch is also an MCP server (Model Context Protocol, the standard way AI assistants connect to tools). Connect it to Claude or any MCP client and ask in plain language, for example “What's the NVDA premium on Gapwatch?”. It is read-only, needs no key, and answers from the same cached data as this site.

https://gapwatch.xyz/api/mcp

• get_fair_price: one token's pool price, reference, premium, 2% depth and statuses (by ticker, for example NVDA).
• get_market_board: a compact list of every token with a pool, sorted by largest gap or symbol, optionally only thin pools or large_gap tokens (more than 5% from the reference).
• check_token: is this contract address an official Robinhood Stock Token (official, impersonation, similar symbol…)?

Claude Code:

claude mcp add --transport http gapwatch https://gapwatch.xyz/api/mcp

Other MCP clients (Streamable HTTP):

{
  "mcpServers": {
    "gapwatch": { "type": "http", "url": "https://gapwatch.xyz/api/mcp" }
  }
}

Same rules as the API: 60 requests per minute per IP (shared with the JSON API, counted per server instance), every value has a status and a reason, and every answer says it is not financial advice. A plain-text summary for AI tools is at /llms.txt.

A public Telegram channel (t.me/gapwatch_alerts (opens in a new tab)) posts when a token trades far from its reference and when it comes back. It checks every 5 minutes, so an alert can lag a move by up to about 10 minutes.

• Gap alert: the premium is more than 5% (above or below) on 2 checks in a row, so one-off spikes are ignored.
• Back in line: the premium is back within 3% on 2 checks in a row. The lower exit level stops a token hovering around 5% from posting over and over.
• Only LIVE data counts. Stale or unavailable prices never trigger or clear an alert.
• At most one gap alert per token every 6 hours. If more than a quarter of all tokens jump past 5% at once, it is treated as a data problem and nothing is posted. Several alerts at once are combined into one message.
• Thin pools are not alerted (under $5,000 moves the price 2% on either side, or depth not measured yet): their gaps come and go with tiny trades. They still appear on the website with a thin-pool warning.
• Each alert shows the pool price, the reference and which one it is, 2% depth, and a note when the US market is closed (the reference is then the last published price).

Alerts describe prices; they are not financial advice and not a signal to trade.