CoinMarketCap Crypto Scraper

Pull complete, up-to-date metrics for any cryptocurrency on CoinMarketCap — price, market cap, supply, ATH / ATL, audits, socials, official links, and tags — either for a specific list of coins or for the top N by market cap.

What this actor does

CoinMarketCap is the de facto reference for cryptocurrency market data, covering thousands of coins across every major chain. This actor reads the data that's rendered on each coin's public page and returns a clean, structured record per coin — identity, prices in USD / BTC / ETH, 24h / 7d / 30d / 90d / 1y price changes, circulating / total / max supply, all-time high and low with timestamps, the full links block (websites, explorers, source code, socials), tags, and security-audit history.

You can either supply a specific list of coin slugs (or common tickers like BTC, ETH, SOL, which are accepted as a convenience) or leave the list empty and ask for the top N coins by market cap. The actor will work through each coin, emit one record per coin to the dataset, and never crash the whole run if a single coin fails — it emits a per-coin error record instead.

No API key, no paid plan, no login. Free-tier CoinMarketCap API quotas are irrelevant: the actor reads only publicly rendered pages.

Key features

• Two input modes — a specific list of coins (coinSlugs) or the top N by market cap (topN)
• Accepts coin slugs, common tickers (BTC, ETH, SOL), or full coin URLs interchangeably
• Complete metrics: price, market cap, dominance, 24h / 7d / 30d / 90d / 1y changes, volume, supply, ATH / ATL with dates
• Official link block: websites, block explorers, source code, full social map (Twitter, Reddit, Telegram, Discord, Facebook, Instagram, etc.)
• Optional security-audit history per coin
• Tags / categorization (e.g. mineable, pow, defi, layer-1)
• Per-coin error records — a bad slug never kills the whole run
• Transparent residential-proxy fallback — direct requests first, proxy only when blocked
• No API key, no login, no cookies
• Zero-null output — empty fields are omitted from each record

Input

Field	Type	Default	Description
coinSlugs	string[]	["bitcoin","ethereum","solana"]	List of coins to scrape. Accepts CoinMarketCap slugs (e.g. bitcoin), common tickers (BTC), or full URLs.
topN	integer	20	When coinSlugs is empty, scrape the top N coins by market cap (max 500).
includeAuditInfo	boolean	true	Include the per-coin security-audit list.
autoProxyFallback	boolean	true	Automatically retry through Apify residential proxy when a page looks blocked.

Example input — specific coins

{
  "coinSlugs": ["bitcoin", "ethereum", "solana"],
  "includeAuditInfo": true,
  "autoProxyFallback": true
}

Example input — top 50 by market cap

{
  "topN": 50
}

Output

One record per coin. Fields without data are omitted.

{
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "cmcRank": 1,
  "priceUsd": 67890.12,
  "priceBtc": 1.0,
  "priceEth": 20.5,
  "marketCapUsd": 1340000000000,
  "marketCapDominance": 52.5,
  "volumeUsd24h": 32000000000,
  "percentChange1h": 0.15,
  "percentChange24h": -1.23,
  "percentChange7d": 4.56,
  "percentChange30d": 8.9,
  "percentChange90d": 14.2,
  "percentChange1y": 112.4,
  "circulatingSupply": 19700000,
  "totalSupply": 19700000,
  "maxSupply": 21000000,
  "allTimeHighUsd": 73750.07,
  "allTimeHighDate": "2024-03-14T07:10:00+00:00",
  "allTimeLowUsd": 0.0486,
  "allTimeLowDate": "2013-07-05T00:00:00+00:00",
  "dateAdded": "2013-04-28T00:00:00+00:00",
  "lastUpdated": "2026-04-24T11:59:30+00:00",
  "websites": ["https://bitcoin.org/"],
  "explorers": ["https://blockchain.info/", "https://mempool.space/"],
  "sourceCode": ["https://github.com/bitcoin/bitcoin"],
  "socialLinks": {
    "twitter": "https://twitter.com/bitcoin",
    "reddit": "https://reddit.com/r/bitcoin"
  },
  "audits": [
    {"name": "Example Audit Firm", "status": "Passed", "completionDate": "2024-01-10", "reportUrl": "https://..."}
  ],
  "tags": ["mineable", "pow", "sha-256", "store-of-value"],
  "scrapedAt": "2026-04-24T12:00:00+00:00"
}

