Crypto Prices API - CoinMarketCap Market Cap, Listings, OHLCV

Export live cryptocurrency prices, market cap rankings, global market metrics and historical OHLCV from the CoinMarketCap API into an Apify dataset, free with no key or with your own CoinMarketCap API key.

Works with the CoinMarketCap API. The actor turns a mode and a few filters into clean, deduplicated rows you can download as JSON, CSV or Excel, schedule every few minutes, or feed into trading dashboards, portfolio trackers, spreadsheets, notebooks and data warehouses.

What it does

• Cryptocurrency listings (free): every active cryptocurrency ranked by market cap, volume, price, percent change, supply or date added, with latest price, market cap, fully diluted market cap, 24h, 7d and 30d volume, 1h to 90d percent changes, circulating, total and max supply, CMC rank, tags and platform. Filter by price, market cap, 24h volume and 24h percent change ranges, by coins or tokens, and by the DeFi or file sharing tag.
• Latest quotes (free): the same market data for the coins you name, by symbol, slug or CoinMarketCap ID, priced in USD, EUR, BTC or any other convert currency.
• Cryptocurrency ID map (free): CoinMarketCap ID, symbol, slug, rank, first and last historical data dates and token platform for every active, inactive or untracked cryptocurrency.
• Metadata (free): logo, description, category, website, explorer, whitepaper and social links, tags, date added and contract addresses per coin, also looked up by contract address.
• Global market metrics (free): total crypto market cap and volume, BTC and ETH dominance, altcoin, DeFi, stablecoin and derivatives volume and market cap, active cryptocurrencies, exchanges and market pairs.
• Exchange ID map (free): CoinMarketCap exchange IDs and slugs, filterable to exchanges that list a given coin.
• Exchange listings (API key): centralized and decentralized exchanges ranked by 24h volume or adjusted volume, by category (spot, derivatives, DEX, lending).
• Historical OHLCV (API key, Startup plan or higher): daily or hourly open, high, low, close, volume and market cap candles, sampled daily, weekly, monthly or every few hours or days.
• Pay only for keyed results: rows from the free Keyless Public API are never charged, and a request the provider has nothing for becomes a free row that says why.

Free keyless mode or your own API key

Without a key, the actor reads the CoinMarketCap Keyless Public API, which serves listings, latest quotes, both ID maps, metadata and global metrics with no sign-up. Keyless calls share a small anonymous rate pool per IP address, take one convert currency, and are paced at 6 requests per minute. These rows are not charged.

With a key, every mode is open as far as your plan reaches, the rate limits are your own, and you can price in up to 120 currencies at once. Get a key at pro.coinmarketcap.com: a free Basic key needs no credit card; historical OHLCV needs the Startup plan or higher, and the plan page lists which endpoints each tier includes. Paste the key into the API key field or set the DATA_API_KEY environment secret. The key is sent only in the X-CMC_PRO_API_KEY header and never logged. A key-only mode run without a key ends cleanly with a message before any request is sent.

Input

Field	Used by	What it does
mode	all	listingsLatest (default), quotesLatest, cryptoMap, cryptoInfo, globalMetrics, exchangeListings, exchangeMap or ohlcvHistorical
coins	quotes, metadata, OHLCV	BTC, ETH, or slugs, or CoinMarketCap IDs; up to 1,000
coinIdType	quotes, metadata, OHLCV	symbol (default), slug or id
contractAddress	metadata	One token contract address
convert	listings, quotes, global metrics, exchange listings, OHLCV	USD (default), or USD,EUR,BTC with a key
sort, sortDir	listings (and sort direction for exchange listings)	market_cap (default), volume_24h, percent_change_24h and the other documented sorts
cryptocurrencyType	listings	all, coins or tokens
tag	listings	all, defi or filesharing
priceMin ... percentChange24hMax	listings	Price, market cap, 24h volume and 24h percent change ranges
listingStatus	ID maps	active, inactive or untracked
cryptoMapSort	cryptocurrency ID map	cmc_rank or id
exchangeSort, exchangeCategory	exchange listings	volume_24h, volume_24h_adjusted, name; spot, derivatives, dex, lending
exchangeMapSort, exchangeSlugs, cryptoId	exchange ID map	Sort, slugs such as binance, or exchanges listing a coin ID
timePeriod, interval	OHLCV	daily or hourly; sampling from 1h to 365d
timeStart, timeEnd, count	OHLCV	Window (start exclusive, end inclusive) or a number of periods back
maxResults	all	Row cap for the whole run (default 100)
requestsPerMinute	all	Optional pacing
apiKey	all	Optional. Your CoinMarketCap API key, stored as a secret

Example output

A listings row (listingsLatest, keyless). Every field CoinMarketCap returns is kept; the common columns are filled from the first convert currency.

