# CoinPaprika Scraper — Crypto Prices & Market Data (`hipersoft/coinpaprika-scraper`) Actor

Fetch cryptocurrency market data from CoinPaprika in bulk: price, market cap, rank, 24h volume, 1h/24h/7d change, supply and all-time-high for thousands of coins. Look up specific coins, pull detailed coin profiles, or search by name/symbol. Fast, clean and cheap.

- **URL**: https://apify.com/hipersoft/coinpaprika-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** Other, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0005 / 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?

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

## CoinPaprika Scraper — Crypto Prices, Market Cap & Market Data

Get **cryptocurrency market data** from CoinPaprika as clean, structured **JSON, CSV, Excel or XML**: **price, market cap, rank, 24h volume, 1h/24h/7d price change, circulating/total/max supply and all-time-high** for thousands of coins. Pull the top coins by rank, look up a specific watchlist by coin id, open a detailed coin profile, or search for coins by name or symbol — all in one run.

### What does CoinPaprika Scraper do?

This CoinPaprika scraper turns crypto market data into a structured dataset. Ask for the top N coins, a specific list of coin ids, a detailed profile, or a search, and it returns one flat record per coin with price, market cap, volume, supply and all-time-high data points. Use it to power dashboards, portfolio trackers, alerts and research pipelines, and export the results in any format the Apify platform supports.

### What data can you get from CoinPaprika?

| Data point | Description |
| --- | --- |
| Coin id, symbol & name | CoinPaprika id, ticker symbol and display name. |
| Rank | Position by market capitalisation. |
| Price | Latest price in your chosen quote currency (USD or BTC). |
| Market cap | Market capitalisation. |
| 24h volume | Total traded volume over 24 hours. |
| Price change | 1h, 24h and 7d percentage change. |
| Supply | Circulating, total and max supply. |
| All-time high | ATH price, ATH date and percent from ATH. |
| Coin profile | Description, tags, team, links, whitepaper, proof type and more (coin mode). |
| Last updated | Timestamp when the values were last refreshed. |

### Use cases

- **Live dashboards** — power a price/market-cap dashboard or portfolio tracker.
- **Snapshots on a schedule** — capture the top 100–5,000 coins over time for analysis.
- **Watchlist monitoring** — track specific coins and their 1h/24h/7d movement.
- **Coin research** — pull detailed profiles with tags, team and links.
- **Dataset building** — feed structured crypto data into BI tools, models or apps.

### How to use CoinPaprika Scraper

1. Add **CoinPaprika Scraper** to your Apify account and open its input.
2. Pick a **mode**: `tickers` (market data), `coin` (detailed profile) or `search`.
3. For `tickers`, leave **coinIds** empty for the top coins by rank, or list ids like `btc-bitcoin`, `eth-ethereum`. For `search`, set a **query**.
4. Set **maxItems** and, for tickers, a **quote** currency (`USD` or `BTC`).
5. Click **Run**, then export the results as JSON, CSV, Excel or XML, or fetch them through the Apify API.

### Input

```json
{
  "mode": "tickers",
  "coinIds": ["btc-bitcoin", "eth-ethereum"],
  "quote": "USD",
  "maxItems": 100
}
```

| Field | Description |
| --- | --- |
| `mode` | `tickers` for market data, `coin` for a detailed profile, or `search` to find coins. |
| `coinIds` | CoinPaprika coin ids (e.g. `btc-bitcoin`). Empty in tickers mode = top coins by rank. |
| `query` | Name or symbol to search for (search mode). |
| `quote` | Quote currency for tickers mode: `USD` or `BTC`. |
| `maxItems` | Maximum number of coins (rows) to return. |

### What you get

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

```json
{
  "id": "btc-bitcoin",
  "name": "Bitcoin",
  "symbol": "BTC",
  "rank": 1,
  "priceUsd": 77121.98,
  "marketCapUsd": 1548516029198,
  "volume24hUsd": 24548667879.96,
  "percentChange1h": -0.32,
  "percentChange24h": -0.36,
  "percentChange7d": -1.58,
  "circulatingSupply": null,
  "totalSupply": 20078797,
  "maxSupply": 21000000,
  "athPrice": 126173.17,
  "athDate": "2025-10-06T19:00:40Z",
  "percentFromAth": -38.87,
  "lastUpdated": "2026-09-02T19:40:16Z",
  "quote": "USD"
}
```

