CoinGecko Cryptocurrency Scraper

This Actor scrapes cryptocurrency data from CoinGecko, a popular cryptocurrency tracking website. It extracts detailed information about cryptocurrencies including their rank, name, symbol, price, market cap, and more.

Features

• Scrapes cryptocurrency data from CoinGecko using Cheerio
• Handles pagination automatically to get data from multiple pages
• Extracts key information like rank, name, symbol, price, market cap, etc.
• Option to collect basic data or detailed information from individual cryptocurrency pages
• Configurable number of pages to scrape
• Data saved in structured format for easy analysis

Output data structure

The Actor stores data in one of two formats depending on the scrapeDetails input option:

Basic Data (scrapeDetails = false)

{
	"rank": 1,
	"name": "Bitcoin",
	"symbol": "BTC",
	"price": "$83,036.43",
	"priceChange1h": "0.3%",
	"priceChange24h": "1.0%",
	"priceChange7d": "0.8%",
	"priceChange30d": "6.3%",
	"volume24h": "$16,812,048,183",
	"marketCap": "$1,647,676,993,507",
	"fullyDilutedMarketCap": "$1,647,676,993,507",
	"marketCapToFullyDilutedMarketCapRatio": "1.0",
	"url": "https://www.coingecko.com/en/coins/bitcoin"
}

Detailed Data (scrapeDetails = true)

When scrapeDetails is enabled, the Actor visits each cryptocurrency's detail page and extracts additional information:

{
	"rank": 6,
	"name": "Solana",
	"symbol": "SOL",
	"price": "$132.13",
	"priceChange1h": "0.1%",
	"priceChange24h": "0.8%",
	"priceChange7d": "21.2%",
	"priceChange30d": "0.3%",
	"volume24h": "$4,133,918,355",
	"marketCap": "$68,227,762,583",
	"fullyDilutedMarketCap": "$79,112,028,715",
	"marketCapToFullyDilutedMarketCapRatio": "0.86",
	"url": "https://www.coingecko.com/en/coins/solana",
	"priceChange14d": "3.1%",
	"priceChange1y": "14.0%",
	"range24h": {
		"low": "$128.36",
		"high": "$134.19"
	},
	"range7d": {
		"low": "$103.16",
		"high": "$134.05"
	},
	"allTimeHigh": {
		"price": "$293.31",
		"changePercentage": "55.0%",
		"date": "Jan 19, 2025",
		"daysAgo": "3 months"
	},
	"allTimeLow": {
		"price": "$0.5008",
		"changePercentage": "26274.8%",
		"date": "May 11, 2020",
		"daysAgo": "almost 5 years"
	},
	"circulatingSupply": "516,227,214",
	"totalSupply": "598,580,118",
	"maxSupply": "∞",
	"description": "Solana is a Layer 1 blockchain that offers users fast speeds and affordable costs. It supports smart contracts and facilitates the creation of decentralized applications (dApps). Projects built on Solana include a variety of DeFi platforms as well as NFT marketplaces, where users can buy Solana-based NFT projects. Its high performance means Solana doesn't require a traditional scaling Layer 2 solution; instead, Layer 2s on Solana focus on interoperability and connecting Solana to other chains.",
	"sentiment": {
		"bullish": "79%",
		"bearish": "21%"
	},
	"markets": [
		{
			"rank": "1",
			"exchange": "Binance",
			"type": "CEX",
			"pair": "SOL/USDC",
			"price": "$132.00",
			"volume24h": "$602,038,421",
			"volumePercentage": "14.56%"
		},
		{
			"rank": "2",
			"exchange": "Binance",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.18",
			"volume24h": "$466,768,020",
			"volumePercentage": "11.29%"
		},
		{
			"rank": "3",
			"exchange": "Toobit",
			"type": "CEX",
			"pair": "SOL/USDC",
			"price": "$132.23",
			"volume24h": "$179,231,181",
			"volumePercentage": "4.33%"
		},
		{
			"rank": "4",
			"exchange": "Coinbase Exchange",
			"type": "CEX",
			"pair": "SOL/USD",
			"price": "$132.23",
			"volume24h": "$195,552,188",
			"volumePercentage": "4.73%"
		},
		{
			"rank": "5",
			"exchange": "KuCoin",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.32",
			"volume24h": "$117,349,479",
			"volumePercentage": "2.84%"
		},
		{
			"rank": "6",
			"exchange": "Bitget",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.26",
			"volume24h": "$154,304,408",
			"volumePercentage": "3.73%"
		},
		{
			"rank": "7",
			"exchange": "OKX",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.22",
			"volume24h": "$146,968,970",
			"volumePercentage": "3.55%"
		},
		{
			"rank": "8",
			"exchange": "Bybit",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.28",
			"volume24h": "$129,909,096",
			"volumePercentage": "3.14%"
		},
		{
			"rank": "9",
			"exchange": "Binance",
			"type": "CEX",
			"pair": "SOL/FDUSD",
			"price": "$132.35",
			"volume24h": "$150,611,085",
			"volumePercentage": "3.64%"
		},
		{
			"rank": "10",
			"exchange": "Gate.io",
			"type": "CEX",
			"pair": "SOL/USDT",
			"price": "$132.09",
			"volume24h": "$98,974,151",
			"volumePercentage": "2.39%"
		}
	],
	"lastUpdated": "2025-04-15T11:47:43.664Z"
}

