## CoinGecko Crypto Data Scraper
**๐ฐ $2.00 / 1 000 results** ยท pay only for results ยท no credit card to try
_We do the dirty work so your dataset stays clean._ ๐
Pull rich market data for any crypto asset โ price, 24h change, market cap, volume, supply, ATH/ATL, exchanges, and on-chain stats. We handle the rate limits, retries, fingerprint rotation, and proxy routing โ you get one clean typed row per coin, on a schedule, exported wherever your stack lives.
bitcoin, ethereum), absorbs the upstream's rate limits and transient errors with backoff, and writes one row per coin โ current price in USD + your chosen vs currency, 24h price change, market cap, volume, circulating supply, ATH/ATL with dates, sentiment, and exchange listing count. Run it once for a snapshot or on a schedule for a time-series โ we keep the connection honest so your dataset stays clean.
### ๐ฅ What we handle for you
- ๐ก๏ธ **Browser fingerprint rotation** โ `curl-cffi` impersonates real Chrome / Firefox / Safari TLS handshakes so the target sees a browser, not Python.
- ๐ **Residential proxy rotation** via Apify Proxy โ fresh session and exit IP on every block.
- ๐ **Retries with exponential backoff** on `408 / 429 / 5xx` โ up to 5 attempts per page, `Retry-After` honoured.
- ๐งฑ **Rate-limit-aware pacing** โ when the target pushes back, we slow down instead of getting banned.
- ๐ง **Clean, typed dataset rows** โ Pydantic-validated, ISO-8601 timestamps, stable IDs, JSON / CSV / Excel export straight from the Apify Console.
- ๐ฐ **Pay-Per-Event pricing** โ you only pay for results that hit your dataset. No data, no charge.
### ๐ก Use cases
- **Portfolio tracker** โ schedule a daily run with your watch list, pipe to a spreadsheet.
- **Alerting** โ diff successive runs, alert when 24h change crosses a threshold.
- **Research** โ pull 50 coins by market cap rank, feed into a trading-strategy backtest.
- **Tax reporting** โ daily price snapshots stored for capital-gains math.
### โ๏ธ How to use it
1. Click **Try for free** at the top of the page.
2. Fill in the input form โ most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage โ Dataset** as JSON, CSV, or Excel โ or fetch via the API.
### ๐ฅ Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `coinIds` | `array` | **yes** | ['bitcoin', 'ethereum', 'solana'] | List of CoinGecko coin IDs (lowercase slugs). Find them at coingecko.com โ the slug in the URL. Examples: bitcoin< |
| `vsCurrency` | `string` | no | 'eur' | ISO currency code (lowercase) to add alongside USD โ e.g. eur, gbp, jpy. USD is a |
| `includeDeveloperData` | `boolean` | no | False | Add GitHub forks/stars/commits where the coin has a linked repo. |
| `apiKey` | `string` | no | 'โ' | Optional โ lifts the demo-tier limit from 10 req/min to your plan's quota. |
| `concurrency` | `integer` | no | 2 | Parallel coin lookups. Keep low on the demo tier (10 req/min ceiling). |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': False} | Optional. CoinGecko sometimes rate-limits aggressive scrapers โ Apify Proxy with rotating sessions helps in that case. |
#### Example input
```json
{
"coinIds": [
"bitcoin",
"ethereum"
],
"vsCurrency": "eur",
"concurrency": 2,
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
### ๐ค Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `coin_id` | `string` | CoinGecko coin slug. |
| `symbol` | `string` | Ticker symbol. |
| `name` | `string` | Coin display name. |
| `image_url` | `['string', 'null']` | Coin logo (large) URL. |
| `current_price_usd` | `['number', 'null']` | Current price in USD. |
| `current_price_vs` | `['number', 'null']` | Current price in the secondary `vsCurrency`. |
| `vs_currency` | `string` | Secondary currency code used. |
| `price_change_24h_pct` | `['number', 'null']` | 24h price change percent. |
| `price_change_7d_pct` | `['number', 'null']` | 7d price change percent. |
| `price_change_30d_pct` | `['number', 'null']` | 30d price change percent. |
| `market_cap_usd` | `['number', 'null']` | Market cap in USD. |
| `market_cap_rank` | `['integer', 'null']` | Market cap rank across all coins. |
| `total_volume_usd` | `['number', 'null']` | 24h trading volume in USD. |
| `circulating_supply` | `['number', 'null']` | Circulating supply. |
| `total_supply` | `['number', 'null']` | Total supply. |
| `max_supply` | `['number', 'null']` | Maximum supply (null for unlimited). |
| `ath_usd` | `['number', 'null']` | All-time high in USD. |
| `ath_date` | `['string', 'null']` | ATH timestamp (ISO-8601). |
| `atl_usd` | `['number', 'null']` | All-time low in USD. |
| `atl_date` | `['string', 'null']` | ATL timestamp. |
| `sentiment_up_pct` | `['number', 'null']` | Community sentiment % bullish. |
| `exchanges_count` | `['integer', 'null']` | Number of exchanges listing this coin. |
| `github_stars` | `['integer', 'null']` | GitHub stars (when includeDeveloperData=true). |
| `github_forks` | `['integer', 'null']` | GitHub forks. |
| `coingecko_url` | `string` | Canonical CoinGecko URL. |
| `scraped_at` | `string` | When this row was recorded. |
#### Example output
```json
{
"coin_id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"current_price_usd": 71250.32,
"current_price_vs": 65120.1,
"vs_currency": "eur",
"price_change_24h_pct": 2.41,
"market_cap_usd": 1408000000000,
"market_cap_rank": 1,
"coingecko_url": "https://www.coingecko.com/en/coins/bitcoin"
}
```
### ๐ฐ Pricing
Pay-Per-Event โ you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.005 | One-off warm-up charge per run |
| `result` | $0.002 | Per dataset item |
Example: 1 000 results at the rates above โ **$2.00**. No subscription, no minimum, no card to start โ Apify gives every new account $5 of free credit.
### ๐ง Limitations
Demo tier is rate-limited (~10 req/min). For thousands of coins, attach a CoinGecko Pro key. Some fields are null for low-coverage coins.
### โ FAQ
**Is this real-time?**
CoinGecko's free API updates every ~60 seconds. For sub-second feeds, use an exchange WebSocket.
**What about historical OHLC?**
Out of scope here โ see the sibling `coingecko-ohlc-scraper` (planned).
**Why am I getting 429s?**
The free tier caps you at ~10 req/min from a single IP. Slow concurrency or attach a Pro key.
**Can I filter by category?**
Pass the full ID list. Category enumeration is on the roadmap.
### ๐ฌ Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console โ we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** ๐ โ a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `coinIds` (type: `array`):
List of CoinGecko coin IDs (lowercase slugs). Find them at coingecko.com โ the slug in the URL. Examples: bitcoin, ethereum, solana.
## `vsCurrency` (type: `string`):
ISO currency code (lowercase) to add alongside USD โ e.g. eur, gbp, jpy. USD is always included.
## `includeDeveloperData` (type: `boolean`):
Add GitHub forks/stars/commits where the coin has a linked repo.
## `apiKey` (type: `string`):
Optional โ lifts the demo-tier limit from 10 req/min to your plan's quota.
## `concurrency` (type: `integer`):
Parallel coin lookups. Keep low on the demo tier (10 req/min ceiling).
## `proxyConfiguration` (type: `object`):
Optional. CoinGecko sometimes rate-limits aggressive scrapers โ Apify Proxy with rotating sessions helps in that case.
## Actor input object example
```json
{
"coinIds": [
"bitcoin",
"ethereum",
"solana"
],
"vsCurrency": "eur",
"includeDeveloperData": false,
"concurrency": 2,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"coinIds": [
"bitcoin",
"ethereum",
"solana"
],
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/coingecko-crypto-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"coinIds": [
"bitcoin",
"ethereum",
"solana",
],
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/coingecko-crypto-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"coinIds": [
"bitcoin",
"ethereum",
"solana"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call devilscrapes/coingecko-crypto-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=devilscrapes/coingecko-crypto-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "CoinGecko Crypto Data Scraper",
"description": "Pull rich market data for any crypto asset โ price, 24h change, market cap, volume, supply, ATH/ATL, exchanges, and on-chain stats. Built on CoinGecko's public API (free demo tier). One row per coin.",
"version": "0.4",
"x-build-id": "JVsc9xFxja7dxPWdO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~coingecko-crypto-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-coingecko-crypto-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/devilscrapes~coingecko-crypto-scraper/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-coingecko-crypto-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/devilscrapes~coingecko-crypto-scraper/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-coingecko-crypto-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"coinIds"
],
"properties": {
"coinIds": {
"title": "CoinGecko coin IDs",
"type": "array",
"description": "List of CoinGecko coin IDs (lowercase slugs). Find them at coingecko.com โ the slug in the URL. Examples: bitcoin, ethereum, solana.",
"items": {
"type": "string"
}
},
"vsCurrency": {
"title": "Secondary quote currency",
"type": "string",
"description": "ISO currency code (lowercase) to add alongside USD โ e.g. eur, gbp, jpy. USD is always included.",
"default": "eur"
},
"includeDeveloperData": {
"title": "Include developer stats",
"type": "boolean",
"description": "Add GitHub forks/stars/commits where the coin has a linked repo.",
"default": false
},
"apiKey": {
"title": "CoinGecko Pro API key (optional)",
"type": "string",
"description": "Optional โ lifts the demo-tier limit from 10 req/min to your plan's quota."
},
"concurrency": {
"title": "Concurrent fetches",
"minimum": 1,
"maximum": 32,
"type": "integer",
"description": "Parallel coin lookups. Keep low on the demo tier (10 req/min ceiling).",
"default": 2
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. CoinGecko sometimes rate-limits aggressive scrapers โ Apify Proxy with rotating sessions helps in that case.",
"default": {
"useApifyProxy": false
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```