# CoinGecko Crypto Market Data Scraper (`hipersoft/coingecko-scraper`) Actor

Live cryptocurrency market data from CoinGecko: price, market cap, rank, 24h volume & change, ATH/ATL, supply and more. Fetch the top coins by market cap, specific coins by symbol/name, or trending coins. Fast clean HTTP, no setup.

- **URL**: https://apify.com/hipersoft/coingecko-scraper.md
- **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0004 / coin scraped

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## CoinGecko Scraper — Crypto Prices, Market Cap, Volume & ATH/ATL

Get live **cryptocurrency market data** from CoinGecko as clean, structured **JSON, CSV, Excel or XML**: **price, market cap, rank, 24h volume and change, ATH/ATL, circulating and total supply** and more. Pull the top coins by market cap, look up specific coins by symbol/name/id, or add the currently trending coins — all in one run. Fast and reliable.

![CoinGecko Scraper input — coin list, max coins and quote currency in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/coingecko-scraper-input.png?v=2)

### What does CoinGecko Scraper do?

This CoinGecko scraper turns crypto market data into a structured dataset. Ask for the top N coins by market cap, a specific watchlist, or the trending list, and it returns a flat record per coin with price, market cap, volume, supply and all-time-high/low data points. Use it to power dashboards, portfolio trackers and research pipelines, and export the results in any format the Apify platform supports.

### What data can you scrape from CoinGecko?

| Data point | Description |
| --- | --- |
| Coin id, symbol & name | CoinGecko id, ticker symbol and display name. |
| Logo image | URL of the coin's logo. |
| Current price | Latest price in your chosen quote currency. |
| Market cap & rank | Market capitalisation and its rank. |
| Fully diluted valuation | FDV based on max supply. |
| 24h volume | Total traded volume over 24 hours. |
| 24h high / low | Highest and lowest price in the last 24 hours. |
| 24h change | Absolute and percentage price change over 24 hours. |
| Supply | Circulating, total and max supply. |
| ATH / ATL | All-time high and low, with dates and % change. |
| Trending flag | Whether the coin is currently trending. |

### Use cases

- **Live dashboards** — power a price/market-cap dashboard or portfolio tracker.
- **Time-series snapshots** — capture the top 100–1,000 coins on a schedule for analysis.
- **Watchlist monitoring** — track specific tokens and their 24h movement.
- **Momentum signals** — record trending coins for research or trading signals.
- **Dataset building** — feed structured crypto data into BI tools, models or apps.

### How to scrape CoinGecko data

1. Add **CoinGecko Scraper** to your Apify account and open its input.
2. Leave **coins** empty for the top coins by market cap, or list specific coins (e.g. `BTC`, `ethereum`).
3. Set **maxCoins**, pick a **vsCurrency**, and optionally enable **includeTrending**.
4. Click **Run**.
5. Export the results as JSON, CSV, Excel or XML, or fetch them through the Apify API.

### Input

```json
{
  "coins": [],
  "maxCoins": 100,
  "vsCurrency": "usd",
  "includeTrending": true
}
```

| Field | Description |
| --- | --- |
| `coins` | Specific coin symbols, names or CoinGecko ids (e.g. `BTC`, `ethereum`). Empty = top coins. |
| `maxCoins` | How many top coins by market cap to fetch when no specific coins are given. |
| `vsCurrency` | Quote currency to price against (e.g. `usd`, `eur`, `btc`). |
| `includeTrending` | Also include the currently trending coins and flag them. |
| `proxyConfiguration` | Standard Apify proxy settings for the run. |

### What you get

One flat JSON record per coin, ready to export to CSV, Excel, JSON or XML.

![CoinGecko Scraper output example — coin rows with price, market cap and 24h change as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/coingecko-scraper-output.png?v=5)

```json
{
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "image": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png",
  "currentPrice": 61234.55,
  "marketCap": 1203450000000,
  "marketCapRank": 1,
  "fullyDilutedValuation": 1287000000000,
  "totalVolume": 28500000000,
  "high24h": 62010.12,
  "low24h": 60110.88,
  "priceChange24h": 512.44,
  "priceChangePct24h": 0.84,
  "circulatingSupply": 19700000,
  "totalSupply": 21000000,
  "maxSupply": 21000000,
  "ath": 73800.0,
  "athChangePct": -17.02,
  "athDate": "2024-03-14T07:10:36.635Z",
  "atl": 67.81,
  "atlDate": "2013-07-06T00:00:00.000Z",
  "lastUpdated": "2026-07-23T09:15:04.123Z",
  "isTrending": false
}
```