Input parameters

The input schema for this Actor supports the following parameters:

Field	Type	Description
maxPages	integer	Maximum number of pages to scrape. Default is 10 pages (1000 cryptocurrencies).
scrapeDetails	boolean	If enabled, the scraper will visit each cryptocurrency's detail page to extract additional information. This is more resource-intensive as it requires visiting each cryptocurrency page individually. Default is false.

Performance considerations

When scrapeDetails is enabled, the Actor needs to visit each cryptocurrency's individual page, which significantly increases the runtime and resource usage. For example:

• With scrapeDetails = false: Scraping 10 pages (1000 cryptocurrencies) requires only 10 HTTP requests.
• With scrapeDetails = true: Scraping 10 pages requires 10 + 1000 = 1010 HTTP requests.

Consider this when configuring the Actor for your needs.

Expected Cost

This Actor uses a Pay-Per-Event (PPE) pricing model, which means you are charged based on the specific data elements scraped rather than compute time. Costs are transparent and proportional to the amount of data collected.

Pricing Structure

Event Type	Description	Price (USD)
Actor start	Flat fee for starting the Actor	$0.005
Cryptocurrency scraped	Cost per cryptocurrency scraped (basic data)	$0.0002
Detailed cryptocurrency scraped	Cost per cryptocurrency with detailed data scraped	$0.00125

Cost Scenarios

Default Run (10 Pages, No Details)

By default, the Actor scrapes 10 pages (100 cryptocurrencies per page, total of 1000 cryptocurrencies) with basic data only:

• Actor start: 1 × $0.005 = $0.005
• Cryptocurrency scraped: 1000 × $0.0002 = $0.200
• Total estimated cost: $0.205

Comprehensive Run (10 Pages, With Details)

For a comprehensive run with detailed data enabled and 10 pages (100 cryptocurrencies per page, total of 1000 cryptocurrencies):

• Actor start: 1 × $0.005 = $0.005
• Detailed cryptocurrency scraped: 1000 × $0.00125 = $1.250
• Total estimated cost: $1.255

Data uses

The data extracted by this Actor can be used for:

• Cryptocurrency market analysis
• Price tracking and monitoring
• Building financial dashboards
• Investment research
• Data visualization projects

Feature requests and bug reports

If you need additional data from CoinGecko that is not currently being scraped by this Actor or want to request any additional feature, please open an issue in the Apify platform. Describe the specific data points you need and their location on the website, and we'll consider implementing these features in future updates. Similarly, if you encounter any bugs or issues while using this Actor, please report them through the issue tracker with detailed steps to reproduce.

Support the project

If you find this Actor useful, please consider:

• Rating it on the Apify platform
• Writing a review about your experience

Your feedback helps improve the Actor and guides future development priorities.