# poolproof

> Six endpoints: five ask whether a thing is what it claims to be, one streams what is being
> launched right now and by whom.
> Facts only. No ratings, no advice, no predicted returns.

## What each check is for

- /v1/pool ($0.005) - Is a yield pool what it claims? Prices every underlying asset against its peg,
  compares APY to its own history, flags yields that only exist while token emissions last, checks
  exit depth. Catches pools labelled "stablecoin" holding assets well below $1.
- /v1/exit-cost ($0.010) - What does leaving a Solana position actually cost at YOUR size? Quotes
  your real size against a live router. Theoretical slippage numbers are the mistake this replaces.
- /v1/chain ($0.003) - Is a chain alive or abandoned? TVL across 1y/6m/90d/30d.
- /v1/launch ($0.005) - Who launched this pump.fun token, and what became of their previous ones?
  Launch count from the same wallet, how many reached the exchange, that group's graduation rate against
  the overall base rate, and whether the creator filled the bonding curve with their own buy (which makes
  graduation meaningless as a demand signal). Price and volume are public; that a token is the 238th from
  a wallet with no survivors is not. Built from our own recording of every pump.fun launch since
  2026-08-10 - a wallet active before that shows as unseen, and the response says so.
- /v1/launches ($0.010) - What is launching on pump.fun right now, and who is behind it? A live feed of
  the last 24 hours, newest first, each entry carrying the creator's record: prior launch count, how many
  reached the exchange, and whether their own first buy was large enough to fill the bonding curve alone.
  Poll with ?since=<next_since> to receive only what is new. Filter with ?only=first_time|serial|
  bought_curve|graduated|clean. This is the one endpoint whose answer changes every minute, and the one
  whose data cannot be rebuilt later: authorship at the moment of launch is not recoverable after the fact.
- /v1/known ($0.020) - Do we hold a research note that no data feed reports? Dead redemption bridges,
  tickers shared by unrelated projects, points programmes that ended, marketplaces that closed, capital
  gates absent from documentation. The other three checks read public data; this one is hand-built from
  investigation. Empty result means uninvestigated, not safe.

## Free tier

Same checks under /free/ instead of /v1/. No key, no signup. 3 calls per hour per IP.
The same three-per-hour budget covers the MCP server at /mcp — it is the same free tier,
not a separate one. Beyond that, pay per call over x402.

## Paying

Call a /v1/ path with no payment, receive HTTP 402 listing terms, retry with an X-PAYMENT header.
Settles in USDC on Base via x402. No account needed.

## Machine readable

- OpenAPI: /openapi.json
- x402 terms: /.well-known/x402

## Written for

Agents deciding whether to put capital somewhere, and people checking a pool before they do.