CoinGecko Cryptocurrency Market Intelligence

Extract real-time cryptocurrency market data from CoinGecko with AI-powered investment scoring. Perfect for crypto traders, investors, portfolio managers, and market analysts.

Features

• AI Investment Scoring: Proprietary 0-100 scoring algorithm based on market position, performance, liquidity, and growth potential
• Comprehensive Filtering: Filter by price, market cap, volume, rank, 24h change, and specific symbols
• Multiple Currencies: Get prices in USD, EUR, GBP, JPY, BTC, or ETH
• Complete Market Data: Current prices, 24h high/low, volume, market cap, supply metrics, ATH/ATL
• Real-Time Data: Direct access to CoinGecko's public API
• Pay-Per-Result Pricing: Free for first 100 coins, then $0.02 per coin

Use Cases

• Crypto Trading: Identify trading opportunities with AI scoring
• Portfolio Management: Track and analyze your crypto holdings
• Market Research: Analyze trends, volumes, and market movements
• Price Alerts: Build custom alert systems for price changes
• Investment Analysis: Find undervalued cryptocurrencies
• DeFi Platforms: Integrate real-time pricing data
• Crypto News Sites: Display live market data
• Trading Bots: Feed market data to automated trading systems

AI Investment Score Algorithm

The investment score (0-100) is calculated using four factors:

1. Market Position (30 points max)

• Rank #1: 30 points (Top coin)
• Top 5: 28 points
• Top 10: 25 points
• Top 20: 22 points
• Top 50: 18 points
• Top 100: 15 points
• Top 200: 12 points
• Top 500: 8 points
• Lower ranks: 5 points

2. Price Performance (25 points max)

24h Price Change (15 points):

• +20% or more: 15 points (Strong rally)
• +10% to +20%: 13 points (Good rally)
• +5% to +10%: 11 points (Moderate rally)
• 0% to +5%: 9 points (Slight gain)
• 0% to -5%: 7 points (Small dip)
• -5% to -10%: 5 points (Moderate dip)
• Below -10%: 3 points (Large dip)

ATH Distance (10 points):

• Within 5% of ATH: 10 points (Near all-time high)
• Within 10%: 8 points
• Within 20%: 6 points
• Within 40%: 4 points
• Further: 2 points

3. Liquidity (25 points max)

Based on Volume/Market Cap ratio:

• 20%+ ratio: 25 points (Extremely liquid)
• 15-20%: 22 points (Very liquid)
• 10-15%: 19 points (Highly liquid)
• 5-10%: 15 points (Good liquidity)
• 2-5%: 11 points (Moderate)
• Below 2%: 7 points

4. Growth Potential (20 points max)

Supply Dynamics (12 points):

• With max supply:
  • 95%+ circulating: 12 points (High scarcity)
  • 80-95%: 14 points (Good circulation)
  • 50-80%: 16 points (Room to grow)
  • Below 50%: 18 points (Large potential)
• No max supply: 10 points

Market Cap Size (8 points):

• Under $10M: 8 points (Micro cap - high risk/reward)
• $10M-$100M: 7 points (Small cap)
• $100M-$1B: 6 points (Mid cap)
• $1B-$10B: 4 points (Large cap)
• Over $10B: 2 points (Mega cap - stable)

Input Parameters

Required

None - all parameters are optional

Optional

Parameter	Type	Description	Default
vsCurrency	string	Target currency: "usd", "eur", "gbp", "jpy", "btc", "eth"	"usd"
order	string	Sort order: "market_cap_desc", "volume_desc", etc.	"market_cap_desc"
category	string	Filter by category (e.g., "defi", "nft")	""
symbols	array	Specific symbols (e.g., ["btc", "eth", "sol"])	[]
minPrice	number	Minimum price	0
maxPrice	number	Maximum price (0 = no limit)	0
minMarketCap	number	Minimum market cap	0
minVolume	number	Minimum 24h volume	0
minRank	integer	Minimum rank (1 = highest)	1
maxRank	integer	Maximum rank	999999
minPriceChange24h	number	Minimum 24h price change %	-999999
maxResults	integer	Maximum coins to return (1-2500)	100
includeInvestmentScore	boolean	Include AI investment score	true

Output

Each cryptocurrency contains:

{
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png",
  "current_price": 95398,
  "market_cap": 1901761275951,
  "market_cap_rank": 1,
  "fully_diluted_valuation": 1901761275951,
  "total_volume": 77531669987,
  "high_24h": 95904,
  "low_24h": 93029,
  "price_change_24h": -215.09,
  "price_change_percentage_24h": -0.22,
  "market_cap_change_24h": -5664875284.62,
  "market_cap_change_percentage_24h": -0.30,
  "circulating_supply": 19948812.0,
  "total_supply": 19948812.0,
  "max_supply": 21000000.0,
  "ath": 126080,
  "ath_change_percentage": -24.38,
  "ath_date": "2025-10-06T18:57:42.558Z",
  "atl": 67.81,
  "atl_change_percentage": 140505.69,
  "atl_date": "2013-07-06T00:00:00.000Z",
  "last_updated": "2025-11-17T12:26:00.629Z",
  "investment_score": 82
}

Example Inputs

Get Top 50 Cryptocurrencies

{
  "vsCurrency": "usd",
  "order": "market_cap_desc",
  "maxResults": 50,
  "includeInvestmentScore": true
}

Find High-Volume Coins (Liquid Trading)

{
  "minVolume": 100000000,
  "minMarketCap": 1000000000,
  "maxResults": 100
}

Track Specific Cryptocurrencies

{
  "symbols": ["btc", "eth", "sol", "ada", "dot"],
  "includeInvestmentScore": true
}

Find Undervalued Small Caps

{
  "minMarketCap": 10000000,
  "maxRank": 500,
  "minVolume": 1000000,
  "maxResults": 100
}

Track Top Gainers (24h)

{
  "minPriceChange24h": 10,
  "order": "volume_desc",
  "maxResults": 50
}

Get Prices in BTC

{
  "vsCurrency": "btc",
  "order": "market_cap_desc",
  "maxResults": 100
}

Pricing

• Free Tier: First 100 coins per run
• Paid: $0.02 per coin after 100

Examples:

• 100 coins: FREE
• 500 coins: $8.00
• 1000 coins: $18.00
• 2500 coins: $48.00

Data Source

This actor uses the CoinGecko public API. No authentication required.

Rate Limits

The actor respects CoinGecko API rate limits:

• Free tier: 30 calls/minute, 10,000 calls/month
• Fetches up to 250 coins per request
• Maximum 10 pages per run (2,500 coins)
• 1-second delay between pages

Support

For issues or questions:

• Check the CoinGecko API Documentation
• Review the actor source code
• Contact support via Apify platform

Legal

This actor uses CoinGecko's public API in compliance with their terms of service. All data remains property of CoinGecko. Not financial advice - do your own research before investing.