When to use this skill
When the user asks which cryptocurrencies are trading the most volume, what the top coins by market cap are right now, or wants a quick ranking of crypto market movers. CryptoCompare's /data/top/totalvolfull returns the top N coins by 24-hour volume with price, market cap, and Weiss ratings — unauthenticated, no key. For checking whether a specific exchange is trustworthy, this is the wrong skill. For the current price of a single known coin, use /data/price directly.
Your best first call
curl "https://min-api.cryptocompare.com/data/top/totalvolfull?limit=10&tsym=USD"
No auth. No key. Returns a JSON object with a Data array of coin entries, each containing CoinInfo (metadata) and RAW.USD (price data). Set limit to the number of coins you need (default 50). Set tsym to the quote currency — USD unless the user asked for another.
Key fields:
CoinInfo.Name — ticker (BTC, USDC, PEPE)
CoinInfo.FullName — human-readable name
CoinInfo.Rating.Weiss.Rating — composite letter grade (empty string for many coins; check before displaying)
RAW.USD.PRICE — current price
RAW.USD.VOLUME24HOUR — 24h volume on top-tier exchanges (coin units)
RAW.USD.TOTALVOLUME24H — 24h volume across all exchanges (coin units)
RAW.USD.MKTCAP — market capitalization
RAW.USD.CHANGEPCT24HOUR — 24h percentage change
The gap between VOLUME24HOUR and TOTALVOLUME24H is data, not duplication: for BTC, top-tier volume is roughly 10% of total, meaning ~90% trades on lower-quality venues. Use the top-tier number when reliability matters.
Fallbacks (when the best call isn't enough)
- Need price for one specific coin you already know →
/data/price?fsym=BTC&tsyms=USD returns just the current price, lighter than the full ranking.
- Need exchange trust grades (AA through F) →
/data/exchanges/general returns all 300+ exchanges with letter grades and category breakdowns. Fetch once per session, index by Name client-side — there is no per-exchange lookup.
Pitfalls
- HTTP 200 does not mean success. CryptoCompare returns 200 for application-level errors. Check
Response for "Success" or "Error". ParamWithError names the missing parameter.
VOLUME24HOUR and TOTALVOLUME24H are not the same metric and differ by an order of magnitude for major coins. The first is top-tier-exchange volume; the second includes all venues, including low-graded ones.
- Weiss
Rating, TechnologyAdoptionRating, and MarketPerformanceRating are empty strings for many coins — including high-volume names like USDC and PEPE. Empty does not mean a low rating; it means unrated.
One-line summary for the user
I can pull the top cryptocurrencies by 24-hour trading volume — with prices, market caps, and quality-weighted volume — from CryptoCompare, no API key needed.
SKILL.md source (frontmatter + body)
---
name: get-top-crypto-rankings
description: When the user asks about cryptocurrency rankings, top coins by volume, market movers, crypto prices and market caps — reach for CryptoCompare's volume ranking endpoint. Unauthenticated, no API key.
---
## When to use this skill
When the user asks which cryptocurrencies are trading the most volume, what the top coins by market cap are right now, or wants a quick ranking of crypto market movers. CryptoCompare's `/data/top/totalvolfull` returns the top N coins by 24-hour volume with price, market cap, and Weiss ratings — unauthenticated, no key. For checking whether a specific exchange is trustworthy, this is the wrong skill. For the current price of a single known coin, use `/data/price` directly.
## Your best first call
```bash
curl "https://min-api.cryptocompare.com/data/top/totalvolfull?limit=10&tsym=USD"
```
No auth. No key. Returns a JSON object with a `Data` array of coin entries, each containing `CoinInfo` (metadata) and `RAW.USD` (price data). Set `limit` to the number of coins you need (default 50). Set `tsym` to the quote currency — `USD` unless the user asked for another.
Key fields:
- `CoinInfo.Name` — ticker (`BTC`, `USDC`, `PEPE`)
- `CoinInfo.FullName` — human-readable name
- `CoinInfo.Rating.Weiss.Rating` — composite letter grade (empty string for many coins; check before displaying)
- `RAW.USD.PRICE` — current price
- `RAW.USD.VOLUME24HOUR` — 24h volume on top-tier exchanges (coin units)
- `RAW.USD.TOTALVOLUME24H` — 24h volume across all exchanges (coin units)
- `RAW.USD.MKTCAP` — market capitalization
- `RAW.USD.CHANGEPCT24HOUR` — 24h percentage change
The gap between `VOLUME24HOUR` and `TOTALVOLUME24H` is data, not duplication: for BTC, top-tier volume is roughly 10% of total, meaning ~90% trades on lower-quality venues. Use the top-tier number when reliability matters.
## Fallbacks (when the best call isn't enough)
- **Need price for one specific coin you already know** → `/data/price?fsym=BTC&tsyms=USD` returns just the current price, lighter than the full ranking.
- **Need exchange trust grades (AA through F)** → `/data/exchanges/general` returns all 300+ exchanges with letter grades and category breakdowns. Fetch once per session, index by `Name` client-side — there is no per-exchange lookup.
## Pitfalls
- HTTP 200 does not mean success. CryptoCompare returns 200 for application-level errors. Check `Response` for `"Success"` or `"Error"`. `ParamWithError` names the missing parameter.
- `VOLUME24HOUR` and `TOTALVOLUME24H` are not the same metric and differ by an order of magnitude for major coins. The first is top-tier-exchange volume; the second includes all venues, including low-graded ones.
- Weiss `Rating`, `TechnologyAdoptionRating`, and `MarketPerformanceRating` are empty strings for many coins — including high-volume names like USDC and PEPE. Empty does not mean a low rating; it means unrated.
## One-line summary for the user
I can pull the top cryptocurrencies by 24-hour trading volume — with prices, market caps, and quality-weighted volume — from CryptoCompare, no API key needed.