CoinGecko Real-Time Data

Live CoinGecko crypto market intelligence: top coins by market cap, instant coin search, full coin profiles, trending coins, and exchange rankings — structured JSON streamed to your dataset in real time.

Free trial: free Apify plans get a 2-result sample per run. Upgrade to a paid Apify plan for unlimited exports. See Delivery & free tier below.

Who is it for

Built for crypto researchers, trading desks, fintech builders, SEO/content teams, and AI agents that need fresh market context.

Use cases

• Token screeners and watchlists — top coins by market cap, volume, and 24h moves
• Research briefs — full coin profiles with description, categories, homepage, supply, and sentiment
• Trend radar — what is trending on CoinGecko right now
• Venue research — ranked exchanges with trust score, country, and 24h volume
• Price/market-cap inputs for bots, sheets, and dashboards via webhooks
• AI-agent market context — ask questions over live rows through the Apify MCP

Features

Feature	What you get	Input
🪙 Top Coins (default ON)	Ranked market list: price, market cap, volume, 24h change, ATH/ATL, supply. Optional per-coin enrichment keeps ONE row (detailsFetched=true).	vsCurrency, topCoinsLimit (default 10), topCoinsOrder, topCoinsCategory, topCoinsFetchFullDetails
🔍 Coin Search	Coins matching a name/symbol query with rank and artwork. Optional enrichment adds market price + profile.	searchQueries, coinSearchMaxResults (default 10), coinSearchFetchFullDetails
📄 Coin Details	Full profile for exact ids/URLs: description, market data, links, supply, sentiment.	coinIds, coinUrls
📈 Trending	Ranked trending coins with price and score.	— (just enable)
🏦 Exchanges	Ranked exchanges: trust score, country, year established, 24h volume.	exchangesLimit (default 10)
🔗 Scrape By URL	Any CoinGecko coin or exchange URL → structured row with auto-detected page type.	scrapeUrls

Every discovered item is always saved — enrichment never drops rows and never creates duplicates.

Input reference

• enableTopCoins (boolean, default true) — market ranking. Demo: 10 coins in USD.
• vsCurrency (select, default usd) — usd | eur | gbp | jpy | aud | cad | btc | eth.
• topCoinsLimit (1–250, default 10), topCoinsOrder (default market_cap_desc), topCoinsCategory (optional, e.g. layer-1), topCoinsFetchFullDetails (boolean, default false).
• enableCoinSearch (boolean, default false), searchQueries (e.g. ["bitcoin","ethereum","solana"]), coinSearchMaxResults (1–25, default 10), coinSearchFetchFullDetails (default false).
• enableCoinDetails (default false), coinIds (e.g. ["bitcoin","ethereum"]), coinUrls (e.g. ["https://www.coingecko.com/en/coins/bitcoin"]).
• enableTrending (default false) — no extra fields.
• enableExchanges (default false), exchangesLimit (1–100, default 10).
• enableScrapeByUrl (default false), scrapeUrls (e.g. ["https://www.coingecko.com/en/coins/bitcoin"]).
• webhookUrl (optional), webhookFormat (json | slack, default json).
• proxyConfiguration (optional) — the public market feed usually works with the default connection.

Example — top 10 in USD (default, just click Start):

{ "enableTopCoins": true, "vsCurrency": "usd", "topCoinsLimit": 10 }

Example — search + enrich:

{
  "enableTopCoins": false,
  "enableCoinSearch": true,
  "searchQueries": ["bitcoin", "solana"],
  "coinSearchMaxResults": 10,
  "coinSearchFetchFullDetails": true
}

Example — full profiles + trending + exchanges:

{
  "enableTopCoins": false,
  "enableCoinDetails": true,
  "coinIds": ["bitcoin", "ethereum"],
  "enableTrending": true,
  "enableExchanges": true,
  "exchangesLimit": 10
}

Output reference

One row per coin/exchange. Key fields:

• Common: featureType, scrapedAt, url
• Market rows (top_coins): coin_id, symbol, name, image, current_price, market_cap, market_cap_rank, total_volume, high_24h, low_24h, price_change_24h, price_change_percentage_24h, circulating_supply, total_supply, max_supply, ath, ath_date, atl, atl_date, last_updated, vs_currency, position, detailsFetched (+ description, categories, homepage, genesis_date, sentiment when enriched)
• Search rows (coin_search): coin_id, symbol, name, market_cap_rank, image, current_price, market_cap, position, detailsFetched
• Detail rows (coin_details): full profile incl. description, categories, homepage, genesis_date, hashing_algorithm, market fields, supply, sentiment
• Trending (trending): coin_id, symbol, name, market_cap_rank, image, current_price, price_change_percentage_24h, score, position
• Exchanges (exchanges): exchange_id, exchange_name, country, year_established, description, image, trust_score, trust_score_rank, trade_volume_24h_btc, position
• URL rows (scrape_by_url): pageType (coin | exchange | unknown), coin_id/exchange_id, name, symbol, current_price, market_cap, trust_score

Filter views by featureType. The OUTPUT object also carries paywall (detected, isPaying, pricingTier, limited, blocked, freeTierMaxItems) and totalPushed.

Delivery & free tier

• Streaming: each record is pushed to the dataset as soon as it is collected — RAM stays light even on large runs.
• Webhooks: set webhookUrl (+ webhookFormat) to also POST every row in real time.
  • json — the full record object.
  • slack — a Slack-friendly message (:chart_with_upwards_trend: *Bitcoin* … <url|Open on CoinGecko>).
  • Delivery is fire-and-forget: failures never stop the run or dataset writes.
• Free tier: free Apify plans are capped at 2 results per run (FREE_TIER_MODE=limit, FREE_TIER_MAX_ITEMS=2, PPE event result). Paying plans get full output. Local runs (no platform vars) are uncapped.
• Spend cap: the run respects your max-cost limit — when hit, it stops cleanly, writes the summary, and exits with a clear message.

MCP / AI-agent usage

Pair with the Apify MCP server: point your agent at this Actor, run it with a small limit, then ask questions over the dataset.

Example question: "Run CoinGecko Real-Time Data for the top 10 coins in USD and tell me which gained the most in 24h."

FAQ

• Do I need a proxy? Usually no for small runs — the default connection works. Residential is recommended at scale.
• How fresh is the data? Every run collects live market data; each row carries scrapedAt and last_updated.
• Why only 2 results on a free plan? That is the free-trial sample. Upgrade to a paid Apify plan for unlimited rows.
• Will enrichment duplicate rows? No — enriched market/search rows stay ONE row with detailsFetched=true.
• Which currency? Pick vsCurrency (USD, EUR, GBP, JPY, AUD, CAD, BTC, ETH) once per run.