CoinGecko Scraper

Scrape live crypto data from CoinGecko — no browser, no headless Chrome, just clean API data.

Supports three modes:

• Markets — coin prices, market caps, volumes, ATH/ATL, and price change % across any time interval
• Trending — the 15 coins trending on CoinGecko right now
• Global — total market cap, 24h volume, BTC/ETH dominance, active cryptocurrency count

No API key required for basic use. Add a free CoinGecko Demo API key for higher rate limits.

Use Cases

• Portfolio tracking dashboards
• Price alert pipelines (connect to Zapier/Make)
• Daily crypto newsletters and digests
• Market research and data analysis
• Altcoin screeners by category (DeFi, L1/L2, NFT tokens, etc.)

Input

Field	Type	Default	Description
mode	string	markets	markets, trending, or global
vsCurrency	string	usd	Price currency (usd, eur, btc, eth, etc.)
coinIds	string[]	[]	Filter to specific coins by CoinGecko ID (e.g. bitcoin, ethereum). Empty = all
category	string	—	CoinGecko category slug (e.g. decentralized-finance-defi, layer-1)
order	string	market_cap_desc	Sort order for markets mode
maxResults	integer	100	Max coins to return (markets mode only, up to 5000)
includeSparkline	boolean	false	Include 7-day sparkline price array
priceChangePercentages	string[]	["24h"]	Price change % intervals: 1h, 24h, 7d, 14d, 30d, 1y
apiKey	string	—	CoinGecko Demo API key (optional, for higher rate limits)

Output — Markets Mode

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "image": "https://...",
  "currentPrice": 67842,
  "marketCap": 1337000000000,
  "marketCapRank": 1,
  "fullyDilutedValuation": 1424000000000,
  "totalVolume": 28500000000,
  "high24h": 68100,
  "low24h": 66500,
  "priceChange24h": 450.12,
  "priceChangePercentage24h": 0.67,
  "marketCapChange24h": 8900000000,
  "marketCapChangePercentage24h": 0.67,
  "circulatingSupply": 19700000,
  "totalSupply": 21000000,
  "maxSupply": 21000000,
  "ath": 73738,
  "athChangePercentage": -7.99,
  "athDate": "2024-03-14T07:10:36.635Z",
  "atl": 67.81,
  "atlChangePercentage": 99900.12,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "lastUpdated": "2024-10-20T12:00:00.000Z"
}

Output — Trending Mode

{
  "id": "solana",
  "name": "Solana",
  "symbol": "SOL",
  "marketCapRank": 5,
  "score": 0,
  "thumb": "https://...",
  "large": "https://...",
  "priceChange24h": 3.21,
  "marketCap": "$76.5 B"
}

Output — Global Mode

{
  "activeCryptocurrencies": 15230,
  "markets": 1120,
  "totalMarketCap": { "usd": 2650000000000, "btc": 38900, "eth": 890000 },
  "totalVolume": { "usd": 98000000000 },
  "marketCapPercentage": { "btc": 56.2, "eth": 13.1 },
  "marketCapChangePercentage24hUsd": 1.23,
  "updatedAt": "2024-10-20T12:00:00.000Z"
}

Rate Limits

CoinGecko's free (public) API allows ~30 requests/minute. This Actor automatically handles rate limiting with retries and delays.

For higher limits, get a free Demo API key at coingecko.com and pass it as apiKey.

Category Slugs

Popular CoinGecko category slugs for the category input:

• decentralized-finance-defi — DeFi
• layer-1 — L1 blockchains
• layer-2 — L2 / rollups
• non-fungible-tokens-nft — NFT tokens
• artificial-intelligence — AI coins
• real-world-assets-rwa — RWA
• meme-token — Meme coins
• gaming — GameFi

Find all category slugs via the CoinGecko API: /api/v3/coins/categories/list