CoinMarketCap Scraper

CoinMarketCap's API is key-gated on every tier, and the free plan caps you at a few hundred calls a month. This Actor reads CoinMarketCap market data for any coin and returns one structured record: rank, price, market cap, fully diluted valuation, volume, supply, all-time high and low, dominance and percent change over 24h, 7d and 30d. A second mode returns the news it carries per coin.

What it does

• Returns one record per coin, in order. A slug CoinMarketCap does not know comes back with status: "failed" and a reason.
• Sweeps the market when you leave the coin list empty, sorted by cap, volume, price, 24h or 7d change, or listing date.
• Filters to coins only, tokens only, or both, which the market sweep on most sources will not do.
• Carries fully diluted valuation and dominance next to market cap, so a small float is visible rather than hidden.
• Reports percent change over 24h, 7d and 30d in the same record.
• Converts to any fiat or crypto CoinMarketCap supports, by code or by its numeric id.
• Has a second mode for news, one record per story CoinMarketCap carries for a coin.
• Optional price history and a coin detail block with links and descriptions.

Use cases

You need to	How this Actor does it
Rank the market by more than cap	Sort by volume, 24h change or listing date and read rank
Spot a thin float	Compare marketCap against fullyDilutedValuation
Track Bitcoin dominance	Read dominance on each run and chart it
Separate coins from tokens	Set the crypto type and sweep only one of them
Follow the story on a coin	Switch to news mode and read headline, publisher and datePublished
Feed a crypto research agent	Call the Actor over MCP and let the model ask for the coin it needs

Quick start

1. Click Try for free.
2. Add CoinMarketCap slugs, one per line: bitcoin, ethereum, solana. These are the slugs in the coin URL, not tickers. Leave the field empty to sweep the top of the market.
3. Leave Mode on market, or switch it to news.
4. Set Convert if you want something other than USD, and choose a Sort by for a sweep.
5. Click Start. Rows appear within seconds.
6. Export as JSON, CSV, Excel or XML, or read the dataset over the API.

Input

Field	Type	Default	What it controls
slugs	array	empty	CoinMarketCap slugs to read. Empty sweeps the market by the chosen sort
mode	string	market	market returns a record per coin, news a record per story
newsPerCoin	integer	10	Stories per coin in news mode
convert	string	USD	The quote currency code. convertId takes CoinMarketCap's numeric id instead
sortBy	string	market_cap	Sweep order: cap, 24h volume, price, 24h or 7d change, or listing date
sortType	string	desc	Ascending or descending
cryptoType	string	all	Restricts a sweep to coins only or tokens only
includeCoinDetail	boolean	false	Adds links and the project description
includeHistory	boolean	false	Adds a price series for the trailing window
maxItems	integer	100	Caps how many coins are read

{
    "slugs": [
        "bitcoin",
        "ethereum",
        "solana"
    ],
    "mode": "market",
    "convert": "USD",
    "maxItems": 100
}

Output

One dataset item per coin in market mode, one per story in news mode. Fields CoinMarketCap does not publish for a coin are dropped rather than returned as null.

Field group	Fields
Identity	status, slug, symbol, name, rank, url
Price	value, convert, percentChange24h, percentChange7d, percentChange30d
Market	marketCap, fullyDilutedValuation, volume24h, dominance
Supply	circulatingSupply, totalSupply, maxSupply
Extremes	ath, athDate, atl, atlDate
News mode	headline, publisher, datePublished, url
Timing	validFrom, scrapedAt

{
    "status": "ok",
    "slug": "bitcoin",
    "symbol": "BTC",
    "name": "Bitcoin",
    "rank": 1,
    "value": 104238.61,
    "convert": "USD",
    "percentChange24h": -1.84,
    "percentChange7d": 3.12,
    "marketCap": 2068442110394,
    "fullyDilutedValuation": 2188010810000,
    "volume24h": 41220118844,
    "dominance": 56.81,
    "circulatingSupply": 19842193.0,
    "maxSupply": 21000000.0,
    "validFrom": "2026-09-04T20:00:01.000Z",
    "url": "https://coinmarketcap.com/currencies/bitcoin/"
}

