# CoinGecko Cryptocurrency Scraper (`parseforge/coingecko-scraper`) Actor

Scrapes CoinGecko coin listings by category and sort order, returning rank, price, market cap, volume, and more in your chosen currency. No API key required.

- **URL**: https://apify.com/parseforge/coingecko-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 3 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.17 / 1,000 results

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### CoinGecko Cryptocurrency Scraper

**Scrape cryptocurrency market data from CoinGecko, up to a million coins per run.** Each coin comes with its price, market cap, volume, and rank in your chosen currency. No API key required. Export to CSV, JSON, Excel, or XML.

CoinGecko's official API limits free calls and needs a key. This reads the public market listings directly, filtered by category and sorted by market cap or volume, and returns each coin in one fixed schema. It works for USD, EUR, GBP, JPY, BTC, and ETH.

| Who uses it | What they scrape CoinGecko for |
|---|---|
| Crypto traders | Which coins are moving right now by volume or market cap |
| Market researchers | How a category like DeFi or layer-2 is performing this week |
| Portfolio managers | A daily snapshot of top coins for rebalancing decisions |
| Data analysts | Clean CSV of coin metrics for trend analysis |
| Journalists | Current prices and market caps for crypto news stories |

### What it does

This Actor collects CoinGecko coin listings by category and sort order, and returns each coin as a flat row with its rank, price, market cap, volume, and other market data.

- 💱 **Multi-currency:** display prices in USD, EUR, GBP, JPY, BTC, or ETH.
- 📊 **Sort options:** order by market cap or volume, ascending or descending.
- 🏷️ **Category filter:** narrow to a CoinGecko category slug like decentralized-finance-defi or layer-2.
- 🔢 **Scalable:** collect from 1 to 1,000,000 coins per run.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with CoinGecko data

**📈 Track market movers.**

A trader runs the Actor daily with sort by volume descending to see which coins are suddenly active and worth a closer look.

**🔍 Research a niche category.**

A researcher filters by the decentralized-finance-defi category to list every DeFi coin with its market cap and volume for a sector report.

**💼 Build a portfolio snapshot.**

A portfolio manager collects the top 100 coins by market cap in USD every morning to update a holdings dashboard.

**📊 Feed a data pipeline.**

A data analyst schedules the Actor to export CSV into a warehouse, joining CoinGecko prices with on-chain metrics.

**🌍 Compare currency views.**

A journalist runs the same coin list in EUR and JPY to show how local investors see the market differently.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key** | Reads public CoinGecko listings directly, no registration or rate limits. |
| **Fixed schema** | Every coin returns the same flat fields for easy joins and analysis. |
| **Flexible currency** | Get prices in fiat or crypto, including BTC and ETH. |
| **Category targeting** | Focus on DeFi, smart contracts, layer-2, or any CoinGecko category. |
| **Large scale** | Collect up to a million coins in one run. |

### How it compares

This Actor focuses on flexible currency selection, category filtering, and large-scale collection, while the competitors below offer different scopes or integrations.

| Feature | ParseForge | Coingecko | Finance MCP Server | Cryptocurrency Market Data Scraper |
|---|---|---|---|---|
| Multi-currency support (USD, EUR, GBP, JPY, BTC, ETH) | Yes | Not listed | Not listed | Not listed |
| Category filter by CoinGecko slug | Yes | Not listed | Not listed | Not listed |
| Sort by market cap or volume | Yes | Not listed | Not listed | Not listed |
| Collect up to 1,000,000 coins per run | Yes | Not listed | Not listed | Not listed |
| No API key required | Yes | Not listed | Not listed | Yes |
| Trending coins data | Not listed | Not listed | Not listed | Yes |
| AI-powered market analysis | Not listed | Not listed | Yes | Not listed |

### Configure the run

