CoinGecko Scraper

CoinGecko's free API is rate limited hard enough that a watchlist sweep trips it, and the Pro plan starts where hobby projects stop. This Actor reads CoinGecko market data for any coin and returns one structured record: price in the currency you ask for, market cap and rank, 24h volume, supply, all-time high and low, and percent change across several windows. Leave the coin list empty and it sweeps the top of the market by cap instead.

What it does

• Returns one record per coin, in order. A coin id CoinGecko does not know comes back with status: "failed" and a reason.
• Sweeps the market when you leave the coin list empty, ordered by market cap, volume or id, so you do not need to know the ids in advance.
• Filters by category (layer-1, decentralized-finance-defi, meme-token and the rest), which is the fastest way to price a sector.
• Prices in any currency CoinGecko supports, not just USD, so eur, gbp, jpy, btc and eth all work as the quote.
• Carries the all-time high and low with the percent change from each, which is the context a bare price is missing.
• Optional price history (up to the days you ask for) and a coin profile with links, categories and descriptions.
• Takes an optional Pro API key. Supply one and the run switches to the Pro endpoint with its higher limit; leave it empty and the public API is used.

Use cases

You need to	How this Actor does it
Price a whole portfolio in EUR	Pass your coin ids and set the quote currency to eur
Rank a sector	Set a category and order by market cap, then read marketCapRank
Find how far a coin is off its high	Read ath and athChangePercentage in the same record
Screen for supply scarcity	Compare circulatingSupply against maxSupply
Feed a crypto research agent	Call the Actor over MCP and let the model ask for the coin or category it needs
Track a market every hour	Schedule the run and let the dataset accumulate a row per coin per run

Quick start

1. Click Try for free.
2. Add CoinGecko coin ids, one per line: bitcoin, ethereum, solana. These are ids, not tickers, so it is bitcoin rather than BTC. Leave the field empty to sweep the top of the market instead.
3. Set Quote currency if you want something other than usd.
4. Optionally set a Category to price one sector, and raise or lower Max items.
5. Click Start. Rows appear within seconds.
6. Export as JSON, CSV, Excel or XML, or read the dataset over the API.

Input

Field	Type	Default	What it controls
coinIds	array	empty	CoinGecko coin ids to read. Empty sweeps the market by the chosen order
vsCurrency	string	usd	The quote currency. Any CoinGecko-supported code, including btc and eth
category	string	empty	Restricts a market sweep to one CoinGecko category
order	string	market_cap_desc	Sweep order: market cap, volume or id, ascending or descending
includeCoinProfile	boolean	false	Adds links, categories and the project description
includeHistory	boolean	false	Adds a price series for the trailing window
historyDays	integer	30	How many days of history to include
maxItems	integer	100	Caps how many coins are read
apiKey	string	empty	Optional CoinGecko Pro key. Raises the rate limit and switches to the Pro endpoint

{
    "coinIds": [
        "bitcoin",
        "ethereum",
        "solana"
    ],
    "vsCurrency": "usd",
    "maxItems": 100
}

Output

One dataset item per coin. Fields CoinGecko does not publish for a coin are dropped rather than returned as null, and profile and history fields appear only when you ask for them.

Field group	Fields
Identity	status, coinId, symbol, name, marketCapRank, url
Price	value, vsCurrency, priceChangePercentage24h, priceChangePercentage7d, priceChangePercentage30d
Market	marketCap, volume24h, fullyDilutedValuation
Supply	circulatingSupply, totalSupply, maxSupply
Extremes	ath, athDate, athChangePercentage, atl, atlDate, atlChangePercentage
Optional	profile, priceHistory
Timing	validFrom, scrapedAt

{
    "status": "ok",
    "coinId": "bitcoin",
    "symbol": "BTC",
    "name": "Bitcoin",
    "marketCapRank": 1,
    "value": 104238.61,
    "vsCurrency": "usd",
    "priceChangePercentage24h": -1.84,
    "marketCap": 2068442110394,
    "volume24h": 41220118844,
    "circulatingSupply": 19842193.0,
    "maxSupply": 21000000.0,
    "ath": 126198.0,
    "athChangePercentage": -17.4,
    "validFrom": "2026-09-04T20:00:01.000Z",
    "url": "https://www.coingecko.com/en/coins/bitcoin"
}