What does news mode return?

mode: "news" returns the stories CoinMarketCap carries for each coin you named: headline, publisher, datePublished and url, plus the slug the story was found under so rows join back to the market records. News is charged as news items rather than as market records, and News per coin sets how many stories each coin returns.

Integrations

Run it over the API and get the rows back in one call:

curl -X POST "https://api.apify.com/v2/acts/publicmoney~coinmarketcap-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"slugs": ["bitcoin", "ethereum", "solana"], "mode": "market", "convert": "USD", "maxItems": 100}'

From Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("publicmoney/coinmarketcap-scraper").call(run_input={"slugs": ["bitcoin", "ethereum", "solana"], "mode": "market", "convert": "USD", "maxItems": 100})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["symbol"], item["name"], item["value"])

Give an AI agent the Actor over MCP:

{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com/?actors=publicmoney/coinmarketcap-scraper"
        }
    }
}

Schedules run it on any cron, webhooks fire when a run finishes, and platform integrations push the dataset to Google Sheets, Slack, Airtable, Zapier or your own endpoint.

Cost

Pay per event, so you pay for records rather than compute time.

Event	Free tier	Top volume tier
Record with data	$0.002	$0.0007
News article	$0.001	$0.00035
Actor start	$0.00005 per GB	Same

A record that returned no data is published as a failure row and is never charged. Six volume tiers apply, so the per-record price falls with monthly volume.

Troubleshooting

Issue	Solution
A coin returns failed	You sent a ticker instead of a CoinMarketCap slug. It is bitcoin, not BTC. The slug is in the coin's URL.
I get far more rows than I expected	The coin list was left empty, so the Actor swept the market. Set Max items or name the coins.
dominance is missing	CoinMarketCap publishes dominance only for the largest assets. Smaller coins carry none.
fullyDilutedValuation equals marketCap	The whole supply is already circulating, so there is no dilution left. That is correct, not a bug.
News mode returns nothing for a coin	CoinMarketCap carries no stories for that coin right now. Market mode still works for it.

FAQ

Is the CoinMarketCap API free?

CoinMarketCap gates every tier behind a key and the free plan is capped at a few hundred calls a month. This Actor needs no CoinMarketCap key at all and is charged per record instead.

What is a CoinMarketCap slug?

The identifier in the coin's CoinMarketCap URL, which is not the ticker. Bitcoin is bitcoin, Polygon is polygon-ecosystem-token.

What is fully diluted valuation?

The market cap the coin would have if the entire supply were circulating. When it is far above marketCap, a large share of tokens has yet to unlock.

Is there a CoinMarketCap news API?

mode: "news" is the closest thing, returning the stories CoinMarketCap carries per coin with headline, publisher, date and URL, charged as news items.

Can I get the whole market instead of a list?

Yes. Leave the coin list empty and the Actor sweeps the market in the order you choose, capped by Max items, optionally restricted to coins or tokens.

Do I need a CoinMarketCap API key?

No. You need an Apify token to call the Actor over the API. No CoinMarketCap credential is involved anywhere.

Can I get this data in Python?

Yes, with the apify-client package as shown above. It returns parsed JSON, so there is no HTML or response handling on your side.

Can I get the data into Excel or Google Sheets?

Yes. Export the dataset as XLSX or CSV, or connect the Google Sheets integration so each run appends to a sheet.

Can an AI agent call this Actor?

Yes. Add it to an MCP client with the config above and the model can request what it needs on its own. Every record is flat JSON with named fields, so no post-processing is needed.

Is it legal to scrape CoinMarketCap?

This Actor reads public CoinMarketCap data that needs no login and collects no personal data. Scraping public data is generally lawful, and how you store, redistribute or act on market data is governed by your own agreements and local rules. Take your own legal advice for your use case.

Changelog

• 0.0.2 Added news mode, dominance, fully diluted valuation and optional history.
• 0.0.1 First release. Market data for any coin or the top of the market.

Feedback

Found a field CoinMarketCap publishes that this Actor misses, or an input it rejects? Open an issue on the Issues tab with the input and what you expected. A daily test runs every Actor in the fleet against live sources, so parser fixes ship fast.