For developers and agents
Builder evidence, any way you want it.
HEY is the public record of building on Robinhood Chain — every ship with its source — as JSON, a change feed, a typed SDK or MCP. No key, no account, and nothing here is a buy signal.
- Partner Card →bots, terminals and apps: builder intelligence in one call
- For autonomous agents →discover, connect, verify and monitor
- HEY for Robinhood Agents →the questions, the four interfaces, the evidence
- Uniswap integration →HEY answers who is building; Uniswap provides the market
Base URL
https://heyresearch.xyz/api
- Auth
- None needed; a free key names you
- Rate limit
- 120 / min; holder keys more
- Cache
- 60 seconds; keyed answers are private
- CORS
- Open
Start here
Three calls answer most questions
Quote the URL in your shell: ? and & mean something to zsh and bash before curl ever sees them. Building a bot, a terminal or an app that meets a contract address rather than a slug? Start here: the Partner Card, one call, tried on your own token, with the panel to render and the rules of use. The one-line /api/token lookup for a chat bot is its own short guide.
Is anyone building this token?
GET /api/v1/builder?chain=4663&token=<address>
The Partner Card: builder status in the project page's words, the latest meaningful ship with its evidence, meaningful ships in 30 days (null, never 0, when HEY did not measure), the latest change, and whether the project names this contract. An address HEY has not published answers 404 with a scan_url.
curl "https://heyresearch.xyz/api/v1/builder?chain=4663&token=<address>"Tell me about one project
GET /api/projects/<slug>/snapshot
The important state of a project in one read: identity, build, market with its kind or why it is withheld, on-chain, verification, locks, the latest changes, freshness and coverage.
curl "https://heyresearch.xyz/api/projects/<slug>/snapshot"What changed?
GET /api/changes
The change ledger: one event per meaningful change, newest first, with the time it happened, how precisely HEY knows it, when HEY first knew, and its evidence.
curl "https://heyresearch.xyz/api/changes?limit=10"Access
Auth and limits
A key is optional. A free key from your account page takes a minute and needs no holding: it names your product to HEY, carries a monthly allowance and unlocks the bulk reads below. Send it as authorization: Bearer hey_…. A key reads the same public data and never unlocks anything private; a keyed answer is private, no-store. The bulk reads answer keyed requests only and cost one request per item.
More per minute, if you need it: an account whose linked wallet holds HEY gets a holder key with a higher per-minute limit and a larger allowance, and a product whose readers need more can ask for a partner key on the partners page. Neither changes anything HEY says.
Anonymous callers get 120 requests a minute per address (an IPv6 caller per /64). A refusal is 429 rate_limited with retry-after; every response exposes x-request-id, and a keyed one x-hey-tier and x-hey-monthly-remaining.
Bulk (keyed only)
GET /api/snapshots?slugs=
Up to 10 snapshots in input order, each with its own found or error.
curl -H "authorization: Bearer $HEY_API_KEY" "https://heyresearch.xyz/api/snapshots?slugs=<slug>,<slug>"GET /api/token/<chainId>?addresses=
Up to 30 token lookups in one statement, input order kept.
curl -H "authorization: Bearer $HEY_API_KEY" "https://heyresearch.xyz/api/token/4663?addresses=<address>,<address>"GET /api/v1/scan?tokens=
Up to 30 partner cards, in the partner's snake_case.
curl -H "authorization: Bearer $HEY_API_KEY" "https://heyresearch.xyz/api/v1/scan?chain=4663&tokens=<address>,<address>"Go further
Pick your path
REST API →
Every route: one project, changes, history, evidence, contracts, filters, and the rules every answer follows.
SDK & MCP →
Typed calls from TypeScript, the open-source packages, and HEY inside an AI assistant.
Webhooks & embeds →
The change feed pushed or polled, RSS, and a badge or live widget for your project.
Health
Status
/api/status is the public status page as JSON: worker heartbeat, each source's freshness against its target, the change ledger, the job queue and market coverage. It never says everything is fresh while a source is behind.
curl "https://heyresearch.xyz/api/status"Boundaries
What HEY deliberately does not provide
- No wallet data. No wallet analytics, PnL, smart-money or whale labels, and no address profiled across tokens. The one exception is a single token's supply-concentration summary; the only account ever named is a contract's deployer.
- No prices as a verdict. No price prediction, valuation opinion, ranking by price, or buy or sell signal. Market figures are context.
- No causes. A change beside a market move is a sequence HEY recorded, never a cause.
- No partnership claims. An on-chain interaction between two contracts is an observation, not a partnership.
- No history HEY did not keep. A series starts when HEY began collecting it; nothing before is reconstructed and presented as what HEY knew.
- No Terminal-only data, and no verdicts. Terminal-only surfaces are not on the public API, the MCP or the change feed. Market Integrity is published (
/api/projects/<slug>/market-integrity,market_integrity.event,integrity:receipts): evidence classifications with their reading dates and sources, never a finding about anyone's intent, never whether development stopped, and never an input to activity status or Build Momentum.
Something wrong in the record? Submit a correction.