Integrations

Run it over the API and get the rows back in one call:

curl -X POST "https://api.apify.com/v2/acts/publicmoney~coingecko-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"coinIds": ["bitcoin", "ethereum", "solana"], "vsCurrency": "usd", "maxItems": 100}'

From Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("publicmoney/coingecko-scraper").call(run_input={"coinIds": ["bitcoin", "ethereum", "solana"], "vsCurrency": "usd", "maxItems": 100})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["symbol"], item["name"], item["value"])

Give an AI agent the Actor over MCP:

{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com/?actors=publicmoney/coingecko-scraper"
        }
    }
}

Schedules run it on any cron, webhooks fire when a run finishes, and platform integrations push the dataset to Google Sheets, Slack, Airtable, Zapier or your own endpoint.

Cost

Pay per event, so you pay for records rather than compute time.

Event	Free tier	Top volume tier
Record with data	$0.002	$0.0007
Actor start	$0.00005 per GB	Same

A record that returned no data is published as a failure row and is never charged. Six volume tiers apply, so the per-record price falls with monthly volume.

Troubleshooting

Issue	Solution
A coin returns failed	You sent a ticker instead of a CoinGecko id. It is bitcoin, not BTC. The id is in the coin's CoinGecko URL.
I get far more rows than I expected	The coin list was left empty, so the Actor swept the market. Set Max items or name the coins.
maxSupply is missing	CoinGecko publishes no max supply for coins that have none, such as Ethereum. That is the source, not a gap.
The run is rate limited	The public CoinGecko API has a low limit. Supply a Pro key to switch to the Pro endpoint, or lower Max items.
A category returns nothing	Category ids are CoinGecko's own slugs, such as decentralized-finance-defi. Check the spelling on their categories page.

FAQ

Is the CoinGecko API free?

CoinGecko has a free public tier with a low rate limit and a paid Pro tier. This Actor works against the public tier with no key, and if you have a Pro key you can supply it to raise the limit. The Actor itself is charged per record.

What is a CoinGecko coin id?

CoinGecko's own slug for a coin, which is not the ticker. Bitcoin is bitcoin, Polygon is matic-network. You can read it off the end of the coin's CoinGecko URL.

Can I price in something other than USD?

Yes. Set the quote currency to any code CoinGecko supports, fiat or crypto, so eur, jpy, btc and eth all work.

Does it return historical prices?

Yes, if you turn on history and set the number of days. Without it each record is the current market snapshot stamped with validFrom.

Can I get the whole market instead of a list?

Yes. Leave the coin list empty and the Actor sweeps the market in the order you choose, capped by Max items. Add a category to sweep one sector.

Do I need a CoinGecko API key?

No. You need an Apify token to call the Actor over the API. No CoinGecko credential is involved anywhere.

Can I get this data in Python?

Yes, with the apify-client package as shown above. It returns parsed JSON, so there is no HTML or response handling on your side.

Can I get the data into Excel or Google Sheets?

Yes. Export the dataset as XLSX or CSV, or connect the Google Sheets integration so each run appends to a sheet.

Can an AI agent call this Actor?

Yes. Add it to an MCP client with the config above and the model can request what it needs on its own. Every record is flat JSON with named fields, so no post-processing is needed.

Is it legal to scrape CoinGecko?

This Actor reads public CoinGecko data that needs no login and collects no personal data. Scraping public data is generally lawful, and how you store, redistribute or act on market data is governed by your own agreements and local rules. Take your own legal advice for your use case.

Changelog

• 0.0.2 Added optional price history, the coin profile and category sweeps.
• 0.0.1 First release. Market data for any coin or the top of the market.

Feedback

Found a field CoinGecko publishes that this Actor misses, or an input it rejects? Open an issue on the Issues tab with the input and what you expected. A daily test runs every Actor in the fleet against live sources, so parser fixes ship fast.