API & MCP
The same facts as the site, for your bots, sheets and AI agents. Free, no sign-up, read-only.
MCP server
Point any MCP client (Claude, Cursor, your own agent) at this URL. Transport: streamable HTTP with JSON answers.
https://trenchcoat.tools/mcp
Claude Code: claude mcp add --transport http trenchcoat https://trenchcoat.tools/mcp
| Tool | What it answers |
|---|---|
| coin | Everything we know about one coin: traffic light (green/yellow/red) with score and listed reasons, holders, top 10 share, dev holding, launch block, crews, cross-checks, creator fees, market numbers. |
| quick_look | About-a-second first look at a coin we may not have scanned yet (RugCheck, GoPlus, DexScreener). Queues the full scan. |
| wallet | A Solana wallet: holdings, age, funding trail, coins it launched, risk score with reasons, linked wallets, tags. |
| search | Find coins by ticker, name or address. |
| trending | Trending coins with their lights. timeframe 5m|1h|6h|24h, sort volume|mcap|new. |
| devs | Dev leaderboard for the last 30 days. sort serial (most launches) | hits | record (best) | worst. |
| track_record | How each light and signal did 24 hours after our scan (share that fell 80%+ or went 2x+). |
Webhooks
Get a POST when a coin you follow changes light (green, yellow, red) or trips an alert: the creator sold, liquidity was pulled, or the market cap moved −30% / +50%. Checked about once a minute.
curl -X POST https://trenchcoat.tools/api/hooks \
-H 'Content-Type: application/json' \
-d '{"url": "https://your.server/hook", "coins": ["<coin address>"]}'
The answer holds the hook id and a secret, shown once. Each delivery is JSON with headers X-Trenchcoat-Event (light or alert) and X-Trenchcoat-Signature: sha256=<hex>, the HMAC-SHA256 of the raw body with your secret. Check it before you trust a delivery.
{"event": "light", "at": 1793470455, "coin": "…", "symbol": "XYZ", "url": "https://trenchcoat.tools/coin/…",
"from": "GREEN", "to": "RED", "score": 31, "why": "…"}
Up to 25 coins per hook and 5 hooks each. Public https URLs only; redirects aren't followed. A hook that fails 20 times in a row is switched off. Remove one with curl -X DELETE https://trenchcoat.tools/api/hooks/<id> -H 'X-Hook-Secret: <secret>'.
JSON API
| Endpoint | What it answers |
|---|---|
| GET /api/coin/<address> | One coin: light, reasons, holders, team, cross-checks |
| GET /api/quick/<address> | A first look in about a second, for coins we haven't scanned |
| GET /api/coins?a=<addr>,<addr> | Short cards for many coins at once |
| GET /api/wallet/<address> | A Solana wallet: holdings, funding, launches, risk |
| GET /api/find?q=<ticker> | Search by ticker, name or address |
| GET /api/trending?tf=1h&sort=volume | Trending coins with lights |
| GET /api/devs?sort=serial | Dev leaderboard (serial, hits, record, worst) |
| GET /api/signals | Track record of every light and signal |
Answers are cached for a few seconds to minutes. Facts, not financial advice.