Crypto Price API - CoinGecko OHLC, DEX Pools, NFTs, Treasuries

Export live crypto prices, coin markets, OHLC candles, historical charts, exchange tickers, NFT floor prices and onchain DEX pools into an Apify dataset with your own CoinGecko API key.

This actor wraps the CoinGecko REST API, on both the free Demo plan and the paid Pro plans, including its GeckoTerminal onchain endpoints. It turns a list of coin IDs, a network and pool addresses, or a market filter into clean, deduplicated rows you can download as JSON, CSV or Excel, schedule every few minutes, or feed into trading bots, portfolio trackers, dashboards, spreadsheets and AI agents. Bring your own API key.

What it does

• Crypto prices: live price, market cap, 24h volume and 24h change for any coin by CoinGecko ID or symbol, or any token by contract address, in USD, EUR, BTC or 40+ other currencies.
• Coin markets: the full coin list ranked by market cap or volume, with price, ATH, ATL, supply and 1h to 1y price change, filtered by coin, symbol or category (layer-1, meme, AI, DeFi).
• Coin details and snapshots: metadata, links, categories, contract addresses on every chain and market data, or the 00:00 UTC snapshot of any past date.
• Historical charts and OHLC: price, market cap and volume series (5 minute, hourly or daily) and OHLC candles, by days back or by date range.
• Tickers and exchanges: every trading pair of a coin or an exchange (CEX and DEX) with converted price, volume, spread, 2% depth and trust score; exchange rankings; perpetual and futures tickers with funding rate and open interest.
• Market overview: trending searches, top gainers and losers, recently listed coins, coin categories, global market cap and BTC dominance, global DeFi market.
• Public treasuries: public companies and governments holding bitcoin, ethereum, solana and other coins, with holdings and value.
• NFTs: collection floor price, market cap, volume, owners and sales, by collection or as a ranked market list.
• Crypto news: the latest news and guides published on CoinGecko, by coin and language.
• Onchain DEX data (GeckoTerminal): trending and new pools, top pools by network or token, pool search, the pool screener (megafilter), pools and tokens by address, pool OHLCV candles down to the minute, and the latest DEX trades, across 200+ networks.
• Pay only for results: empty answers and unknown IDs are recorded as a free row that says why, never charged.

Input

Field	Used by	What it does
mode	all	simplePrice, tokenPrice, coinMarkets, coinDetails, coinHistory, coinTickers, marketChart, ohlc, topGainersLosers, newCoins, trending, search, categories, globalMarket, defiMarket, exchanges, exchangeTickers, derivatives, publicTreasury, nftMarkets, nftDetails, news, trendingPools, newPools, topPools, tokenPools, searchPools, poolScreener, poolDetails, tokenData, poolOhlcv or poolTrades
coinIds, symbols	coin modes	CoinGecko API IDs such as bitcoin or ethereum; symbols such as btc
vsCurrency	price modes	usd, eur, btc and so on
category, marketOrder, priceChangeWindows	coin markets	Category filter, sort, extra change windows
days, from, to, interval	charts, OHLC	Days back, or a date range; daily or hourly
date	coin snapshot	The snapshot date
assetPlatform, contractAddresses	token prices	Chain and token contracts
exchangeIds, treasuryEntity, nftIds	tickers, treasuries, NFTs	What to read
searchQuery	search modes	A name, symbol or address
duration, topCoins	gainers, trending pools	Time window and universe
network, poolAddresses, tokenAddresses	onchain modes	GeckoTerminal network (eth, solana, base) and addresses
timeframe, aggregate, minTradeUsd, poolSort	onchain modes	Candle size, trade filter, pool sort
minLiquidityUsd, minVolumeUsd, maxPoolAgeHours, safetyChecks	pool screener	Liquidity, volume, age and honeypot filters
newsLanguage, newsType	news	Language, news or guides
maxResults, requestsPerMinute	all	Row ceiling and pacing
apiPlan	all	Auto, Demo or Pro
apiKey	all	Your CoinGecko API key (secret). Or set the DATA_API_KEY environment secret

Inputs a mode does not use are left off the request and named in the log, so a filter meant for another mode never silently changes your results.

How to get an API key

Create a CoinGecko account at coingecko.com/en/api/pricing, then click Add New Key in the Developer Dashboard. The free Demo plan works for most modes. The modes marked "paid plan" (top gainers and losers, new coins, NFT markets, news, the pool screener and OHLC date ranges) need a Basic, Analyst, Lite, Pro or Enterprise plan key. Paste the key (it starts with CG-) into the API key field and leave the API plan on Auto.

Example output

