CoinGecko Scraper - Crypto Prices & Market Rankings

Pull CoinGecko's crypto prices and rankings as rows: the top of the market by market cap, a coin looked up by name or symbol, or exactly the coins you name. Each row carries price, market cap, rank, 24 hour volume, 24 hour and 7 day change, circulating supply, all-time high and low, the logo and the CoinGecko page link.

It is a snapshot of right now. No candles, no history, nothing older than the moment the run executed. And the data describes the market; it is not advice about it.

Input	A mode, plus a search term, a list of coin ids, or a category
Output	One row per coin: price, market cap, rank, 24h volume, 24h and 7d change, supply, all-time high and low, logo, link
Ceiling	5,000 coins per run in Markets mode
Account needed	None, and no API key
Price	$2.00 per 1,000 coins, flat on every plan. The free plan's $5 a month covers about 2,500

🔍 What CoinGecko Scraper does

Three modes, and picking the wrong one is the usual reason a row looks thin:

Mode	What it returns	Fields
markets	The top coins ranked by market cap, or by volume or id, from everything or from one category	the full row
search	Coins matching a name or symbol	id, name, symbol, rank, image, url. No prices
coins	Exactly the ids you name	the full row

search is how you find a coin's id when you do not know it. Take the id from the search row and feed it into coins mode for the numbers.

Prices are quoted in whatever vsCurrency you set, so the same coin can come back in usd, eur or btc.

📋 What data you get from each coin

What you get	Field
CoinGecko's id for the coin, its symbol and name	id, symbol, name
Price, market cap and rank	price, marketCap, marketCapRank
Volume over the last 24 hours	volume24h
Price change over 24 hours and 7 days	change24hPct, change7dPct
Coins in circulation	circulatingSupply
All-time high with its date, and all-time low	ath, athDate, atl
The logo and the CoinGecko page	image, url

▶️ How to scrape CoinGecko

1. Open CoinGecko Scraper and click Try for free.
2. Pick a Mode. markets for the leaderboard, search to find an id, coins for a watchlist.
3. Set Quote currency, then fill the box your mode uses: Search query or Coin ids.
4. In Markets mode set Max coins, then click Start.
5. Download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost to scrape CoinGecko?

$2.00 per 1,000 coins. Flat on every Apify plan, no volume tiers. On the free plan, the $5 Apify gives you each month covers about 2,500 coins.

You pay per coin row delivered. Duplicate ids are dropped before they reach you, diagnostic rows are not charged, and if nothing matches, no rows are charged. A search row costs the same as a full row even though it carries fewer fields, so use search to find ids and coins to pull the numbers. Set a maximum cost on the run and it stops when it gets there.

📥 What you give it

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

Field	Default	What it is
mode	markets	markets, search or coins. Lower case only, Markets is rejected.
vsCurrency	usd	What prices, market cap and volume are quoted in. usd, eur, gbp, btc, eth and the rest. Used by markets and coins.
query	none, the form starts with solana	A coin name or symbol. search mode only.
coinIds	none, the form starts with bitcoin and ethereum	CoinGecko ids, which are the slugs in a coin's CoinGecko URL. coins mode only.
category	none	Only the coins CoinGecko files under one category, by the id at the end of its CoinGecko page (meme-token, layer-1) or the name that page shows (Meme). markets mode only. An unknown category is refused before any coin is read.
order	market_cap_desc	market_cap_desc, market_cap_asc, volume_desc, volume_asc, id_asc or id_desc. In markets mode the run takes the first maxItems coins in this order. Works in coins mode too.
maxItems	100	Coins to return in markets mode, up to 5,000.
notionConnector	none	Optional. Writes every coin into your own Notion as well as the dataset.
notionParentId	none	Optional. The Notion data source to write into.
proxyConfiguration	off	Optional, and off by default because a normal run does not need it.

Keep coinIds lists modest. A long list goes to CoinGecko in one request and can come back shorter than you asked for, with the missing coins simply absent. Split a big list across runs and count the rows.

📤 What you get back

A real row from a run on 2 October 2026:

{
  "ok": true,
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "price": 84513,
  "marketCap": 1698078115337,
  "marketCapRank": 1,
  "volume24h": 45537287109,
  "change24hPct": -0.18692,
  "change7dPct": 0.8945,
  "circulatingSupply": 20092587,
  "ath": 126080,
  "athDate": "2025-10-06T10:57:42.000Z",
  "atl": 67.81,
  "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
  "url": "https://www.coingecko.com/en/coins/bitcoin"
}

