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)

1{
2	"rank": 1,
3	"name": "Bitcoin",
4	"symbol": "BTC",
5	"price": "$83,036.43",
6	"priceChange1h": "0.3%",
7	"priceChange24h": "1.0%",
8	"priceChange7d": "0.8%",
9	"priceChange30d": "6.3%",
10	"volume24h": "$16,812,048,183",
11	"marketCap": "$1,647,676,993,507",
12	"fullyDilutedMarketCap": "$1,647,676,993,507",
13	"marketCapToFullyDilutedMarketCapRatio": "1.0",
14	"url": "https://www.coingecko.com/en/coins/bitcoin"
15}

Detailed Data (scrapeDetails = true)

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

1{
2	"rank": 6,
3	"name": "Solana",
4	"symbol": "SOL",
5	"price": "$132.13",
6	"priceChange1h": "0.1%",
7	"priceChange24h": "0.8%",
8	"priceChange7d": "21.2%",
9	"priceChange30d": "0.3%",
10	"volume24h": "$4,133,918,355",
11	"marketCap": "$68,227,762,583",
12	"fullyDilutedMarketCap": "$79,112,028,715",
13	"marketCapToFullyDilutedMarketCapRatio": "0.86",
14	"url": "https://www.coingecko.com/en/coins/solana",
15	"priceChange14d": "3.1%",
16	"priceChange1y": "14.0%",
17	"range24h": {
18		"low": "$128.36",
19		"high": "$134.19"
20	},
21	"range7d": {
22		"low": "$103.16",
23		"high": "$134.05"
24	},
25	"allTimeHigh": {
26		"price": "$293.31",
27		"changePercentage": "55.0%",
28		"date": "Jan 19, 2025",
29		"daysAgo": "3 months"
30	},
31	"allTimeLow": {
32		"price": "$0.5008",
33		"changePercentage": "26274.8%",
34		"date": "May 11, 2020",
35		"daysAgo": "almost 5 years"
36	},
37	"circulatingSupply": "516,227,214",
38	"totalSupply": "598,580,118",
39	"maxSupply": "∞",
40	"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.",
41	"sentiment": {
42		"bullish": "79%",
43		"bearish": "21%"
44	},
45	"markets": [
46		{
47			"rank": "1",
48			"exchange": "Binance",
49			"type": "CEX",
50			"pair": "SOL/USDC",
51			"price": "$132.00",
52			"volume24h": "$602,038,421",
53			"volumePercentage": "14.56%"
54		},
55		{
56			"rank": "2",
57			"exchange": "Binance",
58			"type": "CEX",
59			"pair": "SOL/USDT",
60			"price": "$132.18",
61			"volume24h": "$466,768,020",
62			"volumePercentage": "11.29%"
63		},
64		{
65			"rank": "3",
66			"exchange": "Toobit",
67			"type": "CEX",
68			"pair": "SOL/USDC",
69			"price": "$132.23",
70			"volume24h": "$179,231,181",
71			"volumePercentage": "4.33%"
72		},
73		{
74			"rank": "4",
75			"exchange": "Coinbase Exchange",
76			"type": "CEX",
77			"pair": "SOL/USD",
78			"price": "$132.23",
79			"volume24h": "$195,552,188",
80			"volumePercentage": "4.73%"
81		},
82		{
83			"rank": "5",
84			"exchange": "KuCoin",
85			"type": "CEX",
86			"pair": "SOL/USDT",
87			"price": "$132.32",
88			"volume24h": "$117,349,479",
89			"volumePercentage": "2.84%"
90		},
91		{
92			"rank": "6",
93			"exchange": "Bitget",
94			"type": "CEX",
95			"pair": "SOL/USDT",
96			"price": "$132.26",
97			"volume24h": "$154,304,408",
98			"volumePercentage": "3.73%"
99		},
100		{
101			"rank": "7",
102			"exchange": "OKX",
103			"type": "CEX",
104			"pair": "SOL/USDT",
105			"price": "$132.22",
106			"volume24h": "$146,968,970",
107			"volumePercentage": "3.55%"
108		},
109		{
110			"rank": "8",
111			"exchange": "Bybit",
112			"type": "CEX",
113			"pair": "SOL/USDT",
114			"price": "$132.28",
115			"volume24h": "$129,909,096",
116			"volumePercentage": "3.14%"
117		},
118		{
119			"rank": "9",
120			"exchange": "Binance",
121			"type": "CEX",
122			"pair": "SOL/FDUSD",
123			"price": "$132.35",
124			"volume24h": "$150,611,085",
125			"volumePercentage": "3.64%"
126		},
127		{
128			"rank": "10",
129			"exchange": "Gate.io",
130			"type": "CEX",
131			"pair": "SOL/USDT",
132			"price": "$132.09",
133			"volume24h": "$98,974,151",
134			"volumePercentage": "2.39%"
135		}
136	],
137	"lastUpdated": "2025-04-15T11:47:43.664Z"
138}

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.

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