CoinGecko Markets — Crypto Data API

Live cryptocurrency market data from CoinGecko as clean typed JSON — price, market cap, 24h volume and change, ATH/ATL, and circulating, total and max supply. No API key needed; add a Pro key only if you want higher rate limits.

What it does

Two modes cover the common jobs:

• markets — the top coins ranked by market cap (or volume, or id), paginated, with the full market snapshot for each one.
• coins — what's trending right now, or a curated watchlist you specify by CoinGecko id (bitcoin, ethereum, solana, …).

Every record is quoted in the currency you choose via vsCurrency, so you can pull the same market in USD, EUR, JPY or even BTC terms without post-processing.

Features

• No API key required — uses CoinGecko's free public endpoints; apiKey is optional for Pro rate limits.
• Two modes — ranked market table, or trending/curated coin lists.
• Any quote currency — usd, eur, gbp, jpy, btc and the rest of CoinGecko's supported list.
• Full market snapshot per coin — 26 fields including ATH/ATL with their dates and percentage distances.
• Supply figures — circulating, total and max supply, for dilution and tokenomics analysis.
• Pagination control — perPage (1–250) and page let you walk the whole ranked list.
• Sort control — by market cap or volume, ascending or descending.

What people use it for

• Portfolio dashboards — refresh a watchlist on a schedule and push it to Sheets or a database.
• Research and backtesting — snapshot the market daily to build your own historical series.
• Screeners — pull the top 250 and filter locally on volume, supply or drawdown from ATH.
• Agent tooling — give an LLM agent a reliable, structured crypto price source.
• Alerting — schedule runs and trigger a webhook when a coin's 24h change crosses a threshold.

Modes in practice

Top 10 coins by market cap in euros:

{ "mode": "markets", "vsCurrency": "eur", "perPage": 10, "page": 1, "order": "market_cap_desc" }

A specific watchlist:

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

Leave coinIds empty in coins mode to get trending coins instead.

Finding a coin id

CoinGecko ids are slugs, not tickers: bitcoin not BTC, ethereum not ETH, matic-network rather than MATIC. The id is visible in the coin's CoinGecko URL, and markets mode returns the id of every coin it lists — a quick way to look ids up in bulk.

Input

All fields are optional — the defaults return the top 100 coins by market cap in USD. coinIds is used when you want a specific watchlist.

Field	Type	Default	What it does
mode	string	markets	markets = top coins by market cap with full market data; coins = trending coins now, or a curated list by id. Options: markets, coins.
vsCurrency	string	usd	Quote currency, e.g. usd, eur, btc, jpy.
order	string	market_cap_desc	Sorting for markets mode (markets mode only). Options: market_cap_desc, market_cap_asc, volume_asc, volume_desc, id_asc, gecko_desc.
perPage	integer	100	Number of coins (1-250) for markets mode. Range 1–250.
page	integer	1	Page number for markets mode.
coinIds	array	[]	Comma/line-separated CoinGecko ids, e.g. bitcoin, ethereum, solana. Used when Mode = Specific coins / trending and this is non-empty. Otherwise returns trending.
apiKey	string	—	Optional. Raises rate limits if you have a Pro key. Leave empty to use the free public endpoint.

Input example

{
  "mode": "markets",
  "vsCurrency": "usd",
  "perPage": 5,
  "page": 1,
  "order": "market_cap_desc"
}

Output

One record per coin. Numeric fields arrive as values you can aggregate directly; last_updated is CoinGecko's own timestamp for the quote.

Every dataset record contains: id, symbol, name, image, current_price, market_cap, market_cap_rank, fully_diluted_valuation, total_volume, high_24h, low_24h, price_change_24h, price_change_percentage_24h, market_cap_change_24h, market_cap_change_percentage_24h, circulating_supply, total_supply, max_supply, ath, ath_change_percentage, ath_date, atl, atl_change_percentage, atl_date, last_updated, currency.

Output example

