HEY Research Lab public API
HEY Research Lab is the public record of building on Robinhood Chain (chain id 4663) — every ship with its source. It records project identity, builder…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
HEY Research Lab is the public record of building on Robinhood Chain (chain id 4663) — every ship with its source. It records project identity, builder activity, releases, contracts, on-chain use, market context and changes, each with its source, and serves them through a public API, a TypeScript SDK and a hosted MCP server.
Use HEY when you need evidence-backed information about Robinhood Chain projects: who is building, what they shipped, their contracts, what changed and when, market context with its reading date, and where HEY has no evidence.
Every path below begins with /api on https://heyresearch.xyz — an index answers at https://heyresearch.xyz/api — for Robinhood Chain (chainId 4663). Token identity is (chainId, contract), never a symbol.
$HEY is HEY's token: contract 0xb33eb16782776b4d738c0fd643577cb0284db610 on Robinhood Chain (chain id 4663). Research it like any token at https://heyresearch.xyz/api/hey/profile
HEY Research Lab is the product's brand name and the name of its own project record; it is spelled one way everywhere.
Semantic traps — read before using any figure:
- Unknown is not zero: an absent or null field means HEY does not know, never 0, false, [] or "none".
- FDV is not market cap: a valuation carries
kind(marketCaporfdv) and they are never compared as one figure. - An official X account is identity context, never evidence of building: do not link or tag one whose
officialX.linkHeldis set or whoseofficialX.statusis SUSPENDED or NOT_FOUND;corroboration: mutual_site_linkmeans only that the account links the project’s own site. - Stale is not current: every market or source reading carries
observedAt; an old reading describes then, not now. - A token is not a project: identity is (chainId, contract), and a token HEY has not published is not a researched project.
- Market is not building: price, valuation, liquidity and volume are context. Market figures (price, valuation, liquidity, volume) never feed activity status, Build Momentum or the Radar. The Discovery Gap is the one place market attention enters: it compares Build Momentum against market attention, measured on an active market only (elsewhere it is withheld, never 0).
Evidence. Every line is FACT (recorded, with its source), DERIVED (a rule HEY applied to facts) or UNKNOWN (not held). Every published claim has a typed evidence id (ship:, signal:, abi:, impl:, lock:, source:, claim:, state:, integrity:, narrative:, method:, sourcechange:, security:, v4hook:, v4pool:, ponsgrad:) that /api/evidence/{id} resolves to a receipt.
What HEY does not do:
- No wallet analytics, PnL, smart-money or whale labels, wallet profiles or "follow this wallet".
- No investment advice, price prediction, valuation opinion or buy/sell signal.
- No paid placement in organic ranking; holding $HEY never changes a ranking.
- No provider call in a read: every answer comes from HEY's own tables.
Access. No key is needed: 120 requests a minute per client address, and anonymous answers are cached for 60 seconds. An API key (Authorization: Bearer or x-api-key) names your integration and unlocks the bulk reads; a free key keeps 120 a minute, in a bucket of its own rather than one shared by every caller on your address (holder keys: Holder 600, Holder+ 1200 a minute). Every key carries a monthly allowance (a spent allowance answers 429 quota until the month resets), and keyed answers are private (cache-control: private, no-store), never edge-cached. CORS is open for GET.
Also:
- hosted MCP server (Streamable HTTP, read-only): https://heyresearch.xyz/mcp
- its research profile (builder intelligence first: no market-move, Under the Radar or valuation tool, and the ledger without market events; research_answer still carries the market context of HEY's agent contract (the valuation with its kind, source and reading date, and the market status), labelled context only and never a builder judgement, and one project's Under the Radar state with its Discovery Gap or why it is not measured): https://heyresearch.xyz/mcp/research
- A2A Agent Card: https://heyresearch.xyz/.well-known/agent-card.json
- llms.txt: https://heyresearch.xyz/llms.txt
- agent guide: https://heyresearch.xyz/developers/agents
- monitor with
/api/changes(cursorafter=), webhooks documented at https://heyresearch.xyz/docs/webhooks or RSS at https://heyresearch.xyz/feed/ships.xml - API changelog (every added field, changed meaning and deprecation, dated): https://heyresearch.xyz/developers/changelog
- its Atom feed: https://heyresearch.xyz/developers/changelog/feed.xml
Endpoints 60
projects
- GETSearch and browse published projects
/api/projectsThe published catalogue. q searches names, symbols and contracts; a parameter the listing does not read is named back in ignoredParameters (2026-10-17), never… - GETType-ahead over names, symbols and contracts
/api/search/suggestIdentity only (name, ticker, contract, route, and since 2026-11-02 a project row’s slug and logo), for every reader. At most eight rows. - GETOne project's dossier
/api/projects/:slugDescription, token identity, every registered source with how it was established, and market context with its provider and observedAt. A valuation that is not… - GETTwo to four projects side by side
/api/compareThe page's own figures and gates, no winner. marketCapUsd is the valuation the page prints, a market cap or an FDV: valuationKind and valuation (with its… - GETResolve a token contract to a published project
/api/token/:chainId/:addressstatus: "unknown" is an answer, not an error: HEY has not published a project for that contract. A malformed address, or a well-formed one that is not a token… - GETWhat projects shipped
/api/shipsA record of ships, each with the public source it was recorded from and how it is backed: verification is the stored value: PUBLICLY_VERIFIED or SOURCE_LINKED… - GETThe Builder Radar
/api/buildersRanked by counted development, on-chain use and research standing, never by price, payment or $HEY holding. - GETBuilders whose meaningful shipping is accelerating
/api/chain/acceleratingPublished, researched projects whose build velocity is ACCELERATING by the rule each project page shows: meaningful events in the last 30 days at least 1.5×… - GETBuild Momentum beside market attention
/api/chain/build-marketResearched, published projects with a measured Build Momentum and a place in the market cohort: each with its Build Momentum and its market-attention… - GETProjects shipping again after a long gap
/api/chain/comebacksPublished projects whose activity status is RESUMED: shipping again after 60 or more days without observed activity. At most 100 rows; total counts every row… - GETShipping in Silence: Under the Radar projects in the lowest market-attention bands
/api/chain/silenceHEY's stored Under the Radar decision (verified recent shipping, a live and fresh market) narrowed to the Low and Very low market-attention bands, with each… - GETThe week's builder rollup
/api/this-weekThe rollup /this-week renders: what shipped and from which projects, new verified builders, projects back to shipping, Still Building and Under the Radar,… - GETThe weekly report archive
/api/reports/weeklyThe newest 104 weekly reports, newest first: ISO week, window, whether the week is final, headline and when it was generated, the rule its ships were counted… - GETOne weekly report
/api/reports/weekly/:weekThe stored report for one ISO week, with the row's own week, window (Monday to Monday, UTC), final, headline and generatedAt laid over it, and shipsRule, the… - GETUp to 30 token contracts resolved in one keyed request
/api/token/:chainId?addresses=stringEach item's data is exactly what /api/token/{chainId}/{address} answers for that address, in the order asked; found is true when a published project stands… - GETThe monthly report archive
/api/reports/monthlyThe newest 60 monthly reports, newest first: month, window, whether it is final, headline, version and when it was generated, with url (the JSON report), csv… - GETOne monthly report
/api/reports/monthly/:monthThe stored report for one month, the row's own facts laid over it. totals are sums of the weeks' counts; shipsLabel says whether totals.ships is "Verified… - GETThe Explore result as CSV
/api/export/projectsThe listing's own rows in its order, up to 1,000 (x-hey-rows; x-hey-truncated: true when more matched), with the Explore filters (tab, kindGroup, kind,… - GETThe ships feed as CSV
/api/export/shipsThe ships feed for a window — since ≤ publishedAt < until — with the feed's narrowings (project, type incl. releases, has, q, sort, narrative), up to 1,000… - GETThe builder line of the day
/api/share/chain-dayOne fixed-template sentence from the chain's last complete UTC day, for a person to paste: source-backed ships and the builders behind them, as HEY recorded…
research
- GETOne project's important state in one read
/api/projects/:slug/snapshotIdentity, build, market (with kind, provider and observedAt on every figure, and valuationWithheld when a dead market's valuation, or one that is not… - GETWhat HEY knows and does not, per dimension
/api/projects/:slug/coverageStates, never a score: MEASURED, NO_SOURCE, NOT_ENOUGH_YET, STALE, SOURCE_UNAVAILABLE, NOT_APPLICABLE, NOT_RESEARCHED, ERROR or WITHHELD; since 2026-10-09 an… - GETWhy HEY publishes a fact
/api/projects/:slug/explainThe value, the rule, the inputs, the lineage from source to public value, the evidence ids and what HEY does not know. Without fact, the facts HEY can explain… - GETEvery kind of evidence on one axis
/api/projects/:slug/timelineNewest first, with totals, truncated and a nextCursor to pass as before. - GETThe points HEY persisted
/api/projects/:slug/historyEach series declares collectedFrom and basis (knowledge, observed, reconstructed_from_chain). A day HEY did not record is absent, never zero; the past is… - GETThen and now, never a cause
/api/projects/:slug/diff?from=2024-01-01&to=2024-01-01Two dates at most 400 days apart. A difference is not an explanation of why. - GETWhat is connected to one project, and why HEY thinks so
/api/projects/:slug/relationshipsFirst-degree relationships from HEY's own records: the token, contracts and where their proxies point, official repositories, domain and docs, packages… - GETWhich published projects a project names in its code or runs pools on, and which do so to it
/api/projects/:slug/built-onTwo kinds of link, both read from HEY's own tables (additive, 2026-10-17). Named in code (kind: code): a project's own official repository — not a fork, not… - GETWhether what the project shipped is being used
/api/projects/:slug/usageCalls into the project's watched contracts, active contracts, distinct caller addresses by UTC day, events, the most-called methods by bucket (function names… - GETMarket and usage before and after one build event
/api/projects/:slug/around/:eventIdWhat HEY measured in the seven days before one of the project's build events, on its own UTC day (or ISO week for a WEEK-precision event), and in the seven… - GETOne project's intelligence in one read
/api/projects/:slug/intelligenceThe project card, its signals of the last 90 days (at most 20), its Builder Radar standing and 30-day history, the market summary with its contract checks,… - GETAsk HEY a question about one project
/api/projects/:slug/ask?q=stringAsk HEY's evidence answer: the question matched to the parts of HEY's record it is about, each line tagged FACT, DERIVED or UNKNOWN with its source where it… - GETUp to 10 project snapshots in one keyed request
/api/snapshots?slugs=stringEach item's data is exactly what /api/projects/{slug}/snapshot serves for that slug, in the order asked. A hidden, unknown or renamed slug is found: false…
evidence
- GETThe change ledger
/api/changesOne canonical event per meaningful change HEY recorded. Mirror with after=<cursor> (start at c1.0) and keep each page's nextCursor — never sync on a… - GETResolve a typed evidence id to a receipt
/api/evidence/:idOne published record by its typed id: ship:, signal:, abi:, impl:, lock:, source:, claim:, state:, integrity:, narrative:, method:, sourcechange:, security:,… - GETHEY Signal: measured changes across projects
/api/signalsEach signal is a change HEY measured — development, contract, market, launch or research — with its kind, meaning, severity, confidence, before and after… - GETOne signal
/api/signals/:idOne signal by its id, as the feed serves it, with the disclaimer. A signal of a hidden project, a withdrawn one, or an id that is not a UUID answers 404.
market
- GETHEY's own daily index of the project's token
/api/projects/:slug/marketContext only. Every figure has its provider and reading date; an old reading describes then, not now. FDV and market cap are never mixed.… - GETLarge day-on-day valuation moves, with what shipped before each
/api/projects/:slug/market-movesEach day-on-day change in the market-cap close in HEY's daily index of at least min percent either way, with the project's meaningful events in the 7 days up… - GETWhat happened to the tracked token market, beside the building
/api/projects/:slug/market-integrityBuilder activity and the tracked token market as two objects side by side, the conflicts where they disagree, and the Market Integrity events the current… - GETRobinhood Chain day by day
/api/chainAggregates only, oldest day first: decoded DEX trades, DEX volume against the known quote assets (unpriced pairs are left out, not guessed), tokens and pools… - GETScheduled unlocks at HoodLock
/api/chain/unlocksHoodLock's own schedule: locks still holding that reach their unlock time within days, each with the project, the asset kind (TOKEN or LP), the locked amount…
contracts
- GETThe project's contracts
/api/projects/:slug/contractsEach as /api/contracts/{chainId}/{address} serves it, with whether HEY measured each section. - GETOne contract as a research entity
/api/contracts/:chainId/:addressCreation, deployer, proxy and implementation history, verified source, interface counts and seven-day activity, each section with whether HEY measured it. For… - GETEvidence-backed contract changes on published projects
/api/chain/contract-changesTwo families, newest first, each capped at 100 rows: upgrades and follow-up deployments (one row per project with a count, typed id ship:), and verification… - GETUniswap v4 hooks HEY ties to a published project
/api/v4-hooksAttributed hooks only (founder ruling, 2026-10-01): a hook the account that launched a published project's token created after the token, directly or through… - GETOne Uniswap v4 hook: who HEY ties it to, and what HEY does not know
/api/v4-hooks/:addressOne hook HEY holds on Robinhood Chain (2026-10-11), as /integrations/uniswap/hooks/{address} reads it: answer, one sentence; listed, whether HEY lists it…
hey
- GET$HEY as research data
/api/hey/profileIdentity, contract (null before launch, with a reason), chain, supply read from the chain, launch, market with valuation kind and observedAt, locks, HEY's own…
agents
- GETThe agent contract, described by itself
/api/agentThe six agent capabilities (research_project, what_changed, builder_status, verify_project, compare_builders, unknowns, chain_brief), each with its question,… - GETOne answer in HEY's agent contract (AgentIntelligenceResponse v1)
/api/agent/:capabilityTransport-neutral research for an agent: the one-sentence answer first, then claims each tagged FACT, DERIVED or UNKNOWN with source, source type, observedAt,… - POSTCheck an agent research receipt
/api/receipts/validateStateless and read-only: checks a receipt's shape against the AgentResearchReceipt v1 schema (https://heyresearch.xyz/schemas/agent-research-receipt.v1.json)… - POSTA2A JSON-RPC interface (SendMessage)
/api/a2aThe A2A 1.0 JSON-RPC binding described by https://heyresearch.xyz/.well-known/agent-card.json. Send A2A-Version: 1.0 (or no header) with SendMessage; A2A… - GETHow agents use HEY, as counts
/api/agent/statsReal MCP tool calls by day and tool, distinct and repeat agent clients, calls by protocol, SDK requests, discovery fetches, crawler reads by family, HEY's…
partners
- GETThe Partner Card: builder intelligence for one token
/api/v1/builder?token=stringBuilder status, verified builder, latest meaningful ship, meaningful ships in 30 days, the latest builder-side change and signal, token verification, market… - GETThe one-line scan card for a bot
/api/v1/scanThe by-contract lookup in a trading bot's card shape. found: false is a 200 for an unpublished token, another chain and the zero address (reason:… - GETA signed count of a project's counted ships, for the open ShipEscrow contract
/api/v1/proof-of-ship/attestation?slug=string&builder=string&since=0&escrow=stringEIP-712 typed data (domain "HEY Proof of Ship", version 1, chain 4663, the escrow as verifyingContract; Ships(bytes32 project,address builder,uint64… - GETThe payout addresses HEY would sign a Proof of Ship attestation for
/api/v1/proof-of-ship/tie?slug=stringFor one published project, every address the attestation route (getProofOfShipAttestation) would accept as builder for the same slug right now, each with its… - GETThe ships HEY counts for a project in a closed window, unsigned
/api/v1/proof-of-ship/ships?slug=string&since=0&until=0The Proof of Ship counted set for one published project between since and until — exactly what the attestation (getProofOfShipAttestation) counts, by the same… - GETWho signs HEY's security review states, under what EIP-712 domain and types
/api/v1/security-review/signerThe address that signs the security review states HEY Research Lab gives x402fi listing endpoints, so a buyer or x402fi checks a signed state against…
status
- GETHEY's own freshness and health
/api/statusWhen each pipeline last ran and whether it is fresh. build is the build serving the answer, as /api/health reports it (since 2026-10-02); summaryBuild…
API details
- Base URL
https://heyresearch.xyz- Authentication
- A bearer token in the Authorization header
An API key in the x-api-key header - Operations
- 60 operations on 60 pathsGET 58POST 2
- Main resources
- projects 20research 13partners 6agents 5contracts 5market 5evidence 4hey 1status 1
- Response formats
application/jsontext/csvtext/markdowntext/plain- Description format
- OpenAPI 3.1.0, API version
1 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Heyresearch's published OpenAPI description
How to test the HEY Research Lab public API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the HEY Research Lab public API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Search and browse published projects” (GET /api/projects), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the HEY Research Lab public API?
HEY Research Lab is the public record of building on Robinhood Chain (chain id 4663) — every ship with its source. It records project identity, builder… It is listed under Finance & banking and has 60 endpoints.
Who publishes the HEY Research Lab public API?
It is listed from HEY Research Lab's public API description (an OpenAPI document), not published by HEY Research Lab on Swastik Codes. Anyone who controls heyresearch.xyz can claim the profile by adding a DNS TXT record.
What is the base URL of the HEY Research Lab public API?
Requests go to https://heyresearch.xyz. Endpoint paths are added to this base URL.
How do I authenticate with the HEY Research Lab public API?
It accepts 2 methods: A bearer token in the Authorization header; an API key in the x-api-key header.
How many endpoints does the HEY Research Lab public API have?
60 operations on 60 paths (58 GET, 2 POST). The largest groups are projects, research, partners, agents.
Is forking the HEY Research Lab public API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.