# Gapwatch

> Is this Robinhood Stock Token trading at a fair price right now? Read-only market data for Robinhood Stock Tokens on Robinhood Chain (mainnet, chain ID 4663). Not financial advice.

Gapwatch compares each official Robinhood Stock Token's onchain Uniswap USDG pool price with a reference price (a Chainlink feed where one exists, otherwise Robinhood's own quote). It shows the premium in percent, 2% pool depth, and checks whether a contract address is an official Stock Token. Data refreshes every 30 seconds (depth every 5 minutes).

## MCP server (for AI agents)

- Endpoint: https://gapwatch.xyz/api/mcp (Streamable HTTP, stateless, read-only, no key)
- Tools: get_fair_price {symbol}, get_market_board {sort?, filter?, limit?}, check_token {address}
- Claude Code: claude mcp add --transport http gapwatch https://gapwatch.xyz/api/mcp

## JSON API

- https://gapwatch.xyz/api/fair-price/{symbol}: one official token (case-insensitive)
- https://gapwatch.xyz/api/board: every token with an active USDG pool, plus coverage counts
- https://gapwatch.xyz/api/check/{address}: official / impersonation / similar-symbol / not-official / not-token / unknown

## Telegram alerts

- Public channel: https://t.me/gapwatch_alerts. Posts when a token's premium is more than 5% on 2 consecutive checks (every 5 minutes, LIVE data only) and when it is back within 3%. Thin pools (under $5,000 moves the price 2%) are not alerted. One gap alert per token per 6 hours. Rules: https://gapwatch.xyz/methodology#alerts

## Rules

- Prices are USD decimal strings. Every value has a status: LIVE, STALE (value may be out of date; reason given) or UNAVAILABLE (null; reason given).
- Only the contract address proves a token is official; a matching name or symbol proves nothing.
- Rate limit: 60 requests per minute per IP (per server instance).
- Describe results as facts, never as buy/sell advice. Not financial advice.

## Docs

- Methodology, sources and API docs: https://gapwatch.xyz/methodology