A real record from a run of this Actor:

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
  "current_price": "64232",
  "market_cap": "1289287417319",
  "market_cap_rank": "1",
  "fully_diluted_valuation": "1289287417319",
  "total_volume": "21371250454",
  "high_24h": "64516",
  "low_24h": "63246",
  "price_change_24h": "969.53",
  "price_change_percentage_24h": "0.9",
  "market_cap_change_24h": "19521493501",
  "market_cap_change_percentage_24h": "1.53741",
  "circulating_supply": "20071518.0",
  "total_supply": "20071518.0",
  "max_supply": "21000000.0",
  "ath": "126080",
  "ath_change_percentage": "-49.05462",
  "ath_date": "2025-10-06T10:57:42.000Z",
  "atl": "67.81"
}

Export the dataset as JSON, CSV, Excel, XML or JSONL from the Console, or pull it programmatically through the Apify API and any of the official clients.

How to use it

1. Click Try for free (or Start if you already have an Apify account).
2. Fill in the input fields described above — the defaults already produce a working run.
3. Press Start and watch the log; results stream into the dataset as they are found.
4. When the run finishes, open the Output/Storage tab and export as JSON, CSV or Excel.

Runs can be scheduled (hourly, daily, weekly) and wired into Slack, Google Sheets, Zapier, Make, webhooks or your own backend through Apify integrations. Everything the Console does is also available over the Apify API.

Pricing

This Actor is billed on Apify's pay-per-event model: a small charge when a run starts, plus a charge for each result written to the dataset. You only pay for records you actually receive — a run that finds nothing costs only the start event. Current rates are always shown on the Pricing tab of this page, and the run log prints your usage as it goes.

Free-plan credits from Apify cover a large amount of light usage, so you can evaluate the Actor before committing to anything.

FAQ

Do I need a CoinGecko API key?

No. The free public API is used by default. If you already hold a CoinGecko Pro key, put it in apiKey to get higher rate limits and more headroom on large paginated pulls.

How fresh is the data?

It is CoinGecko's live market data; each record carries last_updated so you can see exactly how fresh the quote is. For near-real-time monitoring, schedule frequent runs.

Can I get historical OHLC candles?

Not in this Actor — it returns the current market snapshot. The common pattern is to schedule it and accumulate your own history, which also gives you a series you fully control.

What's the difference between total_supply and max_supply?

circulating_supply is what's liquid today, total_supply is what exists including locked tokens, and max_supply is the protocol cap (null when there isn't one). Together they show future dilution.

Why is fully_diluted_valuation sometimes empty?

It requires a known max supply. Coins with uncapped or undefined supply have no meaningful FDV, so the field comes back empty.

Other Actors by cynix_dev

Actor	What it does
arXiv Papers Extractor	Search arXiv and extract papers as clean typed records: title, abstract, authors, categories, DOI, and direct PDF links.
FX Rates & History	Latest and historical foreign exchange rates (ECB reference data) as clean, typed dataset records.
USGS Earthquakes — GeoJSON Extractor	Pull live and historical earthquakes from the USGS FDSN event service as clean typed JSON: magnitude, place, time, lat/lon/depth, …
Launch Library 2 — Rocket Launch Tracker	Upcoming, previous, and specific rocket launches from The Space Devs' Launch Library 2 API.
Open Food Facts Extractor	Search and extract food-product data from Open Food Facts as clean typed JSON: name, brand, ingredients, allergens, nutrition …
FX Rates & History	Latest and historical foreign exchange rates (ECB reference data) as clean, typed dataset records.
SEC EDGAR Filings Extractor	Search and extract SEC EDGAR filings: full-text search across all filings or company filing histories by CIK.

Legal and responsible use

This Actor collects only publicly available information. You are responsible for how you use the data, including compliance with the target site's Terms of Service, robots directives, copyright, and data protection law such as GDPR and CCPA. Do not use it to gather personal data without a lawful basis.

Support and feedback

Found a bug, hit a site change, or need an extra field? Open a ticket on the Issues tab of this Actor — issues are read and fixed. Feature requests and custom-scraper enquiries are welcome through the same channel.