CoinPaprika Crypto Extractor: live cryptocurrency market data scraper

Extract live price, market cap, trading volume, supply metrics, and all-time high records from CoinPaprika for any listed cryptocurrency. Input a list of coin IDs, and the actor returns one structured JSON record per coin, ready for spreadsheets, dashboards, databases, or data pipelines.

CoinPaprika tracks over 10,000 cryptocurrencies with market data refreshed every 60 seconds. This actor gives you programmatic access to that data at scale: process up to 1,000 coins per run with no manual steps.

---

What data does this actor extract?

Each record contains 23 fields organized into five groups:

Identification

Field	Type	Description
coinId	string	CoinPaprika coin identifier (e.g., btc-bitcoin)
name	string	Full coin name (e.g., Bitcoin)
symbol	string	Ticker symbol (e.g., BTC)
rank	integer	Market cap rank, where 1 is the largest

Price and volume

Field	Type	Description
priceUsd	number	Current price in USD
volume24hUsd	number	24-hour trading volume in USD
volume24hChange	number	24-hour change in trading volume (%)

Market capitalization

Field	Type	Description
marketCapUsd	number	Market cap in USD (price x circulating supply)
marketCapChange24h	number	24-hour market cap change (%)

Price performance

Field	Type	Description
percentChange1h	number	Price change over the last 1 hour (%)
percentChange24h	number	Price change over the last 24 hours (%)
percentChange7d	number	Price change over the last 7 days (%)

All-time high

Field	Type	Description
athPrice	number	All-time high price in USD
athDate	string	Date the ATH was reached (ISO 8601)
percentFromAth	number	How far below ATH the current price is (negative %)

Supply

Field	Type	Description
totalSupply	number	Total coins in existence
maxSupply	number	Hard cap on supply; null if uncapped

Metadata

Field	Type	Description
coinPageUrl	string	Link to the coin's CoinPaprika page
lastUpdated	string	When CoinPaprika last updated the data
scrapedAt	string	When this actor ran
error	string	Error message if the coin failed; null if successful

---

Use cases

• Portfolio tracking: pull fresh data for every coin you hold and push it to Google Sheets or a database on a schedule
• Price alerting: compare percentChange24h against thresholds to trigger Slack or email notifications
• Market research: batch-collect metrics for the top 100, top 500, or any custom coin list in one run
• ATH analysis: find which coins are closest to or furthest from their all-time highs
• Data journalism: build time-series snapshots of crypto market metrics for charts and reporting
• App data feeds: supply a live crypto dashboard with structured JSON without writing API client code
• Academic research: collect historical price snapshots across hundreds of assets for quantitative analysis

---

How to find a coin ID

Coin IDs follow the format symbol-name. Some common examples:

Coin	ID
Bitcoin	btc-bitcoin
Ethereum	eth-ethereum
Solana	sol-solana
Dogecoin	doge-dogecoin
Cardano	ada-cardano
BNB	bnb-binance-coin
XRP	xrp-xrp
Avalanche	avax-avalanche
Polkadot	dot-polkadot
Chainlink	link-chainlink

The fastest way to find any coin's ID: open its page on CoinPaprika. The segment after /coin/ in the URL is the ID. For example, coinpaprika.com/coin/btc-bitcoin/ gives you the ID btc-bitcoin.

---

Input

Parameter	Type	Required	Default	Description
coinIds	array	Yes		List of coin IDs to extract, one per line
maxItems	integer	No	100	Maximum number of coins to process (up to 1,000)
requestTimeoutSecs	integer	No	30	Per-request timeout in seconds

Example input

{
    "coinIds": [
        "btc-bitcoin",
        "eth-ethereum",
        "sol-solana",
        "doge-dogecoin",
        "ada-cardano",
        "bnb-binance-coin",
        "xrp-xrp"
    ],
    "maxItems": 100,
    "requestTimeoutSecs": 30
}

---

Output

The actor stores one record per coin in an Apify dataset. Records are available for download as JSON, CSV, XML, Excel, or HTML.

Example output record

{
    "coinId": "btc-bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "rank": 1,
    "totalSupply": 19500000,
    "maxSupply": 21000000,
    "priceUsd": 67234.56,
    "volume24hUsd": 28450000000,
    "volume24hChange": -3.21,
    "marketCapUsd": 1310000000000,
    "marketCapChange24h": 1.45,
    "percentChange1h": 0.22,
    "percentChange24h": 1.65,
    "percentChange7d": 5.4,
    "athPrice": 68789.63,
    "athDate": "2021-11-10T17:41:00Z",
    "percentFromAth": -2.25,
    "coinPageUrl": "https://coinpaprika.com/coin/btc-bitcoin/",
    "lastUpdated": "2024-10-28T22:59:00Z",
    "scrapedAt": "2024-10-28T23:00:00Z",
    "error": null
}

If a coin fails (wrong ID, network error, etc.), the row contains only coinId, error, and scrapedAt. The actor continues processing the rest of the list.

---

How it works

1. You provide a list of coin IDs in the coinIds field
2. The actor fetches live market data for each coin through built-in bypass infrastructure
3. Each response is validated and mapped to a flat 23-field record
4. Records are pushed to the Apify dataset as they complete
5. Failed coins are captured with an error field so the run never stops mid-list

---

Running on a schedule

Open the actor in Apify Console, go to Schedules, and create a new schedule. Useful intervals:

• Hourly: fresh market data for a watchlist
• Daily: daily portfolio snapshot with market context
• Every 5 minutes: high-frequency price monitoring for active traders

---

Exporting results

From the dataset view in Apify Console, click Export and pick your format:

Format	Use case
JSON	APIs, databases, Python/JavaScript scripts
CSV	Excel, Google Sheets, pandas
XML	Legacy integrations
Excel (.xlsx)	Direct spreadsheet analysis

---

FAQ

How do I get a list of all available coin IDs? Browse CoinPaprika at coinpaprika.com. Each coin's page URL contains the ID. For a full programmatic list, you can also visit coinpaprika.com/api/ for their public API documentation, which lists all coins in JSON format.

Can I process hundreds of coins at once? Yes. Add all IDs to coinIds and set maxItems to your target count (up to 1,000 per run). For larger lists, split into multiple runs.

How often does CoinPaprika update prices? Market data is updated approximately every 60 seconds. For most use cases, running the actor every few minutes or hourly is sufficient.

What happens if a coin ID is wrong? The actor logs the error for that coin, continues with the rest, and writes an error message to the dataset row under the error field. You can filter error rows by checking error !== null.

Does this work for all coins on CoinPaprika? It works for any coin with a CoinPaprika listing, which covers thousands of cryptocurrencies across all market cap tiers, including small-cap and newly listed assets.

Can I filter only coins above a certain market cap? Not as an input filter, but you can filter the output dataset in Apify Console or post-process the JSON/CSV using standard tools (Excel, pandas, Google Sheets filter views).

What is the percentFromAth field? It shows how far below the all-time high the current price is, expressed as a percentage. A value of -50 means the coin is trading at half its ATH price. A value close to 0 means the coin is near its ATH.

---

Integrations

Connect CoinPaprika Crypto Extractor with other apps using Apify integrations. Available integrations include Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. You can also use webhooks to trigger downstream actions as soon as new results arrive in the dataset.