Drive the Actor with a target currency, a maximum number of coins, an optional category slug, and a sort order. Filters run as each coin is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "vsCurrency": "usd",
  "maxItems": 10,
  "order": "market_cap_desc"
}
```

A larger pull:

```json
{
  "vsCurrency": "usd",
  "maxItems": 200,
  "order": "market_cap_desc"
}
```

### Pricing

Pay-per-result: **$0.00036 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.04 |
| 1,000 results | $0.36 |
| 10,000 results | $3.60 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [CoinGecko Cryptocurrency Scraper](https://apify.com/parseforge/coingecko-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to CoinGecko through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/coingecko-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check your category slug. It must exactly match a CoinGecko category slug, like decentralized-finance-defi. If you leave it empty, you should get all coins. Also verify your maxItems is at least 1.

**Why are prices different from the CoinGecko website?**

Prices update frequently. The Actor captures data at the moment of the run, so a few seconds of delay can cause small differences. Run again to get the latest.

**Why did the run stop before reaching my maxItems?**

CoinGecko may not list as many coins as you requested, especially if you used a category filter. The Actor returns all available coins up to your limit.

**Can I get more than 1,000,000 coins?**

No, the maximum is 1,000,000 coins per run. If you need more, split your request by category or run multiple times.

**Why is the volume field zero for some coins?**

Some coins have no reported trading volume on CoinGecko. The Actor returns the value as provided, which may be zero.

### FAQ

| Question | Answer |
|---|---|
| Do I need a CoinGecko API key? | No. This Actor reads the public CoinGecko market listings directly, so no registration or key is required. |
| What currencies can I get prices in? | You can choose USD, EUR, GBP, JPY, BTC, or ETH as the target currency for all prices and market caps. |
| How many coins can I scrape in one run? | You can set the maximum coins from 1 up to 1,000,000. The Actor will collect up to that many, depending on what CoinGecko lists. |
| Can I filter by coin category? | Yes. Enter a CoinGecko category slug like decentralized-finance-defi, smart-contract-platform, or layer-2 in the category field. Leave it empty to get all coins. |
| What sort orders are available? | You can sort by market cap or volume, in ascending or descending order. The default is market cap descending. |
| What data does each coin row include? | Each row includes the coin's rank, name, symbol, current price, market cap, volume, and other market data in your chosen currency. The exact fields are shown in the sample output. |
| Can I export the results? | Yes. You can export the dataset to CSV, JSON, Excel, or XML from the Apify platform. |
| Is this legal to scrape? | This Actor reads publicly available data from CoinGecko. You are responsible for complying with CoinGecko's terms of service and any applicable laws. |
| How often should I run this? | Crypto prices change constantly. Many users schedule the Actor every 5 to 15 minutes for near real-time data, or daily for a snapshot. |
| Can I get historical data? | No, this Actor returns the current market snapshot from CoinGecko. For historical OHLCV data, consider a different actor or the official API. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by CoinGecko. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

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

The target currency to display prices in

## `maxItems` (type: `integer`):

How many coins to collect per run.

## `category` (type: `string`):

Filter by coin category slug (e.g. decentralized-finance-defi, smart-contract-platform, layer-2). Leave empty to get all coins.

## `order` (type: `string`):

Sort coins by this field

## Actor input object example

```json
{
  "vsCurrency": "usd",
  "maxItems": 10,
  "order": "market_cap_desc"
}
```

# Actor output Schema

## `overview` (type: `string`):

Overview of scraped cryptocurrency data

## `fullData` (type: `string`):

Complete dataset with all scraped coin fields

# 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 = {
    "vsCurrency": "usd",
    "maxItems": 10,
    "order": "market_cap_desc"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/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 = {
    "vsCurrency": "usd",
    "maxItems": 10,
    "order": "market_cap_desc",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/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 '{
  "vsCurrency": "usd",
  "maxItems": 10,
  "order": "market_cap_desc"
}' |
apify call parseforge/coingecko-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/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/05Mjuiqge8v9ULhEF/builds/ZfYexr3uvQ845kje4/openapi.json