CoinMarketCap Listings Scraper

Overview

CoinMarketCap Listings Scraper is a robust, reliable tool for collecting detailed cryptocurrency data. With 50+ data fields, advanced filters, and custom currency conversion, it’s fully tested and production-ready—perfect for portfolio tracking, market research, alpha discovery, and price monitoring. All output is normalized into clear Pydantic models for easy downstream processing.

Key Use Cases

• Cryptocurrency market analysis
• Portfolio tracking & rebalancing logic
• Market research & token due diligence
• Price monitoring & alerting systems
• Historical data snapshots / backtesting datasets

Features

Sorting Modes

Supported sorting input values (case-insensitive):

• Top (by rank)
• Trending (unified trending feed)
• Most_Visited (24h)
• New (recently added)
• Gainers (24h gainers/losers view)
• Fourmeme_X_Mode (experimental feed)

Trending Scopes

When sorting = Trending, you can specify trending_scope as one of: 24h, 4h, 1h.

Platform Filtering

Filter by on-chain platform using: All, Ethereum, Binance Smart Chain, Polygon, Solana, Base, Tron, Sui Network, Cronos.

Advanced Numeric Filters

Each accepts optional from / to range (both ends optional). If one side is omitted the other is open-ended.

• Market cap: market_cap_from, market_cap_to
• 24h price change (%): price_change_24h_from, price_change_24h_to
• 24h volume: volume_24h_from, volume_24h_to
• Age (token existence): age_from, age_to with age_unit (hours, days, weeks, months, years)

Pagination & Ordering

• max_records total desired items (default 1000)
• offset starting index
• ascending boolean to invert order (default descending)

Multi-Currency Output

All prices converted simultaneously into: USD, BTC, ETH, EUR, CHF, JPY, GBP. Select a primary reporting unit via unit input (affects aggregations & normalized stats).

Input Parameters

All inputs are optional; run with defaults to fetch top ranked listings quickly.

Parameter	Type	Description
platform	string	Platform filter or All
sorting	string	One of supported sorting modes
ascending	bool	Sort direction (default false = descending)
max_records	int	Target number of records (positive)
offset	int	Starting index (0-based)
unit	string	Primary currency, must be in supported units
trending_scope	string|None	Scope for trending feed (24h,4h,1h)
market_cap_from / market_cap_to	float|None	Market cap range boundaries
price_change_24h_from / price_change_24h_to	float|None	24h percentage change range
volume_24h_from / volume_24h_to	float|None	24h volume range
age_from / age_to	float|None	Age boundaries (in age_unit)
age_unit	string|None	One of: hours, days, weeks, months, years

Invalid combinations produce clear validation errors early (e.g. missing age_unit when age filters supplied, unsupported currency, negative offsets, etc.).

Output Schema

The scraper emits a list of typed objects (RecordListing or RecordDex). Below is a summary of principal fields for RecordListing:

Category	Fields
Identity	id, type, name, symbol, platform, tags, badges
Ranking	cmcRank, marketPairCount, isActive
Timestamps	lastUpdated, dateAdded
Prices	priceUSD, priceBTC, priceETH, priceEUR, priceCHF, priceJPY, priceGBP
Trading Stats	tradingStatsUnit, tradingStatsVolume24h, tradingStatsVolume7d, tradingStatsVolume30d, tradingStatsVolumeToMarketCap24h, tradingStatsAth, tradingStatsAtl, tradingStatsHigh24h, tradingStatsLow24h, tradingStatsFromAthPercentage, tradingStatsFromAtlPercentage
Price Change %	priceChangePercentageUnit, priceChangePercentage1h, priceChangePercentage24h, priceChangePercentage7d, priceChangePercentage30d, priceChangePercentage60d, priceChangePercentage90d, priceChangePercentage1y, priceChangePercentageYtd
Supply	supplyUnit, supplyCirculating, supplyTotal, supplyMax
Market Cap	marketCapUnit, marketCap, marketCapSelfReported, marketCapFullyDiluted
Audit	audit, auditCount, auditLatestAuditor, auditLatestStatus, auditLatestDate, auditLatestReportUrl, auditLatestScore, auditLatestContractAddress, auditLatestContractPlatform

DEX entries include a concise subset: identity, pricing, volume, and short-term price change metrics.

Quick Start (Apify Console)

1. Open the Actor (CoinMarketCap Listings Scraper) in Apify Console.
2. (Optional) Adjust filters (e.g. set sorting = Trending, trending_scope = 4h).
3. Click Run.
4. Download results from the Dataset tab as JSON, CSV, or Excel; or via API.

Data Quality & Reliability

• Early validation of input types and enumerations.
• Consistent field naming via Pydantic models.
• Unit tests cover harmonization logic.

Output Formats

Download from Apify Dataset as: JSON (.json), CSV (.csv), Excel (.xlsx), or via API streaming.

## Example output

{
  "type": "listing",
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "platform": null,
  "tags": [],
  "cmcRank": 1,
  "marketPairCount": 12464,
  "isActive": true,
  "lastUpdated": "2025-11-03 18:12:00+00:00",
  "dateAdded": "2010-07-13 00:00:00+00:00",
  "badges": [
    1,
    5
  ],
  "priceUSD": 107414.30716307356,
  "priceBTC": 1.0,
  "priceETH": 29.338375225033026,
  "priceEUR": 93172.45900493607,
  "priceCHF": 86730.82300436671,
  "priceJPY": 16559929.467442527,
  "priceGBP": 81710.92277340706,
  "tradingStatsUnit": "USD",
  "tradingStatsVolume24h": 64945951002.983444,
  "tradingStatsVolume7d": 418730653654.3886,
  "tradingStatsVolume30d": 1055012004577.2347,
  "tradingStatsVolumeToMarketCap24h": 0.03031644,
  "tradingStatsAth": 126198.06960343386,
  "tradingStatsAtl": 0.04864654,
  "tradingStatsHigh24h": 110764.91654552388,
  "tradingStatsLow24h": 105336.35719851001,
  "tradingStatsFromAthPercentage": 85.11564994663819,
  "tradingStatsFromAtlPercentage": 220805646.53328598,
  "priceChangePercentageUnit": "USD",
  "priceChangePercentage1h": 0.53128784,
  "priceChangePercentage24h": -2.55095108,
  "priceChangePercentage7d": -7.20900104,
  "priceChangePercentage30d": -11.81906194,
  "priceChangePercentage60d": -2.48381917,
  "priceChangePercentage90d": -5.40767843,
  "priceChangePercentage1y": 57.15724427,
  "priceChangePercentageYtd": 13.7625,
  "supplyUnit": "USD",
  "supplyCirculating": 19943978.0,
  "supplyTotal": 19943978.0,
  "supplyMax": 21000000.0,
  "marketCapUnit": "USD",
  "marketCap": 2142268578945.5815,
  "marketCapSelfReported": 0.0,
  "marketCapFullyDiluted": null,
  "audit": false,
  "auditCount": 0,
  "auditLatestAuditor": null,
  "auditLatestStatus": null,
  "auditLatestDate": null,
  "auditLatestReportUrl": null,
  "auditLatestScore": null,
  "auditLatestContractAddress": null,
  "auditLatestContractPlatform": null
}

Legal & Compliance

This Actor accesses publicly available market data. Do not use it to collect personal data. Always review and respect CoinMarketCap Terms of Service. For general guidance see: Is web scraping legal?.