CoinGecko Crypto Market Scraper

Pull live cryptocurrency market data from the public CoinGecko API — no API key, no login. Get the top coins by market cap, search by name or symbol, or fetch specific coins by id.

Modes

Mode	What it does
markets	Top coins ranked by market cap. Paginates 250 per request up to your maxItems.
search	Look up coins by name/symbol. Returns lighter rows (id, name, symbol, rank).
coins	Fetch a specific set of coins by their CoinGecko id.

What you get per coin (markets / coins)

id, symbol, name, price, marketCap, marketCapRank, volume24h, change24hPct, change7dPct, circulatingSupply, ath, athDate, atl, image, and url (the coin's CoinGecko page).

Search rows are lighter: id, name, symbol, marketCapRank, image, url. They do not include price, market cap, volume or change fields — use markets or coins mode for those.

Numeric fields (price, marketCap, marketCapRank, volume24h, change24hPct, change7dPct, circulatingSupply, ath, atl) and image can be null when CoinGecko doesn't report them for a given coin or currency.

Input

Field	Notes
mode	markets (default), search, or coins.
vsCurrency	Quote currency for prices/market cap/volume, e.g. usd, eur, btc. Used by markets & coins.
query	Search term (Search mode), e.g. solana.
coinIds	List of CoinGecko ids (Coins mode), e.g. ["bitcoin","ethereum"]. The id is the slug in a coin's URL.
maxItems	Max coins in Markets mode.

Output

One dataset row per coin, deduped by id. Inputs that match nothing return a single note row and are not charged.

Examples

{ "mode": "markets", "vsCurrency": "usd", "maxItems": 100 }

{ "mode": "search", "query": "solana" }

{ "mode": "coins", "vsCurrency": "eur", "coinIds": ["bitcoin", "ethereum", "solana"] }

Notes

This actor uses CoinGecko's free public API, which is rate-limited (roughly 10–30 requests/minute). On an HTTP 429 the actor backs off generously (honoring Retry-After, up to ~60s) and retries rather than failing. For bulk runs (e.g. >1000 coins) this backoff can cost extra run time, so for heavy use either space your runs out or enable a proxy.

Proxy is optional. The public API needs no proxy or login, so it is off by default and you should leave it off for normal use. Only enable Apify Proxy if you repeatedly hit IP-based 429 rate limits on large runs — it can spread requests across IPs, but it consumes metered proxy credit and gives no anti-bot benefit here.

Pricing & troubleshooting

Billing is pay-per-result: you are charged one event per coin row returned. Diagnostic rows (ok:false, e.g. NO_RESULTS, BAD_INPUT, RATE_LIMITED) are never charged. If a run returns only a diagnostic row, read its errorCode and error/hint fields — BAD_INPUT means a mode/query/id was missing or invalid, and RATE_LIMITED means CoinGecko throttled the run (retry later or enable a proxy).