The question

Not which wallet bought and not which token is pumping, but:

Which projects are still building, what have they shipped, and which of them is nobody looking at?

Every answer on HEY is a fact with the source it came from. There is no score of a project's worth, no grade, no verdict, and the words rug and scam appear nowhere in the product — an end-to-end test asserts it.

What it looks like

Explore the catalogue	One project's evidence

Builder Radar	HEY Signal

More surfaces: Pulse, Ships, Scout, Bounties, Developers, Methodology, mobile

Pulse — the chain, day by day	Ships — what landed

Scout — earn by finding evidence	Bounties — set in dollars, paid in HEY

Developers	Methodology — every rule, stated

Home, 375px	A project, 375px

Captured from production on 20 September 2026.

In this repository

This is the published half of HEY: the parts that stand on their own and are safe to read.

The ingestion pipeline, the quality gate, the database schema, the web app and the operations tooling stay in the private repository.

Quickstart

Use the packages from npm (published 27 September 2026):

npm i @hey-research-lab/sdk                                   # the typed client
claude mcp add hey-research -- npx -y @hey-research-lab/mcp   # the MCP server

Or build this tree:

pnpm install
pnpm lint && pnpm typecheck && pnpm test     # 686 tests, no network
pnpm --filter @hey-research-lab/sdk build        # packages/sdk/dist
pnpm --filter @hey-research-lab/mcp build        # apps/mcp/dist/index.js

Use the API

No key needed for the read API. 120 requests a minute anonymously, more with a key.

One address, one line — the call a trading bot makes:

curl "https://heyresearch.xyz/api/v1/scan?chain=4663&token=0xB33eb16782776b4D738c0Fd643577cb0284Db610"

{
  "found": true,
  "status": "shipping",
  "status_label": "Shipping",
  "verified_builder": true,
  "activity": { "commits_30d": 100, "releases_30d": 1, "ships_30d": 3, "last_ship": "2026-09-18" },
  "project_url": "https://heyresearch.xyz/project/hey-research-lab",
  "cta": { "label": "See the builder on HEY", "url": "…" }
}

A token HEY has no published page for answers 200 with found: false, so a bot prints nothing rather than guessing.

The same thing, typed:

import { HeyClient, HeyApiError } from '@hey-research-lab/sdk';

const hey = new HeyClient();
const card = await hey.scanCard(4663, address);
if (!card.found) return null;

for await (const project of hey.projects.items({ tab: 'still-building' })) {
  console.log(project.slug, project.lastShippedAt ?? 'no ship recorded');
}

A listed project with a token carries tokenMarket — the market state the card shows — and the single-project route sends everything the listing does. /api/projects/{slug}/market adds the contract's deployer, its pools and 1% depth, and a supply-concentration summary with no addresses (2026-09-25).

/api/projects/{slug}/relationships lists what a project is connected to and why HEY thinks so — every edge with its standing and evidence, never an account and never a "partnership" — and the snapshot's peerContext places some of its figures among comparable projects, one figure at a time, never as a combined score (2026-09-28).

The snapshot (/api/projects/{slug}/snapshot) opens on summary — one answer-first line per question (building, usage, market, contracts, security, the latest change, what HEY does not know), each tagged FACT, DERIVED or UNKNOWN with its evidence ids — and carries usage (calls and distinct caller addresses per day, never people, never summed into a window) and security (audits, bounties, security.txt, advisories; context, never a verdict). /api/projects/{slug}/usage adds the daily series (2026-09-28).

Paging follows the API's own cursor, a 429 arrives as HeyApiError with retryAfterSeconds and is never retried for you, and an absent field means HEY does not know — never a zero.

For an assistant — fifteen read-only tools over the same API, hosted or on your machine, listed in the Official MCP Registry as io.github.hey-research-lab/hey-research:

claude mcp add --transport http hey-research https://heyresearch.xyz/mcp

# or from npm
npx -y @hey-research-lab/mcp

# or from this repository
pnpm --filter @hey-research-lab/mcp build
claude mcp add hey-research -- node "$PWD/apps/mcp/dist/index.js"

Full reference: docs/PUBLIC_API.md · docs/MCP.md · docs/INTEGRATIONS.md — the line to render, the three answers to handle, and the four things not to do.

For autonomous agents

From the domain alone, with no JavaScript and no cookies:

An agent that forms a thesis can record it as an AgentResearchReceipt — neutral, for any project, checked but never stored or endorsed by HEY. HEY gives no trade instructions and runs no agents of its own.

The badge

Any project HEY tracks can embed its own status. It updates itself, and it links back to the evidence behind it.

[![My project on HEY](https://heyresearch.xyz/badge/<slug>.svg)](https://heyresearch.xyz/project/<slug>)

?theme=dark and ?style=pill are the other two looks. docs/BADGES.md on the site.

Rules that do not move

• Building is not price. Market cap, liquidity and volume are context and filters. Nothing in packages/scoring reads a price or a balance; a neutrality test fails the build if it ever does.
• Paying changes nothing organic. Bounties, sponsorships, claims and $HEY holdings never move a rank, a status or a score.
• No wallet analytics. No PnL, no smart-money or whale labels, no wallet profiles, no clustering presented as a claim about people, no copy-trading. The schema guard fails the build on the words. One exception, decided on 2026-09-14: a bubble map of a single token's largest balances on that token's market page. An address there is a point on a chart of one supply — never a person, never scored, never ranked across tokens, never an input to any status or score.
• Absent means unknown. A figure HEY has not measured is omitted, never published as zero.
• Security is evidence, never a verdict. An audit shows an audit took place; it is not a guarantee of safety. HEY says where a report is published and where it found the link — no score, no "safe", and "no advisory found" is a reading of one index, never a clean bill.
• A model is never the source of truth. AI-assisted interpretation is optional and off by default; when on, it reads only HEY's own evidence, cites it by id, is labelled as an interpretation, and never moves a status, a score or a rank. AI_PROVIDER accepts disabled or anthropic only.
• Every claim carries its source. And none of them is a buy signal.

The full rules, with the thresholds they use, are on the methodology page.

$HEY, briefly

$HEY (0xB33eb16782776b4D738c0Fd643577cb0284Db610 on Robinhood Chain) pays for evidence: research bounties set in dollars and paid in HEY, claim bonds, and priority on research requests. Holding changes what a reader pays, when they see new research and how much API the lab serves them. It never buys a rank, a status or a score.

How this repository is produced

A script in the private repository copies the paths listed above, generates a types-only @hey/db, refuses to publish anything that must not leave, and pushes one commit per sync. Issues and pull requests are welcome here: a change accepted here is applied privately and comes back in the next sync.

HEY reports what teams ship and whether a tracked token still has a market. It does not predict prices, and nothing in it is investment advice.

MIT licence. See CHANGELOG.md for what has changed and when.