Integrations · free tier
One GET per coin. The creator’s launch record, the band, the band’s time-to-rug, and a link to the full card — Solana and Robinhood Chain, same call. Built for scanners, alert bots and terminals: Rick Bot, Trenchy, Soul Scanner, Moby, Axiom, or yours.
curl "https://api.groundtruths.xyz/v1/record?ca=GKQoBJ1dLMMzMf51RfXMiQifcmKhR1s5u5VmV1ezpump"
A pump.fun mint or a Robinhood Chain 0x token. The chain is detected from the address.
{
"ca": "GKQoBJ1dLMMzMf51RfXMiQifcmKhR1s5u5VmV1ezpump",
"chain": "solana",
"in_set": true,
"outcome": "rugged",
"creator": "DE9cFJdYJ2dtnZC57gjQjCEoEr84WpMJhbMCJFsRRM3o",
"launches": 1,
"failure_pct": 100,
"band": "RED",
"rule_id": "creator_prior_rug",
"band_source": "live_read",
"median_ttr_s": 43,
"ttr_window": "24h",
"card_url": "https://groundtruths.xyz/?ca=GKQoBJ1dLMMzMf51RfXMiQifcmKhR1s5u5VmV1ezpump"
}
Real response, 2026-09-15. A coin not in our captured data answers 404 with
in_set: false and still carries card_url — no record is not a clean record.
| launches | Launches we can attribute to this coin’s creator in the market data we have captured. |
| failure_pct | Rugged plus died, over resolved launches. The “ended up worthless” figure. |
| band | RED / AMBER / GREEN from the creator’s record, the same rule the card uses. Not a safety rating — most launches on both chains fail in every band. |
| median_ttr_s | The band’s published 24 h time-to-rug: how long coins in that band that rugged took. A population figure, not a prediction for this coin. |
| outcome | What happened to this coin, if it has resolved: rugged, died, graduated, survived, or active. |
| card_url | Deep link to the full card — link it from your alert. |
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, 30 seconds to get).
Building a scanner or a terminal? Email sales@groundtruths.xyz with the product and roughly how many launches a day: partners get a free partner key, 100,000 calls a month.
Partner keys require attribution: “record: groundtruths.xyz” next to the band.