Crypto Price API - CoinDesk Data OHLCV, CADLI Index and News

Export crypto prices, OHLCV candles, CoinDesk index values, asset metadata and crypto news from the CoinDesk Data API into an Apify dataset, with your own API key.

Works with the CoinDesk Data API (formerly CCData and CryptoCompare). The actor turns a list of exchange instruments, index instruments or assets into clean, deduplicated rows you can download as JSON, CSV or Excel, schedule on a timer, or feed into research notebooks, dashboards, spreadsheets and data warehouses.

What it does

• Spot latest tick: the live price of an instrument on one of about 180 exchanges (coinbase, binance, kraken, bitstamp, okex, bybit and more), with best bid and ask and their sizes, the last trade, and current and rolling hour, day, week, month and year OHLC, volumes, buy and sell split and trade counts. Up to 50 instruments a request.
• Spot OHLCV candles: daily, hourly or minute candles per exchange instrument, with open, high, low, close, base and quote volume, buy and sell volume and trade counts. Aggregate 1 to 30 points per candle for 5-minute, 4-hour or weekly bars. The run pages back through the whole history on its own.
• Index latest value: the latest CoinDesk index value, such as CADLI (CoinDesk Adaptive Diversified Liquidity Index) for BTC-USD or ETH-USD, with rolling statistics.
• Index OHLC history: daily, hourly or minute index candles with volume, top-tier volume and update counts.
• Asset metadata: price, supply (max, circulating, total, burnt, staked), circulating and total market cap, rolling volumes and changes, ranks, description, website, white paper, explorers, supported platforms and contract addresses, industries and consensus mechanism, per asset symbol.
• Asset top list: assets ranked by market cap, volume, price or change, filtered by asset type (blockchain, token and more) and industry (stablecoin, DeFi, meme, AI, real world assets and more).
• News articles: the latest crypto news from CoinDesk and dozens of other publishers, with title, subtitle, link, source, authors, keywords, categories and sentiment, filtered by language, source and category.
• News sources: every publisher the news feed covers, with its key for the news source filter.
• Pay only for results: a request the provider has nothing for (an unknown instrument, asset or source) becomes a free row that names it and says why.

How to get an API key

Every CoinDesk Data API route needs a key, including the free tier. Sign up at developers.coindesk.com, open the API keys page in your account settings and create a key. The free key covers the routes and history its plan includes; paid plans raise the call limits and unlock more history and index families. Paste the key into the API key field, or set it as the DATA_API_KEY environment secret. A run without a key ends cleanly with a message before any request is sent, and nothing is charged.

Input

Field	Used by	What it does
mode	all	spotLatestTick (default), spotHistory, indexLatestTick, indexHistory, assetMetadata, assetTopList, newsArticles or newsSources
market	spot modes	Exchange, such as coinbase (default), binance, kraken
indexMarket	index modes	Index family, such as cadli (default) or ccix
instruments	spot and index modes	BTC-USD, ETH-USD, SOL-USDT; case sensitive
timeframe	candle modes	days (default), hours or minutes
aggregate	candle modes	Points per candle, 1 to 30
fill	candle modes	Return candles for periods with no trading (default on)
startTime, endTime	candle and news modes	YYYY-MM-DD, a UTC time, or Unix seconds; both ends inclusive
assets	asset metadata	BTC, ETH, SOL, or CoinDesk asset IDs
assetLookupPriority	asset metadata	Match entries as symbol (default), ID or URI
quoteAsset	asset modes	Conversion asset, USD by default
assetLanguage	asset metadata	Language for descriptions, en-US by default
sortBy, sortDirection	asset top list	Ranking field and direction
assetType, assetIndustry	asset top list	Filters
newsLanguage	news modes	EN (default), ES, TR, FR, JP, PT
newsSources, newsCategories, newsExcludeCategories	news articles	Source keys and categories
includeArticleBody	news articles	Add the full article text (off by default)
sourceType, sourceStatus	news sources	RSS, API or Twitter; active, inactive or both
maxResults	all	Row cap for the whole run (default 100)
requestsPerMinute	all	Pacing (default 120)
apiKey	all	Your CoinDesk Data API key, stored as a secret

Example output

A daily spot candle (spotHistory, coinbase, BTC-USD). The upper case columns are the provider's own fields, passed through unchanged; the lower case columns are the common ones this actor fills.

