CoinGecko markets — coin prices, caps, volumes, history (API)

One flat row per coin from CoinGecko's public REST API v3: price, market cap and rank, 24h volume, 24h/7d/30d change, all-time high, circulating/total/max supply and the CoinGecko URL. Three more modes: daily price/cap/volume history for chosen coins, the 15 trending coins, and every CoinGecko category with its market cap. Normalised, ready for CSV or JSON. Optional Demo or Pro API key.

The default input (markets, USD, top 250 by market cap) is one request, succeeds within 5 minutes and returns rows — Apify auto-tests it daily.

Data source and status

Publisher	CoinGecko (Gecko Labs Pte. Ltd.)
API	https://api.coingecko.com/api/v3 — public tier without a key; Demo key (free) or Pro key (paid, pro-api.coingecko.com) optional. Documentation: https://docs.coingecko.com/reference/introduction
What this Actor reads	GET /coins/markets (250 coins per request, price_change_percentage=24h,7d,30d), GET /coins/{id}/market_chart?days=N&interval=daily, GET /search/trending, GET /coins/categories — plain GETs, at most one per 6.5 s by default
Refresh cadence	CoinGecko updates market rows roughly every 1–5 minutes (last_updated on each row); history is one point per UTC day (5-minute points when days = 1); trending is recomputed continuously. The Actor reads live on every run; fetched_at is the fetch time
Terms / attribution	CoinGecko's API terms (https://www.coingecko.com/en/api_terms) require attribution: "Data provided by CoinGecko" with a link to https://www.coingecko.com. The keyless public and Demo tiers are for non-commercial use; commercial use needs a paid CoinGecko plan (set api_key + api_tier: pro). You are responsible for using the data within those terms
Known caveats	Rate limit: the keyless tier allows roughly 5–15 requests per minute and answers HTTP 429 when exceeded — the Actor waits 6.5 s between requests by default and backs off 15/30/60 s on 429; a Demo key allows 30/min (set request_interval_ms to 2000). History is capped at 365 days on the public tier. Trending market_cap_text / total_volume_text are the API's display strings (e.g. $1,234,567), not numbers. price_change_percentage_7d is null when the API has no 7-day series for a coin. An unknown coin id makes the API answer HTTP 404 and the run fails with that message

Honesty note: market data only, as published by CoinGecko — nothing is inferred; this is not financial advice; not affiliated with CoinGecko.

Identification: the requests carry a product-token User-Agent and the operator's contact address in the standard From: header (RFC 9110 §10.1.2).

Input

Field	Type	Meaning
mode	select	markets (default), coin_history, trending, categories
vs_currency	string	Quote currency code, default usd (list: /simple/supported_vs_currencies)
coin_ids	array	CoinGecko ids (bitcoin, ethereum …). Required for coin_history; optional filter for markets
days	integer	coin_history only: 1–365, default 30
order	select	markets only: market_cap_desc (default), market_cap_asc, volume_desc, volume_asc, id_asc, id_desc
max_records	integer	Default 250; markets at most 2,500 (10 requests)
api_key	secret string	Optional Demo or Pro key (never written anywhere)
api_tier	select	demo (default) or pro
request_interval_ms	integer	Default 6500 (floor 1000)
contact_email	string	Sent in the From: header

Example — 14 days of daily history for Bitcoin and Ethereum (2 requests, 30 rows):

{ "mode": "coin_history", "vs_currency": "usd", "coin_ids": ["bitcoin", "ethereum"], "days": 14 }

Output (dataset row)

Every row carries mode, vs_currency, coingecko_url and fetched_at.

• markets: id, symbol, name, current_price, market_cap, market_cap_rank, fully_diluted_valuation, total_volume, high_24h, low_24h, price_change_24h, price_change_percentage_24h, price_change_percentage_7d, price_change_percentage_30d, market_cap_change_percentage_24h, circulating_supply, total_supply, max_supply, ath, ath_change_percentage, ath_date, atl, atl_date, last_updated, image.
• coin_history: id, timestamp (UTC), date, price, market_cap, total_volume.
• trending: rank, id, name, symbol, score, market_cap_rank, price, price_btc, price_change_percentage_24h, market_cap_text, total_volume_text, image.
• categories: id, name, market_cap, market_cap_change_24h (%), volume_24h, top_3_coins (ids), top_3_coin_images, updated_at.

A run summary (mode, filters, requests, retries, whether the pay-per-event budget stopped the run) is stored as RUN_SUMMARY in the run's key-value store.

Pricing (pay per event)

Event	Price
run-start — once per run	$0.10
record — per row written	$0.005

The default top-250 pull costs $1.35; trending (15 rows) $0.175; 30 days of history for one coin $0.255. Rows stop when your run's maximum charge is reached; the run summary says so.

Operator

Steelyard Ventures LLC (RetrainMap) — info@steelyardclinical.com. Not affiliated with CoinGecko. The Actor writes only to its own dataset and key-value store; your API key is sent only to CoinGecko and is never logged or stored.