Get top crypto rankings

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.

get-top-crypto-rankings · v1 · updated 2026-04-16

Agents: This page is a SKILL.md-style capability guide. For JSON, call GET /api/skills/get-top-crypto-rankings. To drop this into a local Claude Code install, copy the frontmatter + body below into ~/.claude/skills/get-top-crypto-rankings/SKILL.md.

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:

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)

Pitfalls

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.

APIs this skill uses

CryptoCompare API · primary · verified

Free cryptocurrency data API providing real-time and historical prices, market data, exchange information, and coin metadata. Supports multiple cryptocurrencies and fiat currency pairs.

Generated from

CryptoCompare API tutorial Getting Started with CryptoCompare API

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.

« Back to all skills