🪙 CoinGecko Crypto Intelligence — Market Data, Prices & Trends

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Fetch real-time cryptocurrency market data from CoinGecko's public API. Track prices, market cap, volume, price changes (24h/7d/30d), ATH/ATL, supply metrics, and trending coins. Three modes: top coins by market cap, trending coins (24h), or specific coins by ID. No API key required.

✨ Features

• 📊 Market overview — Top coins ranked by market cap with full metrics
• 🔥 Trending coins — Currently hot coins and NFTs (24h trends)
• 🔍 Specific coins — Look up any coin by CoinGecko ID (bitcoin, ethereum, solana, etc.)
• 💱 Multi-currency — Prices in USD, EUR, BRL, GBP, JPY, or any supported fiat
• 📈 Price changes — 24h, 7d, and 30d percentage changes
• 🏔️ ATH/ATL tracking — All-time high and low with distance percentages
• 💎 Supply data — Circulating, total, and max supply + fully diluted valuation
• 📉 7-day sparkline — Optional price chart data (168 data points)
• 🛡️ Anti-placeholder guardrails — Every result validated for real data
• ⚡ No API key — Uses CoinGecko free public API

📥 Input

Parameter	Type	Required	Default	Description
mode	string	✅	"market"	Scraping mode: market, trending, or coins
coinIds	string[]	❌	—	CoinGecko coin IDs (only for coins mode, max 50)
vsCurrency	string	❌	"usd"	Target currency for prices (usd, eur, brl, etc.)
maxCoins	integer	❌	100	Max coins to fetch in market mode (1-250)
includeSparkline	boolean	❌	false	Include 7-day price sparkline array

Input Example

{
  "mode": "market",
  "vsCurrency": "usd",
  "maxCoins": 50,
  "includeSparkline": false
}

Trending mode:

{
  "mode": "trending",
  "vsCurrency": "usd"
}

Specific coins:

{
  "mode": "coins",
  "coinIds": ["bitcoin", "ethereum", "solana", "cardano"],
  "vsCurrency": "usd"
}

📤 Output

Every coin includes these fields:

Field	Type	Description
coinId	string	CoinGecko coin identifier
symbol	string	Ticker symbol (BTC, ETH, SOL)
name	string	Full coin name
currentPrice	number	Current price in target currency
marketCap	number	Total market capitalization
marketCapRank	number	Global rank by market cap
totalVolume	number	24h trading volume
high24h	number	24h price high
low24h	number	24h price low
priceChange24h	number	Absolute price change (24h)
priceChangePercent24h	number	Price change percentage (24h)
priceChangePercent7d	number	Price change percentage (7d)
priceChangePercent30d	number	Price change percentage (30d)
ath	number	All-time high price
athChangePercent	number	Percentage from ATH
athDate	string	Date of all-time high
atl	number	All-time low price
atlChangePercent	number	Percentage from ATL
atlDate	string	Date of all-time low
circulatingSupply	number	Coins currently in circulation
totalSupply	number	Total supply of coins
maxSupply	number/null	Maximum supply (null if unlimited)
fullyDilutedValuation	number	Fully diluted market cap
imageUrl	string	Coin logo URL
lastUpdated	string	Last data update timestamp
currency	string	Target currency used
platform	string	Always "coingecko"
scrapedAt	string	ISO 8601 scrape timestamp

Output Example

{
  "coinId": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "currentPrice": 97432.18,
  "marketCap": 1932847561234,
  "marketCapRank": 1,
  "totalVolume": 28453000000,
  "high24h": 98100.00,
  "low24h": 96200.50,
  "priceChange24h": 1232.18,
  "priceChangePercent24h": 1.28,
  "priceChangePercent7d": 4.52,
  "priceChangePercent30d": -2.13,
  "ath": 108786.00,
  "athChangePercent": -10.43,
  "athDate": "2025-01-20T09:11:54.494Z",
  "atl": 67.81,
  "atlChangePercent": 143572.41,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "circulatingSupply": 19832456,
  "totalSupply": 19832456,
  "maxSupply": 21000000,
  "fullyDilutedValuation": 2046075762000,
  "imageUrl": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png",
  "lastUpdated": "2026-03-06T14:30:00.000Z",
  "currency": "usd",
  "platform": "coingecko",
  "scrapedAt": "2026-03-06T14:30:15.123Z"
}

📋 Use Cases

• Portfolio Tracking — Monitor prices and performance of your crypto holdings
• Market Research — Analyze top coins by market cap, volume, and price trends
• Trend Detection — Spot trending coins before they go mainstream
• Price Alerts — Feed data into automation workflows for price monitoring
• Investment Analysis — Compare ATH/ATL distances, supply metrics, and valuations
• Data Pipelines — Integrate crypto data into dashboards, spreadsheets, or databases

❓ FAQ

