Off-Switch Index / public read-only API

Route
API

Pool discovery and executable quote simulations for any Robinhood Chain token. Built for agents, bots, scripts, and humans who prefer JSON.

GET https://www.hoodbuybutton.com/api/v1/routes

Quickstart

The default response is compact. Token amounts remain decimal strings so clients do not lose precision.

curl --get 'https://www.hoodbuybutton.com/api/v1/routes' \
  --data-urlencode 'token=0x020bfC650A365f8BB26819deAAbF3E21291018b4' \
  --data-urlencode 'amount=100' \
  --data-urlencode 'limit=6' \
  -H 'Accept: application/json'

Agent Connection

Buy Button Route Intelligence is a public, stateless Streamable HTTP MCP. It gives agents four read-only tools for resolving community contracts, listing the curated registry, quoting one token, and comparing routes across the board.

codex mcp add buy-button-routes \
  --url https://www.hoodbuybutton.com/mcp

claude mcp add buy-button-routes \
  --transport http https://www.hoodbuybutton.com/mcp

It can run beside the Robinhood Trading MCP. The two services remain independent: this server supplies public Robinhood Chain route evidence and never authenticates to Robinhood, reads a brokerage account, or places an order.

Machine metadata is published in the MCP server manifest. The endpoint requires no API key.

Parameters

ParameterAcceptedPurpose

tokenERC-20 address

Contract to map. Defaults to BUY.

amount$1–$100,000

USD size for the read-only simulation.

limit1–20

Ranked pools inspected and returned. Defaults to 6.

viewcompact / full

Compact is stable and token-efficient. Full exposes raw evidence.

Response Contract

bestRoute

Highest executable output for the requested USD size.

routes[]

Ranked direct pools with market data, exact quote strings, and execution links.

market.truncated

True when more pools were detected than returned under the requested limit.

warnings[]

Safety and interpretation constraints that clients should retain.

Discovery

Every API response exposes typed HTTP Link headers for the catalog, OpenAPI description, JSON Schema, documentation, and health endpoint. The domain also publishes an RFC 9727 catalog at:

GET /.well-known/api-catalog
Accept: application/linkset+json

Errors and Safety

Invalid requests and upstream failures use application/problem+json. Invalid query values include an invalidParams[] entry naming the field and reason. Successful quotes are estimates, not transactions. This API never requests a wallet connection, signature, approval, or private key. Pool discovery is not a token-security audit.

The endpoint is public and cached. Use conditional requests with If-None-Match, honor cache headers, and avoid polling faster than the 20-second cache window.

Embeddable Route State

Community pages expose two cache-aware, read-only surfaces backed by this API. The iframe compares executable routes for the selected size. The SVG endpoint is suitable for READMEs, dashboards, and project sites.

<iframe src="https://www.hoodbuybutton.com/embed/?token=0x...&amount=100&theme=dark"></iframe>

GET /api/v1/badge?token=0x...&amount=100

The live directory and its public contract registry are available at /directory/ and /directory/tokens.json. Listings are free; payment cannot affect order.

Live BUY Pulse Feed

BUY Pulse translates indexed buys into a chain-native activity feed. Rolling 5-minute, 1-hour, 6-hour, and 24-hour buy counts are grouped by the curated community registry. Twelve exact five-minute history buckets compare communities over the last hour, while the live scan exposes masked transaction senders and explorer-linked receipts.

GET /api/v1/presses
Accept: application/json

A buy is one indexed transaction into a tracked token, not proof of one individual human. The feed is read-only and publishes no wallet balances.

RouteAPI