Coingecko Crypto Prices & Market Cap Scraper

Here is one real result, with every field the actor returns:

{
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "currentPrice": 64671,
  "marketCap": 1297846869995,
  "marketCapRank": 1,
  "totalVolume": 17135990479,
  "high24h": 65363,
  "low24h": 64469,
  "priceChange24h": -523.6328486847997,
  "priceChangePct24h": -0.6,
  "priceChangePct7d": 3,
  "marketCapChange24h": -10478829283.891113,
  "marketCapChangePct24h": -0.80093,
  "fullyDilutedValuation": 1297846869995,
  "circulatingSupply": 20068353,
  "totalSupply": 20068353,
  "maxSupply": 21000000,
  "ath": 126080,
  "athChangePct": -48.70606,
  "athDate": "2025-10-06T10:57:42.000Z",
  "atl": 67.81,
  "atlChangePct": 95272.79418,
  "atlDate": "2013-07-05T16:00:00.000Z",
  "roi": null,
  "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
  "lastUpdated": "2026-08-10T14:25:20.000Z",
  "source": "CoinGecko",
  "observedAt": "2026-08-10T14:28:24.718Z"
}

The most complete CoinGecko market scraper available. It returns every field the CoinGecko markets endpoint exposes for each coin, from current price, market cap, and rank to 24-hour and 7-day changes, supply figures, and all-time high and low with dates, ranked by market cap in the currency you choose.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor reads the CoinGecko markets data, ordered by market cap from highest to lowest, and writes one normalized record per coin to the run's dataset. Each record carries the coin identity (id, symbol, name), current price, market cap and rank, 24-hour trading volume, 24-hour and 7-day price changes, fully diluted valuation, circulating, total, and max supply, and the all-time high and low with the dates they occurred. All prices are expressed in the currency you set with vsCurrency. Missing source values are returned as null, never invented.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the top 10 coins by market cap, priced in USD.

{
  "maxCoins": 10,
  "vsCurrency": "usd"
}

Both input fields are optional. With an empty input the actor returns the top 10 coins in USD. Increase maxCoins for a longer list, or change vsCurrency to another fiat or crypto code such as eur, gbp, or btc.

Input reference

Field	Type	Required	Default	Description
maxCoins	integer	no	10	Maximum number of coins to collect, ordered by market cap (highest first). Free Apify plans are capped at 10.
vsCurrency	string	no	usd	The fiat or crypto currency to price coins in, for example usd, eur, gbp, jpy, btc, eth.

Output reference

One dataset item per coin. Types: string, number, integer, or null when the source value is absent.

Field	Type	Description
id	string	CoinGecko coin ID (unique), for example bitcoin.
symbol	string	Ticker symbol, for example BTC.
name	string	Coin name.
currentPrice	number	Current price in the chosen vsCurrency.
marketCap	number	Market capitalization.
marketCapRank	integer	Rank by market cap (1 is highest).
totalVolume	number	24-hour trading volume.
high24h	number	Highest price in the last 24 hours.
low24h	number	Lowest price in the last 24 hours.
priceChange24h	number	Absolute price change over 24 hours.
priceChangePct24h	number	Percent price change over 24 hours.
priceChangePct7d	number	Percent price change over 7 days.
marketCapChange24h	number	Absolute market cap change over 24 hours.
marketCapChangePct24h	number	Percent market cap change over 24 hours.
fullyDilutedValuation	number	Fully diluted valuation, or null.
circulatingSupply	number	Circulating supply.
totalSupply	number	Total supply, or null.
maxSupply	number	Maximum supply, or null if uncapped.
ath	number	All-time high price.
athChangePct	number	Percent change from the all-time high.
athDate	string	ISO 8601 date of the all-time high.
atl	number	All-time low price.
atlChangePct	number	Percent change from the all-time low.
atlDate	string	ISO 8601 date of the all-time low.
roi	object	Return-on-investment object when present, otherwise null.
image	string	Coin logo image URL.
lastUpdated	string	ISO 8601 timestamp CoinGecko last updated the coin.
source	string	Data source. Always CoinGecko.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed run. A single item with a populated error field is written instead, and it is not charged.

Example output record

Real record from a live run (input {"maxCoins": 10, "vsCurrency": "usd"}):

{
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "currentPrice": 64671,
  "marketCap": 1297846869995,
  "marketCapRank": 1,
  "totalVolume": 17135990479,
  "high24h": 65363,
  "low24h": 64469,
  "priceChange24h": -523.6328486847997,
  "priceChangePct24h": -0.6,
  "priceChangePct7d": 3,
  "marketCapChange24h": -10478829283.891113,
  "marketCapChangePct24h": -0.80093,
  "fullyDilutedValuation": 1297846869995,
  "circulatingSupply": 20068353,
  "totalSupply": 20068353,
  "maxSupply": 21000000,
  "ath": 126080,
  "athChangePct": -48.70606,
  "athDate": "2025-10-06T10:57:42.000Z",
  "atl": 67.81,
  "atlChangePct": 95272.79418,
  "atlDate": "2013-07-05T16:00:00.000Z",
  "roi": null,
  "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
  "lastUpdated": "2026-08-10T14:25:20.000Z",
  "source": "CoinGecko",
  "observedAt": "2026-08-10T14:28:24.718Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~coingecko-crypto-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"maxCoins":50,"vsCurrency":"usd"}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~coingecko-crypto-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"maxCoins":100,"vsCurrency":"eur"}'

Apify CLI:

apify call scrapers_lat/coingecko-crypto-scraper \
  --input '{"maxCoins":10,"vsCurrency":"usd"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per coin record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxCoins.

FAQ and troubleshooting

How are coins ordered? By market capitalization, highest first. The first record is the largest coin by market cap, so maxCoins of 10 returns the top 10.

Can I price coins in something other than USD? Yes. Set vsCurrency to any supported fiat or crypto code, for example eur, gbp, jpy, btc, or eth. All price and market-cap fields are then expressed in that currency.

Why is maxSupply or roi null? Not every coin has a capped max supply or a reported return-on-investment. Missing source values are returned as null, never invented.

How current is the data? Each record includes lastUpdated from CoinGecko and observedAt from the run, so you can see exactly how fresh the price is.

Is this an official CoinGecko tool? No. This actor is independent and has no affiliation with CoinGecko. It reads only data that is publicly available through CoinGecko.

Related scrapers

• Argentina Dolar Scraper: Argentine peso to US dollar exchange rates.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with CoinGecko. Accesses only publicly available CoinGecko market data.