Crypto Market Cap API
Total market cap, 24-hour volume and Bitcoin dominance in one free call, for a market of 2.4M+ coins across 110+ exchanges. Full-history series on Growth.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.
Free · https://api.coinranking.com/v2/stats · histories on Growth
# The whole market in one call: totals, dominance, best and newest coins
curl 'https://api.coinranking.com/v2/stats' \
-H 'x-access-token: YOUR_KEY'
# Totals for one category: every coin tagged 'defi'
curl 'https://api.coinranking.com/v2/stats/coins?tag=defi' \
-H 'x-access-token: YOUR_KEY'Now, over Time, and for Any Slice of the Market
Current totals, their histories, and the totals of any subset of coins.
Endpoints marked Growth have production access on Growth and higher. Free, Basic and Startup can make five successful preview requests per eligible endpoint, per account, each UTC day. Normal usage and plan limits apply. How previews work.
- GET/stats
Total market cap, 24-hour volume, Bitcoin dominance, counts of coins, markets and exchanges, plus the three best-performing and three newest coins.
- GET/stats/coins
Market cap, volume, share of the market, coins up versus down, and top-coin dominance for a category (tag) or your own uuids[].
Total market cap per point, timePeriod from 1h to all, in any reference currency. The series behind the global chart on coinranking.com.
Total 24-hour volume across the market per point, same periods.
Bitcoin's share of total market cap as a percentage per point, with its market cap alongside.
What Each Figure Is Made Of
The same definitions the website uses.
| Definition | Field | |
|---|---|---|
| Total market cap | Sum over listed coins of aggregated price × circulating supply, with locked and reserved addresses excluded from supply. | totalMarketCap |
| 24-hour volume | Total trade volume in the last 24 hours, in the reference currency. | total24hVolume |
| Bitcoin dominance | Bitcoin's market cap as a percentage of total market cap. | btcDominance |
| Coins, markets, exchanges | Live counts of what the API tracks: 2.4M+ coins and 50,000+ markets at the time this page rendered, from 110+ integrated exchanges. | totalCoins · totalMarkets · totalExchanges |
| Best and newest coins | The three best-performing coins in the selected timePeriod and the three newest listings, with UUIDs to fetch more. | bestCoins · newestCoins |
What Developers Build on Global Stats
The four numbers a crypto site puts in its header.
Market Headers
Total cap, volume, dominance and coin count in one call, refreshed every minute.
Macro Charts
Total market cap and dominance over any period up to all time on Growth, in any currency.
Sector Trackers
/stats/coins per tag: DeFi, meme, layer-1, stablecoins, each with its share of the market and how many coins are up or down.
Portfolio Context
Your holdings' combined cap and share of the market, from a uuids[] selection.
Global Stats by Plan
The /stats and /stats/coins endpoints are on every plan, including Free. The three history endpoints need the Growth plan.
| Free | Basic | Startup | Growth | Professional | |
|---|---|---|---|---|---|
| Monthly price | $0 | $24 | $49 | $99 | $199 |
| Monthly credits | 10,000 | 500,000 | 1,000,000 | 2,000,000 | 5,000,000 |
| REST rate limit | 5 / second | 1,000 / minute | 2,000 / minute | 4,000 / minute | 6,000 / minute |
| API keys | 1 | 1 | 2 | 5 | Unlimited |
| Historical window, where supported | 1 year | 5 years | All time (from 2010) | All time (from 2010) | All time (from 2010) |
| Maximum results per response | 100 | 5,000 | 5,000 | 5,000 | 5,000 |
| Standard endpoints on this page | 5 successful previews / endpoint / UTC day | 5 successful previews / endpoint / UTC day | 5 successful previews / endpoint / UTC day | Production access | Production access |
Endpoint-specific limits may be lower. Preview allowances are shared across every API key on your account. Every paid plan offers a 30-day free trial. Compare all features.
Global Stats Questions
Call GET /stats on Coinranking API. It returns totalMarketCap, total24hVolume and btcDominance for the whole market in one response, along with the number of coins, markets and exchanges tracked and the three best-performing and three newest coins. The endpoint is on every plan, including Free, and accepts referenceCurrencyUuid for any currency. See the global stats docs.
Yes. Coinranking Bitcoin dominance history endpoint returns Bitcoin's share of total market cap as a percentage per point, with Bitcoin's market cap alongside, for any timePeriod from 1h to all time. It is a Growth endpoint; the current dominance figure in /stats is on every plan.
Yes. GET /stats/coins returns market cap, volume, market cap share, the number of coins rising and falling, and the top coin's dominance for any selection: filter by tag for a category such as defi or meme, or by uuids[] for your own list. It is on every plan. See stats for a selection of coins.
Coinranking global market cap history, global trading volume history and Bitcoin dominance history accept timePeriod=all, returning the series back to the earliest data Coinranking holds, with Bitcoin's own history starting in 2010. Shorter periods from 1h to 5y return finer-grained points. All three history endpoints are Growth.
Coinranking calculates total market cap as the sum of each listed coin's price multiplied by its circulating supply, using the same aggregated price its coin endpoints return and a circulating supply that excludes locked and reserved addresses (supply modifiers). Coins below a low-volume threshold are filtered from rankings and global stats to keep the totals honest.
More of Coinranking API
Same key, same base URL.
Get the Global Market Stats
Total market cap, volume and Bitcoin dominance on a free key today. The history endpoints are free for 30 days on Growth.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.