{
  "mode": "spotHistory",
  "modeLabel": "Spot OHLCV candles",
  "recordType": "spotCandle",
  "identifier": "coinbase BTC-USD days",
  "found": true,
  "id": "coinbase|BTC-USD|DAY|1791504000",
  "market": "coinbase",
  "instrument": "BTC-USD",
  "timeframe": "days",
  "symbol": null,
  "name": null,
  "date": "2026-10-09T00:00:00.000Z",
  "timestamp": 1791504000,
  "open": 81692.79,
  "high": 83452.99,
  "low": 81534.02,
  "close": 82544.71,
  "value": 82544.71,
  "volume": 4468.95567151,
  "quoteVolume": 368912373.945589,
  "title": null,
  "url": null,
  "retrievedAt": "2026-10-11T09:00:00.000Z",
  "note": null,
  "UNIT": "DAY",
  "TIMESTAMP": 1791504000,
  "TYPE": "954",
  "MARKET": "coinbase",
  "INSTRUMENT": "BTC-USD",
  "MAPPED_INSTRUMENT": "BTC-USD",
  "BASE": "BTC",
  "QUOTE": "USD",
  "BASE_ID": 1,
  "QUOTE_ID": 5,
  "TRANSFORM_FUNCTION": "",
  "OPEN": 81692.79,
  "HIGH": 83452.99,
  "LOW": 81534.02,
  "CLOSE": 82544.71,
  "FIRST_TRADE_TIMESTAMP": 1791504000,
  "LAST_TRADE_TIMESTAMP": 1791590399,
  "FIRST_TRADE_PRICE": 81692.79,
  "HIGH_TRADE_PRICE": 83452.99,
  "HIGH_TRADE_TIMESTAMP": 1791546420,
  "LOW_TRADE_PRICE": 81534.02,
  "LOW_TRADE_TIMESTAMP": 1791508885,
  "LAST_TRADE_PRICE": 82544.71,
  "TOTAL_TRADES": 396556,
  "TOTAL_TRADES_BUY": 144537,
  "TOTAL_TRADES_SELL": 252019,
  "TOTAL_TRADES_UNKNOWN": 0,
  "VOLUME": 4468.95567151,
  "QUOTE_VOLUME": 368912373.945589,
  "VOLUME_BUY": 1980.81074513,
  "QUOTE_VOLUME_BUY": 163525531.761511,
  "VOLUME_SELL": 2488.14492638,
  "QUOTE_VOLUME_SELL": 205386842.18406,
  "VOLUME_UNKNOWN": 0,
  "QUOTE_VOLUME_UNKNOWN": 0
}

Other modes keep the same common columns. A news article row fills title, url, name (the publisher) and date, and carries SUBTITLE, AUTHORS, KEYWORDS, SENTIMENT, SOURCE_DATA and CATEGORY_DATA. An asset row fills symbol, name, value (USD price) and volume (24 hour USD volume), and carries SUPPLY_CIRCULATING, CIRCULATING_MKT_CAP_USD, TOPLIST_BASE_RANK and the rest.

FAQ

What is the CoinDesk Data API?

CoinDesk Data, formerly CCData and before that CryptoCompare, is the market data arm of CoinDesk. Its Data API at data-api.coindesk.com serves exchange spot, futures and options data, CoinDesk indices such as CADLI, asset reference data, on-chain data and an aggregated crypto news feed. It is documented at developers.coindesk.com, and the provider publishes its full OpenAPI document. This actor wraps its most used read routes; the document and the live host were checked on 2026-10-11.

Can I use it without an API key?

No. Every CoinDesk Data API data route answers HTTP 401 "API key required" without a key, including the legacy min-api.cryptocompare.com host. A free key from developers.coindesk.com is enough to start. Without a key the run ends cleanly and nothing is charged.

How do I download Bitcoin price history as OHLCV candles?

Pick spot OHLCV candles, choose the exchange (for example coinbase), list BTC-USD in instruments, pick days, hours or minutes, and set a start time. The run walks back from the end time (or now) to the start time, newest first. For a cross-exchange reference price, use index OHLC history with the cadli family instead.

What is CADLI?

CADLI is the CoinDesk Adaptive Diversified Liquidity Index, a 24 hour volume-weighted average price across exchanges with a time penalty and outlier adjustment. It is the default index family in this actor. Other families, such as ccix, are listed in the index family dropdown; some need a key with that family's entitlement.

How do I find the right instrument names?

Instruments are case sensitive and read BASE-QUOTE, such as BTC-USD or ETH-USDT. An exchange's own code (for example XXBTZUSD on kraken) works too. An instrument the exchange does not carry comes back as a free row naming it.

How do I get crypto news for one coin or one publisher?

Pick news articles and set categories (for example BTC or ETH) and sources (for example coindesk). The news sources mode lists every source key. Articles come back newest first with sentiment, keywords and categories.

What do I pay?

0.01 USD per latest spot tick, index value or asset record, 0.008 USD per news article, and 0.005 USD per candle or news source. Rows for requests that found nothing are free. Your CoinDesk Data plan applies separately.

What happens if my key is wrong or out of calls?

The provider answers HTTP 401 or 429 and the run ends cleanly with a status message, before anything is charged for that request.

Keyword map

crypto price API, CoinDesk Data API, CryptoCompare API, CCData API, Bitcoin price history API, crypto OHLCV API, crypto candles API, crypto historical data, CADLI index, CoinDesk index, crypto market cap API, crypto top list, crypto asset metadata, crypto supply data, crypto news API, crypto news sentiment, exchange ticker API, best bid and ask, Coinbase BTC-USD price, Binance price data.

Terms and data use

CoinDesk Data licenses API data for the key holder's own internal use only. Its API licence agreement says the data must not be shared with anyone else, must not be used for display purposes (on a website or in an application), must not be used to build or distribute products to customers, and must not be used to create or in connection with any index or financial product, unless CoinDesk Data agrees in writing. Licensed data must be deleted when the licence ends. Paid plans and enterprise agreements can grant wider rights. This actor does not change your licence: keep the run's dataset private, and check your plan before sharing or publishing it. News articles belong to their publishers; the article body is left out unless you turn it on.

Which routes were checked live: without a key, and with a short bogus key, the host answers HTTP 401 on every route. With a key of realistic length it answers an invented path with HTTP 404 "Path does not exist", so every wired route was confirmed to exist.