Q: Do I need a CoinGecko API key? A: No. This actor uses CoinGecko's free public API, which requires no authentication. Rate limits are handled automatically with retries and backoff.

Q: What is the difference between the three modes? A: market returns top coins ranked by market cap (up to 250). trending returns the coins and NFTs that are currently hot on CoinGecko in the last 24 hours. coins lets you look up specific coins by their CoinGecko ID (e.g., "bitcoin", "ethereum", "solana").

Q: How often is the data updated? A: CoinGecko updates market data approximately every 1-5 minutes. The lastUpdated field in each result shows the exact timestamp of the most recent data from CoinGecko.

Q: Can I get prices in my local currency? A: Yes. Set the vsCurrency parameter to any fiat currency supported by CoinGecko (e.g., "brl", "eur", "gbp", "jpy"). All price fields will be converted to your chosen currency.

Q: What does the sparkline data contain? A: When includeSparkline is enabled, each coin includes a sparkline7d array with 168 price data points (one per hour for the past 7 days), which you can use to render mini price charts.

💰 Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
Per coin scraped	$0.03

🔗 Related Actors

• Steam Game Intelligence — Steam game market data
• eBay Product Scraper — eBay product prices and listings
• Google Trends Scraper — Search trend analysis
• YouTube Fast Scraper — YouTube video metrics

📝 Changelog

v1.0 (Current)

• ✅ Market mode — top coins by market cap (up to 250)
• ✅ Trending mode — 24h hot coins and NFTs
• ✅ Coins mode — specific coin lookup by CoinGecko ID
• ✅ Multi-currency support (USD, EUR, BRL, GBP, etc.)
• ✅ Price change tracking (24h, 7d, 30d)
• ✅ ATH/ATL with distance percentages
• ✅ Supply metrics and fully diluted valuation
• ✅ Optional 7-day sparkline data
• ✅ Rate limit handling with automatic retries
• ✅ Anti-placeholder guardrails

---

🪙 CoinGecko Crypto Intelligence — Dados de Mercado, Preços & Tendências

🇺🇸 English | 🇧🇷 Português

Obtenha dados de mercado de criptomoedas em tempo real da API pública do CoinGecko. Acompanhe preços, capitalização de mercado, volume, variações de preço (24h/7d/30d), ATH/ATL, métricas de oferta e moedas em tendência. Três modos: top moedas por capitalização, moedas em alta (24h) ou moedas específicas por ID. Sem necessidade de API key.

✨ Funcionalidades

• 📊 Visão de mercado — Top moedas ranqueadas por market cap com métricas completas
• 🔥 Moedas em tendência — Moedas e NFTs em alta nas últimas 24h
• 🔍 Moedas específicas — Consulte qualquer moeda por ID do CoinGecko (bitcoin, ethereum, solana, etc.)
• 💱 Multi-moeda — Preços em USD, EUR, BRL, GBP, JPY ou qualquer fiat suportado
• 📈 Variações de preço — Percentuais de 24h, 7d e 30d
• 🏔️ ATH/ATL — Máximas e mínimas históricas com percentual de distância
• 💎 Dados de oferta — Oferta circulante, total e máxima + avaliação totalmente diluída
• 📉 Sparkline 7 dias — Dados opcionais de gráfico de preço (168 pontos)
• 🛡️ Proteção anti-placeholder — Todo resultado validado com dados reais
• ⚡ Sem API key — Usa a API pública gratuita do CoinGecko

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
mode	string	✅	"market"	Modo: market, trending ou coins
coinIds	string[]	❌	—	IDs do CoinGecko (apenas para modo coins, máximo 50)
vsCurrency	string	❌	"usd"	Moeda-alvo para preços (usd, eur, brl, etc.)
maxCoins	inteiro	❌	100	Máximo de moedas no modo market (1-250)
includeSparkline	boolean	❌	false	Incluir sparkline de 7 dias

Exemplo de Entrada

{
  "mode": "market",
  "vsCurrency": "brl",
  "maxCoins": 50,
  "includeSparkline": false
}

Modo tendências:

{
  "mode": "trending",
  "vsCurrency": "brl"
}

Moedas específicas:

{
  "mode": "coins",
  "coinIds": ["bitcoin", "ethereum", "solana", "cardano"],
  "vsCurrency": "brl"
}

📤 Saída

Cada moeda inclui estes campos:

