CoinGecko Crypto Market API

Get live cryptocurrency prices, market caps, trading volumes and price changes for thousands of coins, plus trending coins, coin search, detailed coin profiles, price history and global market stats. Prices in USD, EUR, GBP, JPY, BTC and many other currencies. No API key needed. Export to JSON, CSV or Excel, or call it from your own code.

Data provided by CoinGecko.

What does CoinGecko Crypto Market API do?

• Top coins by market cap: up to 250 coins with price, market cap, rank, 24-hour volume, highs and lows, supply, all-time high and low, and price change over 1h, 24h, 7d, 14d, 30d, 200d or 1y
• Coin details: description, website, launch date and market data for the coins you list
• Price history: price, market cap and volume over the last 1 day to all time for one coin
• Trending coins: the coins people are searching for most in the last 24 hours
• Search: find coins by name or symbol and get their CoinGecko IDs
• Global stats: total crypto market cap and volume, number of coins and exchanges, and each top coin's market share
• Filter the top-coins list by category, such as layer-1, decentralized-finance-defi or meme-token, and sort by market cap, volume or ID

What people use it for

• Portfolio and price trackers in Google Sheets, Excel or a dashboard
• Scheduled price snapshots and alerts to Slack, email or a webhook
• Research datasets of market caps, volumes and returns across coins
• Feeding crypto prices into apps, bots and reports

How to use it

1. Click Try for free to open the Actor in Apify Console
2. Pick an API Endpoint: top coins, search, trending, coin details, price history or global stats
3. Fill in what that endpoint needs: a Search Query for search, Coin IDs for coin details and price history
4. Choose the Target Currency and Max Results, then click Start
5. Open the Output tab: the Coins view shows prices and changes, Price history shows chart points

Coin IDs are the names CoinGecko uses in its page addresses, such as bitcoin, ethereum, solana or usd-coin. Use the search endpoint to find an ID.

Input examples

Top 20 coins in euros:

{
  "endpoint": "coins/markets",
  "vsCurrency": "eur",
  "maxResults": 20,
  "priceChangePercentage": "1h,24h,7d,30d"
}

Details for three coins:

{
  "endpoint": "coin",
  "coinIds": "bitcoin,ethereum,solana",
  "vsCurrency": "usd"
}

The last 30 days of Ethereum prices (hourly points, most recent 250):

{
  "endpoint": "market_chart",
  "coinIds": "ethereum",
  "days": "30",
  "maxResults": 250
}

Field	What it does
endpoint	coins/markets, search, trending, coin, market_chart or global
vsCurrency	Currency for prices, such as usd, eur, gbp, jpy, btc
coinIds	Coin IDs for coin and market_chart (price history uses the first one)
searchQuery	Text to search for with search
category	Category for coins/markets, such as layer-1
orderBy	Sort for coins/markets: market cap, volume or ID, up or down
priceChangePercentage	Change windows: 1h,24h,7d,14d,30d,200d,1y
maxResults	1 to 250 rows
sparkline	Adds 7 days of hourly prices to each coin
days	History length for market_chart: 1, 7, 14, 30, 90, 180, 365 or max

Output example

A coin from the top-coins list:

{
  "coinId": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "imageUrl": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
  "currentPrice": 84492,
  "marketCap": 1697318250094,
  "marketCapRank": 1,
  "fullyDilutedValuation": 1697331176433,
  "totalVolume": 21802718797,
  "high24h": 85089,
  "low24h": 83835,
  "priceChange24h": 483.29,
  "priceChangePercentage1h": -0.4615,
  "priceChangePercentage24h": 0.56887,
  "priceChangePercentage7d": 4.9888,
  "priceChangePercentage30d": 6.434,
  "marketCapChange24h": 9610280470,
  "marketCapChangePercentage24h": 0.56943,
  "circulatingSupply": 20089965,
  "totalSupply": 20090134,
  "maxSupply": 21000000,
  "ath": 126080,
  "athChangePercentage": -32.98498,
  "athDate": "2025-10-06T10:57:42.000Z",
  "atl": 67.81,
  "atlChangePercentage": 124503.60356,
  "atlDate": "2013-07-05T16:00:00.000Z",
  "lastUpdated": "2026-09-27T15:09:20.000Z",
  "recordType": "market"
}

A price history point:

{
  "coinId": "ethereum",
  "timestamp": 1790517600000,
  "date": "2026-09-27T14:00:00+00:00",
  "price": 2708.88,
  "marketCap": 330712182324.25,
  "totalVolume": 7528162301.84,
  "vsCurrency": "usd",
  "recordType": "chart"
}

Pricing

You pay $0.50 per 1,000 rows ($0.0005 per coin, search result or price point) plus the small Apify platform usage of the run. The top 100 coins cost $0.05 in row charges.

FAQ

Do I need a CoinGecko API key? No.

How fresh are the prices? Each run reads CoinGecko's current data, which updates about every minute. Schedule the Actor for regular snapshots.

Why did my coin return nothing? Use the CoinGecko coin ID, not the ticker: bitcoin, not btc. The run log names any ID that was not found, and the search endpoint finds the right ID.

How detailed is the price history? CoinGecko picks the spacing from the number of days: 1 day gives 5-minute points, 2 to 90 days hourly points, longer ranges daily points. The run returns the most recent points up to your Max Results.

Which categories can I use? Any CoinGecko category ID, as it appears in the address of the category page on coingecko.com, for example layer-1, decentralized-finance-defi, meme-token or artificial-intelligence.