API · free tier

The API.
One GET before you buy.

Host: https://api.groundtruths.xyz
This site serves no API path of its own.
Building a bot? Put the rap sheet in it.

The endpoints.

GET https://api.groundtruths.xyz/api/scan?ca=<mint>

One coin, start to finish. Solana or Robinhood Chain. No chain parameter: it reads the address shape.

GET https://api.groundtruths.xyz/v1/flag?addr=<creator>&chain=solana|rh

The dev’s rap sheet: six buckets and the failure rate, chain baseline beside it.

GET https://api.groundtruths.xyz/v1/record?ca=<mint>

One coin and its dev in a single answer, with a link to the full card.

GET https://api.groundtruths.xyz/v1/ttr?chain=&band=&window=

Withdrawn 2026-09-29. Answers with nulls and band_withdrawn, so clients don’t break.

GET https://api.groundtruths.xyz/v1/creator/<wallet>/replay?n=10&usd=100

Your $100 across the dev’s last launches. Solana only. Robinhood answers 501 with the reason.

POST https://api.groundtruths.xyz/v1/seal

Log a verdict under your key. Returns the row hash and its sequence.

GET https://api.groundtruths.xyz/v1/scorecard

Your logged calls and what each coin did. Hash chain verified, not asserted.

GET https://api.groundtruths.xyz/api/screener?addr=<creator>&chain=solana|rh

Wallets that were early in one dev’s launches, with role and counts.

GET https://api.groundtruths.xyz/api/known-bad?chain=solana&format=csv

The published known-bad set as a pull. No rap sheet is not a pass.

Three things before your first 404.

?ca= for a coin. ?addr= for a wallet or dev.

Pass chain=solana or chain=rh on dev endpoints.

An unknown chain is a 400 that names the ones it accepts. A typo can’t answer for the wrong chain.

A dev we’ve never seen returns null. Never false.

known_bad is null when a dev isn’t in the published set. How it’s set: Boring stuff →

Keys and limits.

No key: 5 calls a day per IP, shared across /api/scan, /v1 and /mcp.

The sixth answers HTTP 402 with a link to a free key: 1,000 calls a month.

Partners get a free key, 100,000 calls a month: sales@groundtruths.xyz.

A key over its tier gets a 429 with the upgrade link. Never an overage bill.

Agents: the MCP server.

Add https://api.groundtruths.xyz/mcp as a remote MCP server: Claude, Claude Code, Cursor.

5 free calls a day without a key. A key for more. Logging and the tally always need one.

pulling the tool list from the server...

Sniper or HFT bot? Plain HTTP, no MCP. Keep protocol out of the latency path.