{
  "mode": "listingsLatest",
  "modeLabel": "Cryptocurrency listings",
  "recordType": "listing",
  "identifier": "by market_cap desc",
  "found": true,
  "access": "keyless",
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "rank": 1,
  "currency": "USD",
  "price": 82979.56,
  "marketCap": 1667580814461.26,
  "volume24h": 13135852650.91,
  "percentChange24h": 0.68,
  "open": null,
  "high": null,
  "low": null,
  "close": null,
  "date": "2026-10-10T20:57:00.000Z",
  "retrievedAt": "2026-10-10T20:57:31.402Z",
  "note": null,
  "tags": ["mineable", "pow", "sha-256"],
  "infinite_supply": false,
  "circulating_supply": 20096284,
  "total_supply": 20096284,
  "max_supply": 21000000,
  "date_added": "2010-07-13T00:00:00.000Z",
  "num_market_pairs": 12759,
  "cmc_rank": 1,
  "last_updated": "2026-10-10T20:57:00.000Z",
  "platform": null,
  "quote": [
    {
      "id": 2781,
      "symbol": "USD",
      "price": 82979.56,
      "volume_24h": 13135852650.91,
      "volume_change_24h": -46.25,
      "cex_volume_24h": 13119408239.29,
      "dex_volume_24h": 16444411.62,
      "percent_change_1h": -0.03,
      "percent_change_24h": 0.68,
      "percent_change_7d": -2.08,
      "percent_change_30d": 7.41,
      "percent_change_60d": 30.32,
      "percent_change_90d": 29.34,
      "market_cap": 1667580814461.26,
      "market_cap_dominance": 59.42,
      "fully_diluted_market_cap": 1742570770978.68,
      "last_updated": "2026-10-10T20:57:00.000Z"
    }
  ]
}

An OHLCV row (ohlcvHistorical) carries time_open, time_close, time_high, time_low and the quote map, with open, high, low, close, volume24h (the candle volume) and marketCap filled from the first currency and date set to the candle open time.

FAQ

Do I need a CoinMarketCap API key?

No, not for listings, latest quotes, the cryptocurrency and exchange ID maps, metadata or global metrics: the actor reads the CoinMarketCap Keyless Public API and those rows are free. Exchange listings and historical OHLCV need your own key, and OHLCV needs the Startup plan or higher.

How do I get the top 100 cryptocurrencies by market cap?

Run the default listingsLatest mode with an empty input. It returns the top 100 by CoinMarketCap market cap rank with price, market cap, volume and percent changes in USD. Raise maxResults for more (up to 5,000 per page, paged automatically).

How do I get prices for specific coins?

Use quotesLatest with coins set to symbols such as BTC and ETH. A symbol returns every coin that uses it (many tokens reuse BTC or ETH), so set coinIdType to slug (bitcoin) or id (1) to get exactly one coin each. The ID map mode lists every slug and ID.

Can I get historical crypto prices and candles?

Yes, with ohlcvHistorical and a CoinMarketCap key on the Startup plan or higher. Pick daily or hourly candles and a window, or a count of periods back. The plan sets how far back intraday data goes (1 month on Startup, 3 on Growth, 12 on Professional); daily data goes back to 2010.

Why did my keyless run stop with a rate limit message?

The keyless API shares a small anonymous limit per IP address, and the actor already paces keyless runs at 6 requests per minute and retries. If the limit is still used up, the run ends cleanly with no charge. Add a free CoinMarketCap API key for your own limit.

What does a run cost?

Keyless rows are free. With your key, each returned record is one crypto-record event at 0.005 USD, platform usage included. Requests that return nothing are never charged, and your CoinMarketCap plan credits are used by your key as usual.

Can I convert prices to EUR, GBP or BTC?

Yes. Set convert to a fiat or crypto symbol. Keyless runs take one currency; keyed runs take up to 120 (3 for OHLCV), and each extra currency uses an extra CoinMarketCap credit. Every currency stays in the quote field; the first fills the price columns.

Keyword map

crypto prices API, CoinMarketCap API, cryptocurrency market cap, top 100 crypto, crypto listings, bitcoin price, ethereum price, crypto quotes, coin metadata, BTC dominance, global crypto market cap, crypto exchange rankings, exchange volume, historical OHLCV, crypto candles, CoinMarketCap ID map.

Licensing note

The data belongs to CoinMarketCap and is governed by its API terms and your plan's agreement. CoinMarketCap's commercial terms allow storing and caching data to run your own product but restrict redistributing or reselling the data itself, and its terms ask for attribution to CoinMarketCap. Use the rows within your own plan's licence, do not republish them as a standalone data feed, and credit CoinMarketCap where you display them. Keyless rows are passed through without charge for the same reason. This actor is an independent tool and is not affiliated with or endorsed by CoinMarketCap.