Field	How to read it
id	The CoinGecko slug. This is the key for coins mode and your join key across runs.
price, marketCap, volume24h	Quoted in your vsCurrency.
change24hPct, change7dPct	Percentages, already signed. -0.18692 means down about a fifth of a percent, not 18%.
ath, athDate, atl	All-time high with its date, and all-time low. There is no date for the low.
symbol	Upper-cased, so BTC rather than btc.
image	The logo. On search rows it is the small thumbnail; elsewhere the larger file.

A search row has six fields only: id, name, symbol, marketCapRank, image and url. No price, no market cap, no volume. Any numeric field can be null when CoinGecko has no value for that coin.

🧾 Reading the output

Two kinds of row can land in your dataset.

Row	How to spot it	Billed
A coin	ok: true and an id	yes
A diagnostic	ok: false and an errorCode	no

Code	What it means
BAD_INPUT	The mode was not one of the three, search had no query, coins had no ids, or a category or order was unknown or set in a mode it does not apply to. Nothing was read.
NO_RESULTS	Nothing matched. A currency code CoinGecko does not support lands here too, rather than complaining about the currency, so check vsCurrency first when a Markets run comes back empty.
RATE_LIMITED	CoinGecko asked for a slower pace. A very large sweep can hit it; split it across runs.
SERVER_ERROR	CoinGecko answered with a server error. Usually passes on its own.
NOT_FOUND	CoinGecko answered 404 for the request.
BLOCKED	CoinGecko would not serve the request this time.
NETWORK	CoinGecko could not be reached.

The default table view hides id, which is the field search mode exists to give you, along with volume, 7 day change, supply and the all-time figures. Switch to All fields or export as JSON.

💡 What people use it for

• Snapshotting the top 250 by market cap on a schedule, to build your own history.
• Following one corner of the market, the meme coins or the layer-1 chains, with category.
• Refreshing a watchlist of a dozen ids every few minutes for a dashboard.
• Finding the right CoinGecko id for a ticker before wiring it into something else.

From a coin name to a watchlist, in three runs:

1. Run search mode with the name or ticker in query, and copy the id you meant.
2. Put the ids you want into coinIds and set mode to coins.
3. Schedule that run and keep every dataset. Together they are the price history this actor does not give you in one go.

🚧 What it does not do

• No history and no candles. One snapshot per run. If you want a series, schedule it and keep the rows.
• search has no prices. Six fields, by design. Take the id and run coins mode.
• Unknown ids vanish silently. A misspelled id in coins mode produces no row and no warning, so compare the row count against your list.
• No exchanges, no order books, no trading pairs, no on-chain data, no NFTs.
• mode is case-sensitive. Markets is rejected as bad input.
• One category per run, in markets mode only. CoinGecko answers a category plus a list of ids with the whole category, so coins mode refuses one.
• No date for the all-time low, only for the high. That is what CoinGecko publishes.
• Large sweeps are slow. CoinGecko limits how fast anyone can ask, and the run waits rather than hammering it.
• Markets mode writes nothing until it finishes, so a 5,000-coin run shows an empty dataset until the last page is in.

🧭 Which market data scraper do you need?

If you want	Use
Stock, ETF, index, FX and crypto quotes with daily price history	Yahoo Finance Scraper
Coin prices, market caps and rankings	This one
Price, liquidity and volume of a DEX trading pair	DexScreener Pair Price & Liquidity Scraper
The daily Crypto Fear and Greed reading, back to 2018	Crypto Fear and Greed Index Scraper
Large Polymarket trades and the wallets behind them	Polymarket Whale Tracker
Company filings by keyword, ticker or CIK	SEC EDGAR Scraper
Stock trades members of Congress disclose	Congress Stock Trades Scraper
Indian mutual fund NAVs, today's or back to 2010	Indian Mutual Fund NAV Scraper

❓ Questions people ask

Do I need a CoinGecko API key?

No. There is nothing to sign up for.

Where do I find a coin id?

In its CoinGecko URL, or run search mode and read id off the row.

Why has my row got no price?

You are in search mode. Switch to coins with the same id.

How fresh are the prices?

They are what CoinGecko had at the moment of the run. Schedule the actor if you need them to keep updating.

Why did I get fewer coins than ids I listed?

Either an id was wrong, or the list was long enough to be cut short on CoinGecko's side. Split it and run again.

Can I call it from code or connect it to an AI assistant?

Yes. The API tab has ready-made code for Python, JavaScript and the command line. For Claude, ChatGPT or another MCP client, connect https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/coingecko-scraper. Either way the run happens on your Apify account at the same price.

Is scraping CoinGecko legal?

These are public market figures, and the data is about coins rather than people. Check CoinGecko's terms for how you may redistribute it. Apify's write-up on the legality of web scraping is a good starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID, the mode and the currency you used. The errorCode and hint on the diagnostic row usually name the problem on their own.