Free API
Token safety data for your app, bot or site
The same analysis you see on DexGrade, as JSON. Free, no key, CORS open. Every number is read from the blockchain by our own nodes. Chains: solana, ethereum, base, robinhood, bsc, arbitrum, polygon, avalanche, optimism.
GET https://coinswavez.com/api/data/v1/token/{chain}/{address}Everything about one token: verdict and score, contract checks, liquidity and pools, top holders, exit risk, 5m/1h/6h/24h stats, timeline and the latest 50 trades. Also a ready-to-post summary line and links to the report and card. Apps get our saved check when it is under 2 minutes old.
Cached 20 s.
GET https://coinswavez.com/api/data/v1/daily/{chain}/{address}A daily report for a token, ready for a bot to post: score and change since yesterday, days in a row at its rating, liquidity, holders, new buyers, 24h stats, checks today and the next fix.
Cached 2 min.
GET https://coinswavez.com/api/data/v1/trend/{chain}/{address}How a token changed, as daily points for up to a year: risk score, top 10 holders %, developer %, sellable before −5%, holders, different traders, new buyers, checks, liquidity, market cap, volume, trades and buy share, plus "What changed" events (permissions, tax, liquidity lock, why the score moved, alerts).
Cached 10 min.
GET https://coinswavez.com/api/data/v1/card/{chain}/{address}The token's share card as a 1200×630 PNG (from our saved check). Telegram and other apps can send it straight from the link.
Cached 10 min.
GET https://coinswavez.com/api/data/v1/trades/{chain}/{address}?limit=200Trades we read for the token, newest first (up to 1,000): time, buy/sell, USD, token amount, price, wallet, transaction.
Cached 15 s.
GET https://coinswavez.com/api/data/v1/candles/{chain}/{address}?tf=5mOHLCV candles in USD built from those trades. tf = 1m, 5m, 15m, 1h, 4h or 1d.
Cached 30 s.
GET https://coinswavez.com/api/data/v1/history/{chain}/{address}?tf=1h&days=30Saved price history: hourly candles kept for 90 days, as 1h, 4h or 1d candles (OHLC and USD volume).
Cached 2 min.
GET https://coinswavez.com/api/data/v1/traders/{chain}/{address}Top traders of the token over the last 7 days of trades: bought, sold, number of trades and profit (including what they still hold at today's price).
Cached 60 s.
GET https://coinswavez.com/api/data/v1/lists?tab=active&page=1Lists of 100 per page: active, all (every token we know), boosted, gainers (biggest 24h rise, DexScreener numbers), new (pools from the last 48 hours, every chain), fresh (new pump.fun), rug (rugging now), most (most checked today), recent, safe. Add chain= to filter.
Cached 30 s.
Example
const r = await fetch('https://coinswavez.com/api/data/v1/token/solana/<mint address>');
const t = await r.json();
console.log(t.verdict.level, t.verdict.score); // "caution", 62
console.log(t.exit.sellFor5Pct); // USD you can sell before -5%
console.log(t.checks.filter(c => c.level === 'bad'));Free API key
Without a key: 30 calls a minute. With a free key: 300 a minute and 5,000 a day (up to 200,000 on paid plans). See how to get a key. Create one on your profile (free account) and send it as a header:
curl -H "X-API-Key: cwd_..." https://coinswavez.com/api/data/v1/token/solana/<mint address>
Fair use
Please cache responses. Credit "Data: DexGrade" with a link to dexgrade.com. Need more, or webhooks? Ask us on Telegram. Building a Telegram bot? Follow the safety bot guide.