# CoinLore Crypto Scraper (`parseforge/coinlore-crypto-scraper`) Actor

Scrapes cryptocurrency data from CoinLore including coin rankings, individual coin details, and exchange market listings. Returns each item as a flat row.

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

## Pricing

from $6.00 / 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)

### CoinLore Crypto Scraper

**Scrape cryptocurrency prices, market caps, and exchange listings from CoinLore, up to a million coins per run.** Get top rankings, single coin details, or every market a coin trades on. Export to CSV, JSON, Excel, or XML.

Crypto data APIs often gate real-time market data behind paid tiers or complex authentication. This Actor reads CoinLore's public feeds directly, collecting coin rankings by market cap, detailed metrics for a single coin, or the full list of exchanges trading a specific symbol. You get a clean, flat dataset without managing API keys or rate limits.

| Who uses it | What they scrape CoinLore for |
|---|---|
| Crypto traders | Monitor top coin rankings and price movements to inform daily trading decisions. |
| Financial analysts | Pull historical snapshots of market caps and volumes for sector reports. |
| Blockchain developers | Fetch a coin's listed exchange markets to track liquidity and trading pairs. |
| Data journalists | Collect crypto market data to support stories on market trends and volatility. |

### What it does

This Actor collects cryptocurrency data from CoinLore, returning coin rankings, individual coin details, or exchange market listings as flat rows.

- 📈 **Ranking mode:** Collect the top coins by market cap, from Bitcoin down to the smallest tokens, with a configurable limit.
- 🪙 **Coin mode:** Look up a single coin by symbol or CoinLore ID to get its price, supply, all-time high, and social links.
- 🏦 **Markets mode:** Retrieve every exchange and trading pair where a specific coin is actively traded, including volume and price per market.

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

### What you can do with CoinLore data

**📊 Build a market watchlist.**

A trader runs the Ranking mode daily to capture the top 100 coins by market cap, tracking price and volume changes for their watchlist.

**🔍 Audit a single asset.**

An analyst uses Coin mode with the symbol 'ETH' to pull Ethereum's current price, percent change, circulating supply, and all-time high for a client brief.

**🏦 Map exchange liquidity.**

A developer runs Markets mode for a new token to see every exchange listing it, the trading pairs, and the 24-hour volume on each platform.

**📉 Track sector-wide trends.**

A researcher collects the full ranking of thousands of coins to analyze aggregate market cap shifts and identify which sectors are gaining momentum.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key required** | Reads public CoinLore data directly with no registration or authentication. |
| **Three collection modes** | Switch between global rankings, single coin details, and per-coin exchange markets. |
| **Flexible coin lookup** | Identify coins by their trading symbol or their numeric CoinLore ID. |
| **Scalable collection** | Set a maximum from 1 to 1,000,000 items to fit your research scope. |

### How it compares

This Actor offers multiple collection modes for rankings, coin details, and exchange markets, while the other CoinLore scraper focuses specifically on market data exports.

| Feature | ParseForge | CoinLore Market Scraper - Crypto Prices and Supply |
|---|---|---|
| Top coin rankings by market cap | Yes | Not listed |
| Single coin detail lookup | Yes | Not listed |
| Exchange markets per coin | Yes | Not listed |
| Lookup by coin symbol or ID | Yes | Not listed |
| Market data export with rank and price | Yes | Yes |

### Configure the run

Drive the Actor by selecting a mode and specifying a coin symbol or ID for targeted lookups, with a maximum item limit to control dataset size. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "mode": "ranking",
  "maxItems": 10
}
```

A larger pull:

```json
{
  "mode": "ranking",
  "maxItems": 200
}
```

### Pricing

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

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.65 |
| 1,000 results | $6.50 |
| 10,000 results | $65.00 |

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 [CoinLore Crypto Scraper](https://apify.com/parseforge/coinlore-crypto-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 CoinLore 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/coinlore-crypto-scraper"
```

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

### Troubleshooting

**Why am I getting no results for a coin symbol?**

The symbol may not be listed on CoinLore, or it could be a very new or delisted coin. Try using the coin's numeric CoinLore ID instead, which you can find by searching for the coin on the CoinLore website.

**The Actor returns fewer items than my maximum setting.**

This is expected. The Actor stops when it has collected all available items from CoinLore. If you set a maximum of 10,000 but CoinLore only lists 5,000 coins, the run will finish after collecting those 5,000.

**I get an error when using Markets mode.**

Ensure you have provided either a valid coin symbol or a CoinLore ID in the input. Markets mode requires a specific coin to look up its exchange listings.

**The data seems slightly delayed.**

CoinLore updates its data at regular intervals. The Actor captures the data as it is presented on the site at the moment of the request, which may have a short delay from real-time trading.

### FAQ

| Question | Answer |
|---|---|
| What is the difference between Coin mode and Markets mode? | Coin mode returns the core metrics for one coin, like its price, rank, and supply. Markets mode returns the list of exchanges where that coin is traded, including the price and volume on each exchange. |
| How do I find a coin's CoinLore ID? | You can find a coin's numeric ID in its CoinLore URL, for example, coinlore.com/coin/90 for Bitcoin. You can also use the coin's symbol directly in the input, and the Actor will resolve it. |
| Can I scrape all coins on CoinLore? | Yes, set the mode to Ranking and the maximum coins to a high number like 1,000,000. The Actor will collect data for every coin listed, starting from rank 1. |
| Does this Actor provide historical data? | No, this Actor collects the current state of the data as it appears on CoinLore at the time of the run. For historical data, you would need to run it on a schedule and store the snapshots yourself. |
| What data fields are returned for a coin? | The output includes the coin's name, symbol, rank, price in USD, percent change over various periods, market cap, volume, circulating supply, total supply, and all-time high. |
| Is an API key required to use this Actor? | No, this Actor scrapes the public web interface of CoinLore and does not require any API key, login, or registration. |
| Can I look up a coin by its name instead of its symbol? | The input accepts a coin symbol or a numeric CoinLore ID. If you only have the name, you can run the Ranking mode first to find the correct symbol, then use it in a subsequent run. |
| What format is the exported data in? | You can export your dataset in JSON, CSV, Excel, XML, or other formats supported by the Apify platform. |
| How often can I run this Actor? | You can run it as often as you like. For time-series data, you can schedule it to run every hour or day using Apify's built-in scheduler. |

### 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 CoinLore. 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

## `mode` (type: `string`):

Select what data to collect

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

How many coins to collect per run.

## `coinSymbol` (type: `string`):

Coin symbol to look up (e.g. BTC, ETH, SOL). Used in Coin and Markets modes.

## `coinId` (type: `string`):

CoinLore coin ID (e.g. 90 for Bitcoin). Alternative to symbol lookup.

## Actor input object example

```json
{
  "mode": "ranking",
  "maxItems": 10
}
```

# Actor output Schema

## `overview` (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 = {
    "mode": "ranking",
    "maxItems": 10
};

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

# Prepare the Actor input
run_input = {
    "mode": "ranking",
    "maxItems": 10,
}

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

```

## MCP server setup

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