# CoinMarketCap Scraper \[Only $1.5] | Crypto Prices | Market Cap (`ahmed_jasarevic/coinmarketcap-scraper`) Actor

Extract CoinMarketCap crypto data - price, market cap, volume, ATH/ATL, descriptions, social links, and sector categories. No API key needed, no browser. Export to JSON, CSV, or Excel for portfolio trackers, trading bots, and market research.

- **URL**: https://apify.com/ahmed\_jasarevic/coinmarketcap-scraper.md
- **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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.

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

## CoinMarketCap Scraper — Crypto Prices, Market Cap & Data Without API Key

Extract live cryptocurrency market data from [CoinMarketCap](https://coinmarketcap.com) — **rank, price, market cap, 24h volume, 1h/24h/7d/30d/60d/90d changes, circulating/total/max supply, ATH/ATL** — plus per-coin **description, official website, social links, tags and sector categories**. No API key required. No browser needed. Pure HTTP speed.

### What You Can Do With This Data

- **Crypto price monitoring** — track live prices, market cap, and volume for any number of coins
- **Market research & competitor analysis** — compare coin metrics, dominance, and sector categories
- **Portfolio tracker data feeds** — power dashboards, bots, and alerts with structured CoinMarketCap data
- **Coin database creation** — build comprehensive crypto databases with descriptions, links, and classifications
- **Sector & category analysis** — filter and analyze DeFi, Layer 1, memes, AI tokens, and other sectors
- **Trading bot feeds** — supply real-time market data to automated trading strategies

### How It Works (No Browser, No API Key)

This actor never renders a page and never needs an API key. It calls the **same internal JSON API that powers the coinmarketcap.com frontend**, which returns clean structured data with no authentication, no cookies, and no JavaScript rendering:

1. **Listings** — `GET https://api.coinmarketcap.com/data-api/v3/cryptocurrency/listing` — paginated with `start`/`limit` (200 per page); returns rank, supplies, ATH/ATL and `quotes[]` array with price, volume, market cap, and percent changes.
2. **Coin detail** — `GET https://api.coinmarketcap.com/data-api/v3/cryptocurrency/detail` — returns description (markdown), official URLs (website, whitepaper, explorers, socials), tags with category classifications, dominance, and launch date.

This API returns HTTP 200 JSON from any network — cheaper, faster, and more reliable than parsing HTML pages.

### Extract Cryptocurrency Prices & Market Cap Rankings

Get the top N cryptocurrencies ranked by market cap (or price, or 24h volume), starting from any rank. Each result includes real-time price, market cap, fully diluted market cap, 24h volume, and percent changes across 1h, 24h, 7d, 30d, 60d, and 90d timeframes.

### Get Full Coin Profiles With Descriptions & Social Links

Enable **Include coin details** to fetch each coin's full profile: description (markdown), official website, whitepaper, blockchain explorers, source code links, Twitter, Reddit, Facebook, and community channels. Also includes sector category tags (e.g., "Store Of Value", "Layer 1", "DeFi").

### Build Business Databases Without Official API Access

Unlike the official CoinMarketCap Pro API which requires registration, API keys, and paid plans for historical data, this actor uses the same public endpoints the website itself uses — free, no account needed, no rate-limit headaches.

### Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `limit` | integer | No | 100 | Max coins to scrape. Free users capped at 20 per run. |
| `startRank` | integer | No | 1 | Market-cap rank to start from (1 = Bitcoin). |
| `convert` | string | No | USD | Quote currency: USD, EUR, BTC, or ETH. |
| `sortBy` | string | No | market\_cap | Ranking criterion: `market_cap`, `price`, or `volume_24h`. |
| `includeDetails` | boolean | No | true | Fetch per-coin description, links, tags, categories (+1 request/coin). |
| `useApifyProxy` | boolean | No | true | Route through Apify proxy (recommended). |
| `proxyGroups` | array | No | \[] | Optional proxy groups. Empty = AUTO. |
| `maxConcurrency` | integer | No | 4 | Parallel requests (1-10). Keep 2-4 for politeness. |
| `maxRequestsPerCrawl` | integer | No | 5000 | Hard safety cap on total HTTP requests. |

### Output

Each dataset item is one cryptocurrency coin. Fields include:

| Field | Description |
|---|---|
| `rank` / `id` / `name` / `symbol` / `slug` / `url` | Coin identity + canonical CoinMarketCap page URL |
| `price` / `marketCap` / `fullyDilutedMarketCap` | Quote in selected currency |
| `volume24h` / `volumeChange24hPct` | 24h trading volume + change |
| `percentChange1h` / `24h` / `7d` / `30d` / `60d` / `90d` | Price changes across timeframes |
| `circulatingSupply` / `totalSupply` / `maxSupply` | Supply figures |
| `ath` / `atl` / `high24h` / `low24h` | All-time and 24h extremes |
| `description` | Full coin description (markdown) |
| `website` / `whitepaper` / `explorers` / `sourceCode` | Official links |
| `socials` | Twitter, Reddit, Facebook, chat, announcement, message board |
| `categories` | Sector categories (tags classified as CATEGORY) |
| `allTags` | Every tag with slug, name, and category |
| `dateAdded` / `dateLaunched` / `lastUpdated` / `watchCount` / `marketDominancePct` | Metadata |

### Example Input

```json
{
  "limit": 10,
  "startRank": 1,
  "convert": "USD",
  "sortBy": "market_cap",
  "includeDetails": true,
  "useApifyProxy": true,
  "maxConcurrency": 4
}
```

### Example Output

```json
{
  "rank": 1,
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "url": "https://coinmarketcap.com/currencies/bitcoin/",
  "price": 113518.59,
  "marketCap": 2262122015204.01,
  "fullyDilutedMarketCap": 2383997224920.21,
  "volume24h": 56116036480.55,
  "volumeChange24hPct": -1.47,
  "percentChange1h": 0.05,
  "percentChange24h": 0.83,
  "percentChange7d": 3.14,
  "circulatingSupply": 19925828,
  "totalSupply": 19925828,
  "maxSupply": 21000000,
  "ath": 126198.06,
  "atl": 0.048,
  "high24h": 114200.00,
  "low24h": 112800.00,
  "description": "## What Is Bitcoin (BTC)? ...",
  "website": "https://bitcoin.org/",
  "socials": { "twitter": null, "reddit": "https://reddit.com/r/bitcoin" },
  "categories": ["Store Of Value", "Layer 1 (L1)"],
  "dateLaunched": "2010-07-13T00:00:00.000Z"
}
```

### Integrations & Automation

Connect your crypto data to the tools you already use:

- **API & Webhooks** — pull results directly into your backend, Python scripts, or notebooks
- **Zapier / Make / n8n** — trigger automated workflows on each run, push data to Sheets, Slack, Notion, or Airtable
- **Schedule runs** — set up hourly or daily schedules to keep price feeds and market snapshots always fresh
- **CSV / Excel / JSON export** — download datasets in any format directly from the Apify platform

For trading bots and portfolio trackers, schedule daily snapshots to maintain a historical record without manual intervention.

### Related Actors

| Actor | What It Adds |
|---|---|
| [CoinGecko Crypto Scraper](https://apify.com/gentle_cloud/cryptocurrency-market-data-scraper) | Alternative crypto data source with category support and no API key |
| [CoinPaprika Crypto Market Scraper](https://apify.com/logiover/coinpaprika-crypto-market-scraper) | Additional market data source with different aggregation methodology |
| [DexScreener Scraper](https://apify.com/automation-lab/dexscreener-scraper) | DEX trading pairs, liquidity, and token data across 60+ blockchains |
| [CoinMarketCap Trending Scraper](https://apify.com/andok/cmc-trending-scraper) | Trending coins and breakout altcoins for momentum strategies |
| [CryptoCompare Market Data Scraper](https://apify.com/crawlergang/crypto-compare-scraper) | Historical OHLCV price series and exchange rankings |

### FAQ

#### Why use this actor instead of the official CoinMarketCap API?

The official CoinMarketCap Pro API requires registration, API key management, and paid plans ($29-$699/mo) for features like historical data and higher rate limits. This actor uses CoinMarketCap's own public internal endpoints — the same ones that power the website — requiring zero authentication, zero registration, and zero monthly fees. It's faster to start, cheaper at scale, and avoids credit-based billing.

#### What are alternatives to this data source?

CoinGecko, CoinPaprika, CryptoCompare, and DexScreener all provide cryptocurrency market data through their own APIs. CoinGecko is the most popular free alternative with 13,000+ tracked assets. CoinPaprika offers free endpoints with commercial use restrictions. CryptoCompare provides historical OHLCV data. This actor specifically targets CoinMarketCap's data because it's the industry-standard reference for market cap rankings used by Yahoo Finance and major financial platforms.

#### Do I need a CoinMarketCap API key?

No. This actor uses the website's own internal data API endpoints, not the commercial Pro API. No account, no key, no registration required.

#### How many coins can I scrape per run?

Free Apify users can scrape up to 20 coins per run. Paid Apify users can set the limit up to 2,000 coins. The actor automatically paginates (200 per page) within your request cap.

#### Is this legal?

The actor reads CoinMarketCap's public data API with modest concurrency. Respect CoinMarketCap's Terms of Service and use the data for analysis and research. This actor does not scrape personal data — only public market data.

#### Can I schedule this for daily price monitoring?

Yes. Use Apify's scheduler to run the actor hourly, daily, or at any custom interval. This is ideal for building historical price records, powering trading bots, or keeping dashboards updated.

#### How much does it cost to run?

Runs are plain HTTP JSON requests — no browser overhead, minimal compute usage. Roughly a few compute units per 100 coins with details enabled. The per-event cost is $0.0015 per result.

### SEO Keywords

coinmarketcap scraper, cryptocurrency price scraper, crypto market cap data, coinmarketcap api alternative, no api key crypto data, bitcoin price scraper, ethereum market data, crypto data extraction, coinmarketcap no login, cryptocurrency rankings scraper, crypto market data api free, top coins by market cap, coinmarketcap internal api, crypto portfolio data feed, cryptocurrency sector categories, coin details scraper, crypto price monitoring, market cap rankings api, coinmarketcap data export, free crypto api no key, crypto trading bot data, coinmarketcap alternative scraper, bitcoin ethereum solana prices

### For AI Agents & LLM Apps

**Purpose:** Extract structured cryptocurrency market data from CoinMarketCap — price, market cap, volume, percent changes, supply, ATH/ATL, description, website, socials, and sector categories for ranked coins.

**Minimal working input:**

```json
{
  "limit": 10,
  "startRank": 1,
  "convert": "USD",
  "sortBy": "market_cap",
  "includeDetails": true,
  "useApifyProxy": true
}
```

**Variant — lightweight price feed (no details, faster):**

```json
{
  "limit": 200,
  "startRank": 1,
  "convert": "USD",
  "sortBy": "market_cap",
  "includeDetails": false,
  "useApifyProxy": true
}
```

**Output fields:** `rank`, `id`, `name`, `symbol`, `slug`, `url`, `price`, `marketCap`, `fullyDilutedMarketCap`, `volume24h`, `volumeChange24hPct`, `percentChange1h`, `percentChange24h`, `percentChange7d`, `percentChange30d`, `percentChange60d`, `percentChange90d`, `circulatingSupply`, `totalSupply`, `maxSupply`, `ath`, `atl`, `athDate`, `atlDate`, `high24h`, `low24h`, `high7d`, `low7d`, `high30d`, `low30d`, `description`, `website`, `whitepaper`, `explorers`, `sourceCode`, `socials`, `categories`, `allTags`, `dateAdded`, `dateLaunched`, `lastUpdated`, `watchCount`, `marketDominancePct`

**Behaviors an agent should know:**

- When `includeDetails` is `true`, the actor makes one additional HTTP request per coin — set `limit` accordingly to stay within budget
- `maxRequestsPerCrawl` (default 5000) is the hard safety cap — if you need more than ~2,000 coins with details, raise this value
- `sortBy` affects ranking order but `startRank` is always relative to the original market-cap rank — combine carefully
- Free Apify users are capped at 20 coins per run regardless of the `limit` value
- Detail endpoints may return some statistics in USD even when another currency is selected for listings

**Billing model:** Pay-per-event — $0.0015 per result coin + $0.00005 per actor start event.

### Legal & Compliance Disclaimer

This actor is independent and is not affiliated with, endorsed by, or sponsored by CoinMarketCap OpCo, LLC. It accesses only publicly available data API endpoints — the same ones that power the coinmarketcap.com website — with no login bypass, no CAPTCHA solving, and no authentication circumvention. Users are responsible for their own compliance with CoinMarketCap's Terms of Service and applicable data-protection laws (including GDPR and CCPA where relevant). The data returned contains no personal information — only publicly listed cryptocurrency market data.

# Actor input Schema

## `limit` (type: `integer`):

Maximum number of coins to scrape, ranked by market cap. Free users are capped at 20 coins per run.

## `startRank` (type: `integer`):

Market-cap rank to start from (1 = Bitcoin). Use e.g. 101 to scrape ranks 101+.

## `convert` (type: `string`):

Fiat/crypto currency for price, market cap and volume figures.

## `sortBy` (type: `string`):

Ranking criterion for the coin list.

## `includeDetails` (type: `boolean`):

Fetch each coin's detail page data: description, website, socials, tags and sector categories. Adds one request per coin.

## `useApifyProxy` (type: `boolean`):

Route all requests through the Apify proxy (recommended ON).

## `proxyGroups` (type: `array`):

Optional Apify proxy groups (e.g. a residential group for hard targets). Empty = AUTO group.

## `maxConcurrency` (type: `integer`):

How many requests run in parallel. Keep low (2-4) for politeness.

## `maxRequestsPerCrawl` (type: `integer`):

Hard safety cap on total HTTP requests for the whole run.

## Actor input object example

```json
{
  "limit": 100,
  "startRank": 1,
  "convert": "USD",
  "sortBy": "market_cap",
  "includeDetails": true,
  "useApifyProxy": true,
  "proxyGroups": [],
  "maxConcurrency": 4,
  "maxRequestsPerCrawl": 5000
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_jasarevic/coinmarketcap-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("ahmed_jasarevic/coinmarketcap-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 '{}' |
apify call ahmed_jasarevic/coinmarketcap-scraper --silent --output-dataset

```

## MCP server setup

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