🪙 Cryptocurrency Market Data Scraper

Fetch real-time cryptocurrency market data from CoinGecko's public API — prices, market caps, trading volumes, price changes, all-time highs/lows, supply statistics, and trending coins. No API key required.

✨ Features

• Top Coins: Get the top N cryptocurrencies ranked by market capitalization
• Specific Coins: Fetch detailed data for any coin by its CoinGecko ID
• Trending Coins: Discover what's trending in the crypto market right now
• Multiple Currencies: View prices in USD, EUR, GBP, JPY, BTC, ETH, and 50+ other currencies
• Rich Data: 25+ fields per coin including price changes (1h/24h/7d), ATH/ATL, supply data

🔧 How It Works

1. Configure the mode (top coins, specific coins, or trending)
2. Set the quote currency (default: USD)
3. The Actor queries CoinGecko's free public API
4. Results are pushed to the Apify dataset as structured JSON

📋 Input Parameters

Parameter	Type	Description
mode	string	top_coins, specific_coins, or trending
vs_currency	string	Quote currency code (e.g., usd, eur, btc)
top_n	integer	Number of top coins to fetch (1–1000, default: 100)
coin_ids	string	Comma-separated CoinGecko coin IDs (for specific_coins mode)

📊 Sample Output

{
    "coin_id": "bitcoin",
    "symbol": "BTC",
    "name": "Bitcoin",
    "rank": 1,
    "current_price": 73830,
    "market_cap": 1477762459408,
    "total_volume_24h": 35823456697,
    "high_24h": 74837,
    "low_24h": 73530,
    "price_change_pct_1h": -0.47,
    "price_change_pct_24h": -0.14,
    "price_change_pct_7d": 6.0,
    "circulating_supply": 20003043,
    "total_supply": 20003043,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_pct": -41.47,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "vs_currency": "usd",
    "fetched_at": "2026-03-18T12:00:00.000000"
}

⚡ Rate Limits

This Actor uses the CoinGecko free API (no key required). The free tier allows approximately 10–30 requests per minute. The Actor automatically handles rate limiting with built-in delays and retry logic.

• Top 100 coins: ~1 request, completes in seconds
• Top 1000 coins: ~4 requests, completes in ~10 seconds
• Specific coins: 1 request per coin, ~2.5s spacing

🔗 Finding Coin IDs

CoinGecko coin IDs are lowercase slugs (e.g., bitcoin, ethereum, solana, dogecoin). You can find them at CoinGecko — the coin ID is in the URL: coingecko.com/en/coins/{coin_id}.

📝 Notes

• Data is sourced from CoinGecko's aggregated exchange data
• Prices update approximately every 1–2 minutes
• The Actor does not require any API keys or authentication
• For high-frequency data needs, consider using CoinGecko's paid API plans separately