{
    "mode": "coinMarkets",
    "recordType": "coinMarket",
    "identifier": null,
    "found": true,
    "id": "bitcoin",
    "coinId": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "network": null,
    "address": null,
    "date": "2026-10-08T20:46:30.512Z",
    "price": 81748,
    "marketCap": 1642902136141,
    "volume": 38211934077,
    "change24h": -2.31,
    "value": 81748,
    "market_cap_rank": 1,
    "high_24h": 84102,
    "low_24h": 81220,
    "ath": 126080,
    "circulating_supply": 19932512,
    "price_change_percentage_7d_in_currency": -4.12,
    "note": null
}

Every field the provider returns is kept. value is the headline number of each record type: the price for prices, markets, candles and NFTs, market cap for categories and global snapshots, trust score for exchanges and tickers, open interest for derivatives, holdings for treasuries, liquidity (reserve in USD) for DEX pools and tokens, and buy or sell for DEX trades.

FAQ

What is the CoinGecko API?

The CoinGecko API is the crypto market data API from CoinGecko, covering more than 20,000 coins on 1,500+ exchanges plus GeckoTerminal onchain data for millions of tokens and DEX pools on 200+ networks. This actor calls its REST endpoints such as /simple/price, /coins/markets, /coins/{id}, /coins/{id}/market_chart, /coins/{id}/ohlc, /coins/{id}/tickers, /exchanges, /derivatives, /nfts/{id}, /search/trending, /global, /onchain/networks/{network}/pools and /onchain/networks/{network}/pools/{address}/ohlcv/{timeframe}.

Do I need my own API key?

Yes. This actor is bring your own key: you need a CoinGecko Demo (free) or paid API key. Your key is stored as an Apify secret, sent only in the x-cg-demo-api-key or x-cg-pro-api-key header, and kept out of every log line. Without a key the run stops immediately with a clear message and no charge.

Does it work with the free Demo plan?

Yes. On Auto the actor checks the key once with /ping, first on the Pro API and then on the Demo API, and uses whichever accepts it. 27 of the 32 modes run on the Demo plan. A paid-only mode on a Demo key ends the run cleanly with a message saying so, before any data call.

How do I get historical crypto prices or OHLC data?

Choose Price chart for price, market cap and volume over time, or OHLC candles for open, high, low and close. Set the coin IDs and either Days back (1, 7, 30, 365 or max) or a From and To date range. Granularity is automatic (5 minute for 1 day, hourly up to 90 days, daily beyond), or set Interval to daily or hourly. For one exact day use Coin snapshot on a date.

How do I get DEX pool and onchain token data?

Use the onchain modes, which read GeckoTerminal through the CoinGecko API. Set the network (eth, solana, base, bsc, arbitrum) and pool or token addresses for pools by address, tokens by address, pool OHLCV candles and pool trades, or leave addresses out for trending pools, new pools, top pools and the pool screener. The Demo plan reads up to 10 pages (200 pools) of each list and the last 300 trades of a pool.

Which companies and governments hold bitcoin?

Choose Public treasury holdings, set the coin IDs to bitcoin (or ethereum, solana and others) and pick public companies or governments. Each row is one holder with total holdings, entry value, current value and share of supply.

What do I pay?

The actor charges per returned record: 0.005 USD per price point, chart point, candle or DEX trade, 0.008 USD per market record (coin market row, ticker, exchange, category, treasury holder, NFT market row, news article, DEX pool or token), 0.01 USD per historical or global snapshot, and 0.02 USD per full coin or NFT collection profile, with Apify platform usage included. Empty results are free. CoinGecko bills your API plan separately: every successful request uses one credit, and each list page is one request.

What happens if my key is wrong or my plan does not cover a request?

A wrong or revoked key (CoinGecko answers "API Key Missing" to any key it does not recognise), a key sent to the wrong plan's host, a request outside your plan, or a used-up monthly credit allowance ends the run cleanly with the provider's own explanation as the status message. The per-minute rate limit (429) is waited out and retried.

Keyword map

CoinGecko API, crypto price API, cryptocurrency market data, bitcoin price API, crypto OHLC data, historical crypto prices, crypto market cap, coin tickers, exchange volume, crypto derivatives funding rate, trending coins, top gainers and losers, NFT floor price API, bitcoin treasury companies, GeckoTerminal API, DEX pools, onchain token price, DEX OHLCV, DEX trades, crypto news API.

Terms and data use

You need your own CoinGecko API key, and your use of the data is governed by the CoinGecko API Terms of Service and your plan. The terms ask you to show the attribution "Powered by CoinGecko" wherever you display the data, discourage caching or storing data and ask that any stored data be refreshed at least every 24 hours and deleted if your access ends, and do not allow reselling, sub-licensing or redistributing access to the API itself. Check your plan's permitted use before you build a product on it. Nothing here is investment advice. This actor is an independent tool and is not made or endorsed by CoinGecko.