#### Output schema (tickers mode)

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | CoinPaprika id for the coin. |
| `name` | string | Display name of the coin. |
| `symbol` | string | Ticker symbol. |
| `rank` | integer | Rank by market capitalisation. |
| `priceUsd` | number | Latest price in the chosen quote currency. |
| `marketCapUsd` | number | Market capitalisation. |
| `volume24hUsd` | number | Total traded volume over 24 hours. |
| `percentChange1h` | number | Percentage price change over 1 hour. |
| `percentChange24h` | number | Percentage price change over 24 hours. |
| `percentChange7d` | number | Percentage price change over 7 days. |
| `circulatingSupply` | number | Circulating supply (null when not reported). |
| `totalSupply` | number | Total supply. |
| `maxSupply` | number | Maximum supply (null when uncapped). |
| `athPrice` | number | All-time-high price. |
| `athDate` | string (ISO date) | Date of the all-time high. |
| `percentFromAth` | number | Percentage change from the all-time high. |
| `lastUpdated` | string (ISO date) | Timestamp when the values were last refreshed. |
| `quote` | string | The quote currency used. |

In `coin` mode each record is a detailed profile with `description`, `tags`, `team`, `website`, `sourceCode`, `whitepaper`, `proofType`, `hashAlgorithm` and more. In `search` mode each record is a match with `id`, `name`, `symbol`, `rank` and `type`.

### FAQ

**How do I get a specific coin?**
Set `mode` to `tickers` or `coin` and add its CoinPaprika id (like `btc-bitcoin`) to `coinIds`. Not sure of the id? Run `search` first with the coin's name or symbol.

**Which quote currencies are supported?**
`USD` and `BTC`, via the `quote` input in tickers mode.

**How many coins can I get per run?**
As many as you set with `maxItems`. In tickers mode without a coin list, the actor pulls the top coins by rank up to your limit.

**How fresh is the data?**
Prices, market cap and volume are pulled 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 use this with n8n?**
Yes. Run the actor from n8n with the [Apify node](https://n8n.io/integrations/apify/) (or an HTTP Request node against the [Apify API](https://docs.apify.com/api/v2)) to trigger a run and read the dataset. A common workflow is a scheduled n8n trigger that runs CoinPaprika Scraper, then routes the coins into a database, spreadsheet or alert.

**Can I connect this to my other tools?**
The CoinPaprika Scraper works with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations): [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 CoinPaprika data?**
The data reflects public CoinPaprika market data, but this actor is an independent tool and is not affiliated with or endorsed by CoinPaprika.

### Related Actors

- [CoinGecko Scraper](https://apify.com/hipersoft/coingecko-scraper) — top coins, watchlists and trending with price, market cap and ATH/ATL.
- [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.

### Notes

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

# Actor input Schema

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

What to fetch. "tickers" = market data rows (price, market cap, volume, change) for the top coins or the coins you list. "coin" = a detailed profile per coin id. "search" = look up coins by name or symbol.

## `coinIds` (type: `array`):

CoinPaprika coin ids to fetch, one per line (e.g. "btc-bitcoin", "eth-ethereum"). Used by "tickers" and "coin" modes. Leave empty in tickers mode to fetch the top coins by rank.

## `query` (type: `string`):

Name or symbol to search for (e.g. "bitcoin" or "sol"). Used only by "search" mode.

## `quote` (type: `string`):

Currency to price coins against for tickers mode. Supported values are USD and BTC.

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

Maximum number of coins (rows) to return. In tickers mode without coin ids, caps how many top coins are pulled from the full market snapshot.

## Actor input object example

```json
{
  "mode": "tickers",
  "coinIds": [
    "btc-bitcoin",
    "eth-ethereum"
  ],
  "quote": "USD",
  "maxItems": 100
}
```

# Actor output Schema

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

The results as dataset items.

# 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 = {
    "coinIds": [
        "btc-bitcoin",
        "eth-ethereum"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/coinpaprika-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 = { "coinIds": [
        "btc-bitcoin",
        "eth-ethereum",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/coinpaprika-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 '{
  "coinIds": [
    "btc-bitcoin",
    "eth-ethereum"
  ]
}' |
apify call hipersoft/coinpaprika-scraper --silent --output-dataset

```

## MCP server setup

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