CoinGecko Crypto — Live Prices & Market Data API

Real-time cryptocurrency prices and market data from CoinGecko"s public API for 15,000+ coins. Get live prices in 60+ currencies, top market listings, detailed coin profiles, and full coin catalogs. Pure HTTP, no API key needed. Flat typed output schema — designed for LLMs, MCP, and data pipelines.

Why this actor?

• Typed flat schema — every field is named, typed, and documented. No raw API nesting. Ready for LLM/MCP consumption.
• Four modes, one actor — price (simple/price), markets (coins/markets), coin detail (coins/{id}), coin list (coins/list).
• Rate-limit management — built-in exponential backoff handles CoinGecko"s free-tier throttling gracefully.
• Error items are free — bad coin IDs, rate limits, and upstream errors produce typed error items without charge.
• 256MB, seconds per run — lightweight HTTP-only design. No browser overhead.

Input

{
  "mode": "price",
  "coinIds": ["bitcoin", "ethereum"],
  "vsCurrencies": ["usd", "eur"]
}

All modes and parameters documented in the input schema. See the Console UI for guided input.

Output

One item per result, discriminated by type:

{
  "type": "price",
  "coinId": "bitcoin",
  "symbol": "btc",
  "prices": { "usd": 64074, "eur": 56003 },
  "lastUpdated": "2026-07-20T00:00:00.000Z",
  "error": null,
  "scraped_at": "2026-07-20T01:00:00.000Z"
}

Error items have type: "error" with an error message describing what went wrong.

Pricing

Pay per result: $0.30 per 1,000 results. Error items are always free. No monthly fees, no API keys to manage.

Use cases

• LLM agents and MCP servers — typed, predictable JSON output for tool-calling and function integration.
• Crypto dashboards — pull live prices and market data into spreadsheets, BI tools, or internal dashboards.
• Data pipelines — scheduled market snapshots, coin catalog syncs, and price feeds.
• Market research — category-filtered rankings, detailed coin profiles with community sentiment.

FAQ

Do I need a CoinGecko API key? No. The free tier is public, no auth required. The actor handles rate limits automatically.

What"s the rate limit? CoinGecko"s free tier allows 10-30 requests per minute. The actor paces requests at 350ms and retries with exponential backoff on 429 responses.

How many coins are supported? 15,000+ coins tracked by CoinGecko, in 60+ fiat currencies.

What happens if a coin ID is invalid? You get a free error item with the reason — the run continues processing other coins.

---

This Actor is an independent tool. Not affiliated with CoinGecko.