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) json { "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: json { "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.