#### Output schema

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | CoinGecko id for the coin. |
| `symbol` | string | Ticker symbol. |
| `name` | string | Display name of the coin. |
| `image` | string (URL) | URL of the coin's logo image. |
| `currentPrice` | integer | Latest price in the chosen quote currency. |
| `marketCap` | integer | Market capitalisation. |
| `marketCapRank` | integer | Rank by market capitalisation. |
| `fullyDilutedValuation` | integer | Fully diluted valuation (based on max supply). |
| `totalVolume` | integer | Total traded volume over 24 hours. |
| `high24h` | integer | Highest price in the last 24 hours. |
| `low24h` | integer | Lowest price in the last 24 hours. |
| `priceChange24h` | number | Absolute price change over 24 hours. |
| `priceChangePct24h` | number | Percentage price change over 24 hours. |
| `circulatingSupply` | integer | Circulating supply. |
| `totalSupply` | integer | Total supply. |
| `maxSupply` | integer | Maximum supply (null when uncapped). |
| `ath` | integer | All-time-high price. |
| `athChangePct` | number | Percentage change from the all-time high. |
| `athDate` | string (ISO date) | Date of the all-time high. |
| `atl` | number | All-time-low price. |
| `atlDate` | string (ISO date) | Date of the all-time low. |
| `lastUpdated` | string (ISO date) | Timestamp when the values were last updated. |
| `isTrending` | boolean | True when the coin is currently trending. |

### Need more market data?

- [DefiLlama Scraper](https://apify.com/hipersoft/defillama-scraper) — DeFi protocols, yields, chains and stablecoins with TVL and APY.
- [Yahoo Finance Scraper](https://apify.com/hipersoft/yahoo-finance-scraper) — live quotes and OHLCV history for stocks, ETFs, crypto and forex.
- [SEC EDGAR Filings Scraper](https://apify.com/hipersoft/sec-edgar-scraper) — 10-K, 10-Q and 8-K filings by ticker or CIK.

### FAQ

**How many coins can I get per run?**
As many as you set with `maxCoins`; the actor paginates automatically. You can also pass a specific `coins` list instead.

**Which quote currencies are supported?**
Common fiat and crypto quote currencies such as `usd`, `eur`, `gbp` and `btc`, via the `vsCurrency` input.

**How fresh is the data?**
Prices, market cap and volume are pulled live at run time, and each record carries a `lastUpdated` timestamp.

**What export formats are available?**
JSON, CSV, Excel and XML, plus programmatic access through the Apify API.

**Can I connect this to my other tools?**
The CoinGecko Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

**Is this official CoinGecko data?**
The data reflects public CoinGecko market data, but this actor is an independent tool and is not affiliated with or endorsed by CoinGecko.

### Related Actors

- [DefiLlama Scraper](https://apify.com/hipersoft/defillama-scraper)
- [Yahoo Finance Scraper](https://apify.com/hipersoft/yahoo-finance-scraper)
- [SEC EDGAR Filings Scraper](https://apify.com/hipersoft/sec-edgar-scraper)

### Notes

Original clean-room implementation. Returns only public market data; you are responsible for compliant use. Not affiliated with CoinGecko; all trademarks belong to their respective owners.

# Actor input Schema

## `coins` (type: `array`):

Coin symbols, names or CoinGecko ids (e.g. "BTC", "ethereum", "solana"), one per line. Leave empty to fetch the top coins by market cap.

## `maxCoins` (type: `integer`):

How many top coins to fetch when no specific coins are given (250 per API request).

## `vsCurrency` (type: `string`):

Fiat/crypto to price against (e.g. usd, eur, gbp, btc).

## `includeTrending` (type: `boolean`):

Append CoinGecko's currently trending coins.

## `proxyConfiguration` (type: `object`):

Optional. The CoinGecko public API works without a proxy.

## Actor input object example

```json
{
  "coins": [],
  "maxCoins": 100,
  "vsCurrency": "usd",
  "includeTrending": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "coins": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/coingecko-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "coins": [] }

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/coingecko-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "coins": []
}' |
apify call hipersoft/coingecko-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/coingecko-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/52JxsfPv55BbiMshu/builds/xtLOs43hAx5qixlTl/openapi.json