Campo	Tipo	Descrição
coinId	string	Identificador CoinGecko da moeda
symbol	string	Símbolo ticker (BTC, ETH, SOL)
name	string	Nome completo da moeda
currentPrice	número	Preço atual na moeda-alvo
marketCap	número	Capitalização total de mercado
marketCapRank	número	Ranking global por market cap
totalVolume	número	Volume de negociação 24h
high24h	número	Máxima do preço em 24h
low24h	número	Mínima do preço em 24h
priceChange24h	número	Variação absoluta de preço (24h)
priceChangePercent24h	número	Variação percentual (24h)
priceChangePercent7d	número	Variação percentual (7d)
priceChangePercent30d	número	Variação percentual (30d)
ath	número	Máxima histórica (All-Time High)
athChangePercent	número	Percentual de distância do ATH
athDate	string	Data da máxima histórica
atl	número	Mínima histórica (All-Time Low)
atlChangePercent	número	Percentual de distância do ATL
atlDate	string	Data da mínima histórica
circulatingSupply	número	Moedas em circulação
totalSupply	número	Oferta total
maxSupply	número/null	Oferta máxima (null se ilimitada)
fullyDilutedValuation	número	Market cap totalmente diluído
imageUrl	string	URL do logo da moeda
lastUpdated	string	Timestamp da última atualização
currency	string	Moeda-alvo utilizada
platform	string	Sempre "coingecko"
scrapedAt	string	Timestamp ISO 8601 da coleta

Exemplo de Saída

{
  "coinId": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "currentPrice": 97432.18,
  "marketCap": 1932847561234,
  "marketCapRank": 1,
  "totalVolume": 28453000000,
  "high24h": 98100.00,
  "low24h": 96200.50,
  "priceChange24h": 1232.18,
  "priceChangePercent24h": 1.28,
  "priceChangePercent7d": 4.52,
  "priceChangePercent30d": -2.13,
  "ath": 108786.00,
  "athChangePercent": -10.43,
  "athDate": "2025-01-20T09:11:54.494Z",
  "atl": 67.81,
  "atlChangePercent": 143572.41,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "circulatingSupply": 19832456,
  "totalSupply": 19832456,
  "maxSupply": 21000000,
  "fullyDilutedValuation": 2046075762000,
  "imageUrl": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png",
  "lastUpdated": "2026-03-06T14:30:00.000Z",
  "currency": "usd",
  "platform": "coingecko",
  "scrapedAt": "2026-03-06T14:30:15.123Z"
}

📋 Casos de Uso

• Acompanhamento de Portfólio — Monitore preços e performance das suas criptomoedas
• Pesquisa de Mercado — Analise top moedas por market cap, volume e tendências
• Detecção de Tendências — Identifique moedas em alta antes de viralizarem
• Alertas de Preço — Alimente workflows de automação para monitoramento
• Análise de Investimento — Compare distâncias ATH/ATL, métricas de oferta e valuations
• Pipelines de Dados — Integre dados cripto em dashboards, planilhas ou bancos de dados

❓ Perguntas Frequentes

P: Preciso de uma API key do CoinGecko? R: Não. Este actor usa a API pública gratuita do CoinGecko, que não requer autenticação. Limites de requisição são tratados automaticamente com retentativas e backoff.

P: Qual a diferença entre os três modos? R: market retorna as top moedas ranqueadas por capitalização de mercado (até 250). trending retorna as moedas e NFTs que estão em alta no CoinGecko nas últimas 24 horas. coins permite consultar moedas específicas pelo ID do CoinGecko (ex: "bitcoin", "ethereum", "solana").

P: Com que frequência os dados são atualizados? R: O CoinGecko atualiza os dados de mercado aproximadamente a cada 1-5 minutos. O campo lastUpdated em cada resultado mostra o timestamp exato da atualização mais recente do CoinGecko.

P: Posso obter preços na minha moeda local? R: Sim. Defina o parâmetro vsCurrency para qualquer moeda fiat suportada pelo CoinGecko (ex: "brl", "eur", "gbp", "jpy"). Todos os campos de preço serão convertidos para a moeda escolhida.

P: O que contém os dados de sparkline? R: Quando includeSparkline está ativado, cada moeda inclui um array sparkline7d com 168 pontos de preço (um por hora nos últimos 7 dias), que você pode usar para renderizar mini gráficos de preço.

💰 Preços

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
Por moeda coletada	$0.03

🔗 Actors Relacionados

• Steam Game Intelligence — Dados de mercado de jogos Steam
• eBay Product Scraper — Preços e anúncios do eBay
• Google Trends Scraper — Análise de tendências de busca
• YouTube Fast Scraper — Métricas do YouTube

📝 Changelog

v1.0 (Atual)

• ✅ Modo market — top moedas por market cap (até 250)
• ✅ Modo trending — moedas e NFTs em alta nas últimas 24h
• ✅ Modo coins — consulta de moedas específicas por ID
• ✅ Suporte multi-moeda (USD, EUR, BRL, GBP, etc.)
• ✅ Rastreamento de variação de preço (24h, 7d, 30d)
• ✅ ATH/ATL com percentuais de distância
• ✅ Métricas de oferta e avaliação totalmente diluída
• ✅ Sparkline de 7 dias (opcional)
• ✅ Tratamento de rate limit com retentativas automáticas
• ✅ Proteção anti-placeholder