CoinGecko Scraper — Crypto Market Data

Full crypto market data from CoinGecko in one keyless actor — price, market-cap rank, volume, 24h/7d/30d change, all-time high/low, circulating/total/max supply, and optional daily price history. For the top coins, specific coin ids, or a whole category. Priced in any fiat or crypto currency.

For portfolio trackers, dashboards, trading bots, research and crypto apps.

What you get

Per coin:

• Identity — id, symbol, name, image, CoinGecko url
• Market — rank, price, marketCap, fullyDilutedValuation, totalVolume
• Movement — high24h, low24h, priceChange24h, priceChangePct24h, priceChangePct7d, priceChangePct30d
• Supply — circulatingSupply, totalSupply, maxSupply
• Extremes — ath, athChangePct, athDate, atl, atlDate, lastUpdated
• History (optional) — nested history[] of { date, price, totalVolume, marketCap } daily points

Output sample

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "rank": 1,
  "price": 68250.12,
  "marketCap": 1348000000000,
  "fullyDilutedValuation": 1432000000000,
  "totalVolume": 24500000000,
  "high24h": 69100.0,
  "low24h": 67200.0,
  "priceChange24h": 820.5,
  "priceChangePct24h": 1.22,
  "priceChangePct7d": -3.41,
  "priceChangePct30d": 8.9,
  "circulatingSupply": 19750000,
  "totalSupply": 21000000,
  "maxSupply": 21000000,
  "ath": 73738.0,
  "athChangePct": -7.4,
  "athDate": "2024-03-14T07:10:36.635Z",
  "atl": 67.81,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "lastUpdated": "2026-07-12T12:00:00.000Z",
  "image": "https://.../bitcoin.png",
  "url": "https://www.coingecko.com/en/coins/bitcoin",
  "history": [
    { "date": "2026-06-12T00:00:00.000Z", "price": 62700.0, "totalVolume": 21000000000, "marketCap": 1240000000000 }
  ]
}

history is present only when includeHistory is on.

Input

Field	Type	Default	Description
vsCurrency	string	usd	Quote currency, e.g. usd, eur, btc
coinIds	array	—	Specific coin ids (e.g. bitcoin); empty = top coins by order
category	string	—	CoinGecko category id, e.g. layer-1, meme-token
order	string	market_cap_desc	market_cap_desc/asc, volume_desc/asc, id_asc
includeHistory	boolean	false	Also fetch each coin's daily price history
historyDays	integer	30	Days of history when enabled (e.g. 7, 30, 90, 365)
maxResults	integer	100	Cap on coins returned

Example input

{
  "vsCurrency": "usd",
  "coinIds": ["bitcoin", "ethereum", "solana"],
  "includeHistory": true,
  "historyDays": 90
}

Why this actor

• More than a screener — market-cap rankings, supply figures, ATH/ATL and per-coin price history in one actor.
• Flexible targeting — top-N, specific coins, or a category; any fiat/crypto quote currency.
• Reliable — handles CoinGecko's free-tier rate limits with throttling and 429 backoff.

Pricing

Pay per result — $2.00 per 1,000 results (one result = one coin, with history nested). No subscription; you pay only for what you get.

Notes & limits

• Uses CoinGecko's free public API, which is rate-limited; enabling includeHistory adds one throttled request per coin (slower).
• Market data reflects CoinGecko at fetch time and changes constantly. Not financial advice; not affiliated with CoinGecko.

Related actors

• TradingView Screener — stocks/crypto/forex technical scanner.
• Yahoo Finance Scraper — historical OHLCV price data.
• SEC EDGAR Scraper — US public-company filings.