CoinGecko Scraper

Scrape live cryptocurrency market data from CoinGecko — the world's largest independent crypto data aggregator. Get real-time prices, market caps, trending coins, detailed coin info, and category listings for 10,000+ cryptocurrencies. No API key required.

What This Actor Does

• Five modes: markets, search, byId, trending, categories
• Multi-currency support: USD, EUR, GBP, JPY, CNY, KRW, BTC, ETH
• Flexible filtering: filter by market cap, rank, category, sort order
• Real-time data: prices, market caps, 24h changes, supply, ATH/ATL, trending scores
• Clean output: null fields are never included in output records

Modes

markets (default)

List coins sorted by market cap, volume, or ID. Supports currency selection, category filter, and sort order. Returns up to 250 coins per run.

search

Search for coins by name or symbol (e.g. "bitcoin", "sol", "doge"). Returns matching coins with rank and image.

byId

Fetch rich detail for one or more specific coins by their CoinGecko ID. Returns description, categories, homepage, GitHub repos, price history changes (24h/7d/30d), and full market data.

trending

Returns the current trending coins on CoinGecko (last 24 hours). Includes score, price in BTC, and image.

categories

Lists all CoinGecko coin categories with market cap, 24h market cap change, and 24h volume. Useful for finding category slugs to use in the category filter.

Input Parameters

Parameter	Type	Default	Description
mode	Select	markets	What data to fetch (markets, search, byId, trending, categories)
searchQuery	String	—	Search term (mode=search, e.g. "bitcoin")
coinIds	String list	—	CoinGecko coin IDs (mode=byId, e.g. "bitcoin", "ethereum")
vsCurrency	Select	usd	Quote currency for prices (usd, eur, gbp, jpy, cny, krw, btc, eth)
order	Select	market_cap_desc	Sort order for markets mode
category	String	—	Filter markets to a category slug (e.g. decentralized-finance-defi, layer-1)
maxItems	Integer	50	Max records to return (1–250)
minMarketCap	Number	—	Filter: minimum market cap in USD (markets mode)
maxMarketCap	Number	—	Filter: maximum market cap in USD (markets mode)
minRank	Integer	—	Filter: minimum market cap rank (markets mode)
maxRank	Integer	—	Filter: maximum market cap rank (markets mode)

Output Fields

Markets mode (recordType: "coin")

Field	Type	Description
coinId	String	CoinGecko ID (e.g. bitcoin)
symbol	String	Ticker symbol (e.g. BTC)
name	String	Full name (e.g. Bitcoin)
currentPrice	Number	Current price in selected currency
marketCap	Number	Market capitalization
marketCapRank	Integer	Global market cap rank
fullyDilutedValuation	Number	Fully diluted valuation
totalVolume	Number	24h trading volume
priceHigh24h	Number	24h highest price
priceLow24h	Number	24h lowest price
priceChange24h	Number	Absolute price change in 24h
priceChangePercent24h	Number	Percentage price change in 24h
marketCapChangePercent24h	Number	Market cap change % in 24h
circulatingSupply	Number	Circulating supply
totalSupply	Number	Total supply
maxSupply	Number	Maximum supply (if capped)
ath	Number	All-time high price
athDate	String	Date of all-time high (ISO 8601)
atl	Number	All-time low price
atlDate	String	Date of all-time low (ISO 8601)
lastUpdated	String	CoinGecko last-update timestamp
imageUrl	String	Coin logo URL
sourceUrl	String	CoinGecko page URL
scrapedAt	String	ISO 8601 scrape timestamp
recordType	String	"coin"

byId mode (richer fields added)

All markets fields plus:

Field	Type	Description
description	String	Plain-text coin description
categories	String list	CoinGecko category names
homepageUrl	String	Official website URL
reposUrl	String list	GitHub / Bitbucket repository URLs
priceChangePercent7d	Number	7-day price change %
priceChangePercent30d	Number	30-day price change %

trending mode (recordType: "trending_coin")

coinId, name, symbol, marketCapRank, score, priceInBtc, imageUrl, sourceUrl, scrapedAt

categories mode (recordType: "coin_category")

categoryId, name, marketCap, marketCapChange24h, volume24h, description, updatedAt, sourceUrl, scrapedAt

Example Output (markets mode)

{
  "coinId": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "currentPrice": 67000.0,
  "marketCap": 1320000000000.0,
  "marketCapRank": 1,
  "fullyDilutedValuation": 1400000000000.0,
  "totalVolume": 28000000000.0,
  "priceHigh24h": 68000.0,
  "priceLow24h": 65000.0,
  "priceChange24h": 1500.0,
  "priceChangePercent24h": 2.3,
  "marketCapChangePercent24h": -0.38,
  "circulatingSupply": 19700000.0,
  "totalSupply": 21000000.0,
  "maxSupply": 21000000.0,
  "ath": 73750.0,
  "athDate": "2024-03-14T07:10:36.635Z",
  "atl": 67.81,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "lastUpdated": "2024-04-01T12:00:00.000Z",
  "imageUrl": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png",
  "sourceUrl": "https://www.coingecko.com/en/coins/bitcoin",
  "recordType": "coin",
  "scrapedAt": "2026-06-06T12:00:00+00:00"
}

Data Source

Data is sourced from CoinGecko via their free public REST API (api.coingecko.com/api/v3). CoinGecko tracks 10,000+ cryptocurrencies across 600+ exchanges and is the world's largest independent crypto data aggregator.

FAQs

Do I need an API key? No. This actor uses CoinGecko's free public tier which requires no authentication.

How fresh is the data? CoinGecko updates price data every 1–5 minutes for major coins.

How do I find a coin's CoinGecko ID? Visit coingecko.com, search for the coin, and copy the ID from the URL (e.g. bitcoin, ethereum, shiba-inu).

How do I find category slugs? Run the actor in categories mode to get all available category IDs, then use them as the category filter in markets mode.

What does the order parameter do? It controls how markets results are sorted: market_cap_desc (default, largest first), market_cap_asc, volume_desc, volume_asc, id_asc, id_desc.

Why might some fields be missing from output? CoinGecko may not have data for all fields for every coin (e.g. maxSupply is null for coins with no hard cap). Null/empty fields are never included in output records.

Can I scrape multiple coins in byId mode? Yes — provide a list of CoinGecko IDs in coinIds (e.g. ["bitcoin", "ethereum", "solana"]). Each coin is fetched individually with rate-limiting to avoid 429 errors.