Field descriptions

• Identity — id, name, symbol, slug, cmcRank
• Price — priceUsd, priceBtc, priceEth
• Market — marketCapUsd, marketCapDominance, volumeUsd24h
• Changes — percentChange1h, percentChange24h, percentChange7d, percentChange30d, percentChange90d, percentChange1y
• Supply — circulatingSupply, totalSupply, maxSupply
• History — allTimeHighUsd + allTimeHighDate, allTimeLowUsd + allTimeLowDate, dateAdded, lastUpdated
• Links — websites, explorers, sourceCode, socialLinks (flat map by platform)
• Security — audits (list of {name, status, completionDate, reportUrl})
• Categorization — tags
• scrapedAt — ISO-8601 timestamp of this run

Error record — emitted per-coin when scraping fails; the run continues:

{
  "type": "coinmarketcap_scraper_error",
  "slug": "nonexistent-coin",
  "reason": "fetch_failed",
  "message": "Could not fetch coin page for slug 'nonexistent-coin'.",
  "scrapedAt": "2026-04-24T12:00:00+00:00"
}

Use cases

• Portfolio dashboards — nightly refresh of prices, market caps, and 24h changes for a watchlist
• Research and due diligence — pull audits, socials, source-code links, and tags for a shortlist of tokens
• Market-structure analysis — scrape the top N coins to study dominance, supply schedules, and volume distribution
• Competitive mapping — filter the top 500 by tags (e.g. all defi or all layer-2) and compare key metrics
• Trading backtests — seed a historical dataset with ATH / ATL timestamps and current supply for fundamentals-driven strategies

FAQ

Do I need a CoinMarketCap API key? No. The actor uses only the publicly rendered data on CoinMarketCap's coin pages — no API plan needed.

Does it work for every coin listed on CoinMarketCap? Yes, provided CoinMarketCap exposes a /currencies/<slug>/ page for it. You can find a coin's slug in the URL of its page on CoinMarketCap.

What do I put in coinSlugs? The slug segment from the coin's CoinMarketCap URL (e.g. bitcoin, ethereum, solana). Common tickers (BTC, ETH, SOL) and full CoinMarketCap URLs are also accepted as a convenience.

How do I scrape the top coins without listing them? Leave coinSlugs empty and set topN — the actor will read the top N coins by market cap from the CoinMarketCap ranking and scrape each in turn.

How fresh is the data? As fresh as what's on CoinMarketCap — typically updated every few minutes.

Why are some fields missing on some coins? CoinMarketCap doesn't publish a fixed supply, audit report, or every social link for every project. The scraper omits fields that have no data so every key in the record is real.

What happens when one coin fails? The actor emits a per-coin error record and keeps going with the rest of the list — you'll never lose an entire run because one slug is wrong.

How does the proxy fallback work? If CoinMarketCap returns a challenge page or an empty response to the direct request, the actor transparently retries through Apify residential proxy. Set autoProxyFallback: false to skip the retry.

Known limitations

• No historical OHLCV. This actor returns current snapshot values plus rolling percent changes. For minute-by-minute historical candles you want a dedicated market-data feed.
• Audit data is sparse. CoinMarketCap only lists audits that projects have submitted; most small-cap tokens have no audit block.
• Social-link coverage varies. Many projects only advertise Twitter and Telegram; Discord / Reddit / Facebook links appear when the project registers them.
• Rate spikes on CoinMarketCap. During extreme market events CoinMarketCap occasionally serves a challenge page; the residential-proxy fallback handles most of those, but very long runs may still see a handful of per-coin error records.
• Top-N is capped at 500. For broader coverage split the work into multiple runs by explicit slug list.