GORZ API · V1
The GORZ safety read, in your bot or app.
One call returns the grade, every red flag with its reason, hard stops, launch bundles, wallets buying or selling together, rug-farm links and the GORZ AI warning for any Solana memecoin GORZ tracks.
QUICK START
curl "https://gorz.app/api/v1/check?mint=COIN_ADDRESS"
# with a key (higher limits, wallet lookups):
curl -H "x-api-key: gorz_…" "https://gorz.app/api/v1/check?mint=COIN_ADDRESS"
curl -H "x-api-key: gorz_…" "https://gorz.app/api/v1/wallet?address=WALLET_ADDRESS"EXAMPLE RESPONSE
{
"mint": "7xKX…pump", "found": true, "symbol": "EXAMPLE", "live": true,
"grade": "risky", "score": 38, "limitedData": false,
"hardStops": ["Launch bundle dumped"],
"flags": [
{"id": "bundletool", "label": "Bundle tool", "status": "fail", "detail": "14 wallets took 31% at launch and sold 72%"},
{"id": "swarm", "label": "Wallet swarm", "status": "warn", "detail": "8 wallets sold within the same second"}
],
"aiWarning": true,
"market": {"priceUsd": 0.0000412, "marketCapUsd": 41200, "liquidityUsd": null, "change5mPct": -22.4, "buyers5m": 61, "graduated": false},
"wallets": {"top10Pct": 34.2, "snipers": 6, "bundledPct": 18.5,
"launchBundle": {"wallets": 14, "supplyPct": 31, "soldPct": 72, "repeatBundlers": 4},
"boughtTogether": 0, "soldTogether": 8, "boughtTogetherMax": 3, "soldTogetherMax": 11,
"volumeBotPct": 0, "volumeBotMaxPct": 0, "devExited": true},
"farm": null,
"firstGrade": {"grade": "caution", "score": 61, "marketCapUsd": 9800, "at": 1792400000000, "after1h": "dumped"},
"page": "https://gorz.app/token/?mint=7xKX…pump", "at": 1792456000000,
"disclaimer": "GORZ shows what public on-chain data says right now. …"
}grade: safer · caution · risky · checking (not enough data yet). hardStops: the reasons GORZ Safe Mode would hide the coin. aiWarning: true when the coin's pattern matches coins that went on to dump. boughtTogether / soldTogether: wallets trading in the same second right now (last 5 min); the …Max fields are the most seen on this coin so far, which is what the flags use. firstGrade.after1h: what happened in the hour after GORZ first graded it. Every response tells you how many calls you have left in the x-ratelimit-remaining header.
PLANS
Free$0No key needed
- 300 coin checks a day
- Grade, red flags, hard stops
- Bundle, swarm and farm data
StarterAsk us20,000 checks a day
- Everything in Free
- Wallet lookups (farm group, bundles, snipes, creator record)
- Your own API key
ProAsk us200,000 checks a day
- Everything in Starter
- Built for bots and busy apps
- Early access to live alert streams
GOOD TO KNOW
• Limits reset at 00:00 UTC. Over the limit returns HTTP 429.
• Coins GORZ has not seen return HTTP 404 with
found: false.• Data is live: grades change as a coin trades. Cache for a few seconds at most.
• GORZ shows what public on-chain data says. Flags are what the data shows, not accusations. It does not predict prices and nothing here is financial advice.