Build, Analyze, and Scale with Crypto’s Most Trusted Data API


Power any project, application and workflow with one unified crypto data API
Exchanges & Wallets
Build seamless trading and custody interfaces with live multi-chain tracking and verified asset metadata.
AI Agents & DeFAI
Fuel autonomous agents with real-time data to eliminate price hallucination and provide accurate market trend insights
Analytics Tools
Create professional-grade market trackers using macro ecosystem insights and specialized institutional treasury data.
Institutional Trading
Power professional infrastructure with high-resolution historical data and unified liquidity monitoring for global arbitrage.
DeFi & Web3 Apps
Secure your protocol with manipulation-resistant price feeds and real-time health metrics for onchain assets.
Audit & Compliance
Automate reporting with verified historical archives to generate audit-ready snapshots and precise cost-basis calculations.
One API for all crypto market data. Access real-time and historical crypto prices, market data, onchain liquidity and more – all through a single API
Coins & Tokens
/coins/*
Get real-time and historical prices, market data and metadata for coins and tokens listed on CoinGecko, including images, descriptions, links, social stats and supply info.
Global
/global/*
Get global cryptocurrency market data such as total market cap, volume and dominance over time.
Exchange & Derivatives
/exchanges/*
/derivatives/*
Get data for centralized spot and derivatives exchanges on CoinGecko, including tickers (trading pairs), volumes, market data and exchange metadata.
Onchain DEX
/onchain/*
Get real-time and historical data for onchain pools and tokens listed on GeckoTerminal, including prices, market cap, volume and liquidity.
Onchain Trades
/onchain/.../trades/*
Get or stream trades from onchain pools and tokens, including transaction hash, wallet addresses, trade direction, trade size and value.
Historical Charts
/coins/.../market_chart/*
Get up to 12 years of historical crypto market data and price charts, with granularity down to every 5 minutes.
OHLC & OHLCV Charts
/ohlc/*
/ohlcv/*
Get real-time and historical OHLCV (open, high, low, close, volume) data for building candlestick charts, with up to sub-second granularity.
Search & Discovery
/search/*
Get market discovery data such as trending coins, top gainers and losers, new pools and tokens, and search coins, categories and exchanges by name, symbol or contract address.
Coin Categories
/categories/*
Get the full list of coin and token categories across CoinGecko and GeckoTerminal, along with category-level market data.
Public Treasuries
/public_treasury/*
Get data on public company and government crypto treasuries, covering BTC, ETH and a wide range of other digital asset treasuries (DATs) with their current valuations.
NFT
/nfts/*
Get real-time and historical NFT collection data listed on CoinGecko, including floor prices, market data, and metadata.
Get comprehensive, high-fidelity coverage
Widest coverage of assets across all major networks
Covering more than 36,000,000 trading pairs on CEXs and DEXs
Reliable infrastructure you can trust
Supporting all major blockchains like Ethereum, Bitcoin, Solana and more
Extensive historical data with second-level granularity
Access trusted crypto data that's accurate and reliable
Rigorous checks and algorithms ensure that all token information is accurate, trustworthy, and free from manipulation, scams or bad data — giving builders and businesses a dependable source of truth for mission-critical applications.
We source data from a broad range of centralized and decentralized exchanges, apply our proprietary Bitcoin Price Index (BPI) as the reference benchmark, and then aggregate market prices across coins after filtering out outliers.
Fetch crypto prices and market data from 200+ networks
Seamless usage for developers, vibe coders, researchers, and just about anyone
Wondering how to use different endpoints together? Find everything you need to get started in one place.
Persistent connection to stream real-time data for live charts and low-latency trading dashboards.
Event-driven notifications for price alerts, portfolio updates, and key market movements.
TypeScript and Python SDKs to streamline your integration process and leverage pre-built functionalities.
A high-performance terminal interface for real-time & historical crypto data, built in Go.
Don't code? Fetch real-time prices using simple syntax directly in Google Sheets and Excel
Your gateway for connecting AI agents and large language models, like Claude and Gemini, directly to our data streams.
Installable SKILL packages that give AI coding agents specialized knowledge about the CoinGecko API.
Enterprise-grade performance trusted by the world's leading crypto applications
From side projects to industry giants
@coingecko is definitely the best – A Thread 🧵
If you wanna develop something cool in crypto, the CoinGecko API is a must-try! It's packed with information on almost every coin and token, plus chain data. And it's super easy to integrate.
Questions?
-
Is CoinGecko API free?
- CoinGecko API offers both free and paid plans. The Demo API plan is accessible to all CoinGecko users at zero cost, with a stable rate limit of 100 calls/min and a monthly cap of 10,000 calls. Paid plans start at $35/mo, offering a higher rate limit of 100 calls/min/min and a monthly cap of 100,000 calls.
-
What is the CoinGecko API?
-
CoinGecko API is a comprehensive, industry-trusted crypto data API with complete market coverage. It gives developers, projects, and enterprises access to reliable market data — everything from real-time prices and metadata to onchain DEX data — all through one unified, scalable API.
What sets CoinGecko’s API apart is its independence and reputation for data accuracy. Unlike exchange-owned data providers, CoinGecko’s incentives are aligned with data accuracy rather than trade volume. Our crypto assets are independently verified, with prices aggregated across centralized and decentralized exchanges using our published methodology.
The CoinGecko API is widely recognized as the most trusted source of token legitimacy and market data in the industry, with some of the best market and onchain DEX coverage available. -
What are the rate limits for CoinGecko’s API?
- The CoinGecko API Demo plan has a rate limit of 100 calls/min, while paid plans offer a higher rate limit of 300 to 2,500 calls/min. Get in touch with our Enterprise Sales team if you’d like to explore a custom plan with flexible rate limits, dedicated account management, integration consultation, and strategic data advisory.
-
Can I get both live and historical crypto prices with CoinGecko API?
-
Yes, you can get real-time prices and market data with CoinGecko’s /simple/price or /coins/markets endpoints. We also recommend using CoinGecko’s WebSocket API to stream low-latency crypto prices with real-time updates.
As for historical data, CoinGecko API’s /coins/{id}/market_chart and /coins/{id}/history endpoints cover 12+ years of historical prices, market cap, and volume (subject to data availability and your API subscription plan). -
Can I access onchain DEX data from CoinGecko API?
-
Yes! You can access onchain DEX data through more than 20 endpoints on the CoinGecko API. Key datasets include crypto liquidity pools, token data by contract address and OHLCV chart data.
This data is powered by our sister product, GeckoTerminal, which monitors real-time crypto price, trading volume, transactions, liquidity and more, on over 1,000 DEXs across 200 blockchain networks – including popular platforms like Uniswap, PancakeSwap, Orca, Curve, and Balancer. -
What are some examples of onchain data provided by CoinGecko API?
-
CoinGecko API provides rich onchain market data for 17M+ tokens traded across 250+ blockchain networks, including Ethereum, Solana, TON, BNB Chain, and Base. Some popular onchain data types include:
- Token Prices & Liquidity Data: Get real-time and historical token prices, liquidity, transactions, and more from DEXs
- OHLCV Data: Build candlestick charts using open, high, low, close, and volume data with second-level resolution
- Launchpad Tokens: Get bonding curve data for tokens on Pump.fun, Four.meme, Raydium Launchlab and more
- Security Info: Fetch metrics like GeckoTerminal Score, holder distribution, and mint/freeze authority to verify token legitimacy
-
Is CoinGecko API suitable for enterprise-scale businesses?
-
Absolutely. The CoinGecko API is battle-tested at scale and trusted by some of the largest names in the industry, including Consensys, Chainlink, Coinbase, Ledger, Etherscan, and many more. Check out our case studies to see how they use the CoinGecko API.
Our Enterprise plan offers:- Exclusive data access — Enterprise-only endpoints including historical circulating and total supply data, plus complete access to 12+ years of historical data in full resolution
- Dedicated support and account management — 24/7 private Slack and email support, customizable SLAs, and a dedicated customer success manager
- Long-term Data Partner: CoinGecko is not just a data provider; we’re a partner you can build with, supporting your growth through integration consultations, business reviews, and collaborative roadmap input
- Flexible, usage-based plans — custom rate limits, credits, API keys, white label options, and data licensing tailored to your needs
- Mission-critical reliability — 99.9% uptime SLA with enterprise-grade monitoring around the clock
If you’re building with scale in mind, we’re ready to grow with you.
📩 Reach out to our team to explore an enterprise partnership.
-
What are the differences between commercial and custom licenses?
-
Commercial use for Analyst, Lite and Pro plan:
- Your product shall prominently display the message 'Data provided by CoinGecko' and include a hyperlink to https://cgecko-proxy.deepspace.workers.dev/en/api. Learn more about our branding guide here
- You're entitled to charge for your services and products that incorporate or integrate data from CoinGecko API. However, you are not permitted to sell, rent, lease, sub-license, re-distribute or syndicate access to the CoinGecko API or part thereof. Learn more about our API terms here.
Reach out to our team here to advise on your specific needs. -
Can I tailor the subscription plan to fit my needs?
- If you are uncertain whether the current subscription tiers suit your needs, do speak to us here, and we may tailor a customised enterprise plan to fit within your budget.
-
What are my payment options?
-
Credit card payment (Visa, Mastercard, American Express, Discover & JCB) is the default payment for Analyst, Lite and Pro plans.
For Enterprise plans, reach out to us here and our team can better brief you on the payment options such as USD bank transfer and crypto payment. -
What are the overage charges like?
- You will be charged $250 for every 500,000 calls made.
-
How does CoinGecko API count the API usage credit?
- 1 call = 1 credit. Calling any endpoint will only count as 1 call.
-
When does my request volume (monthly API credit) reset?
-
Regardless of your billing cycle, your requests are counted from the first day of the month to the last.
If you start your subscription sometime after the first day of the month, you'll still receive your full quota of requests for that partial month. Then on the first day of the following month, your request will reset again. -
What is the refund policy of CoinGecko API subscription?
- All payments must be made in advance prior to the commencement/start date of your usage plan and each recurring billing cycle thereafter) and are non-refundable (whether in whole or in part).
-
What are the differences between Demo, Basic, Analyst, Lite, Pro, Pro+ and Enterprise Plans?
-
- The Demo Plan is a free plan to try out the CoinGecko API. It’s good for testing and exploration, but comes with limited call credits and a rate limit of 100 calls/min.
- The Basic Plan is suited for personal use that requires more call credits, a higher rate limit, and more frequent data updates.
- Meanwhile, the Analyst, Lite, Pro, and Pro+ Plans are designed for serious analysis work and small to medium-sized projects. They come with a more complete suite of CoinGecko API features, including real-time data, 70+ endpoints, and a commercial license. The main differences between them are the call credits and rate limits.
- For enterprises with high usage volume that require a custom plan to meet their business needs (including custom licensing, SLAs, strategic advisory, etc.), the Enterprise plan will be the right fit.
-
I am interested in the paid plans. Is there a trial for paid plans before making a purchase?
- For Enterprise plans, we are able to provide up to two weeks trial (on a case by case basis) for users who are interested in making the switch. Please reach out to us here, and we will be in touch with you shortly. Do note that we do not support overage billing for trial plans.
-
When does my subscription expire?
- For users who subscribe month to month subscription plans, it would expire at the end of each calendar month which begins on your date of activation. As for annual subscription, the subscription plan would expire within 365 days of purchase. Do note that auto renewal is turned on by default to ensure uninterrupted services for our users.
-
Can I roll over any unused requests?
- We do not offer such feature to roll over unused requests to the following month for the time being. When your subscription renews, the requests are being reset.
-
I would like to cancel my subscription, how should I go about that?
-
If you’d like to cancel your subscription, simply head over to your Developer Dashboard and click on the “API Plan Details” in the green tab.
If you do not see such an option on your Developer Dashboard, kindly reach out to our team here to initiate the cancellation process. -
How do I upgrade or downgrade my subscription plan?
-
Please visit API plans pricing page pricing page to change your subscription plan.
If you do not see such an option on your Developer Dashboard, kindly reach out to our team here, and we will assist in reviewing your needs. -
Do you provide an SLA?
- Yes, we provide SLA’s for our Enterprise clients. Contact us here to learn more.
-
Where can I find my API key?
- Your API Key would only reveal once you have generated the API key in the Developers Dashboard. Do note that if the API key is compromised, you will need to delete this key and generate a new API key.
-
Where do I pass the Pro API key (any paid plans) when making a request?
-
You can supply your Pro API key in one of two ways:
1. Header: x-cg-pro-api-key
2. Query string parameter: x_cg_pro_api_key
Note: Pro API key is currently only available for CoinGecko API paid plan subscribers, all API key request should target this domain https://pro-api.coingecko.com. You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL. -
How often does data get refreshed or updated?
-
This depends - but endpoints are all cached to around 1 to 5 minutes and you can expect most data to be updated at similar intervals unless otherwise specified. Pro API (paid plans) generally have faster update frequency, i.e. 30 sec for simple/price endpoint.
This also means that as a user, you should try to throttle your response to ensure that you are not wasting bandwidth by making calls too frequently. -
How far back is the historical data?
-
You can access more than 10 years worth of historical data using our API, starting from 2014.
This is subject to availability, as certain cryptocurrencies may not have full range of data points if the exchange is not supported at time of trading commencement. -
What is the historical data availability or granularity?
- All plans include access to daily and hourly historical data (the number of years you can access depends on your subscription plan). For higher resolution, 5-minute granularity is available exclusively on the Enterprise plan.
-
Where can I find the token lists specific to a chain (for e.g. Arbitrum)?
-
You would have to identify the ID for the chain you are looking for using the asset platform endpoint. Once you have identified the ID, replace the correct ID in this link https://tokens.coingecko.com/<ID>/all.json
In this case, it would be https://tokens.coingecko.com/arbitrum-one/all.json
-
How quickly would the support team respond?
- Due to a large number of incoming queries, please note that our support team will reach out to you within 48 hours.
-
I have questions that are not listed here, where can I seek help?
- Please visit our help center for the full list of questions. You may also drop us a message via support.coingecko.com.
-
Is there a call consumption alert?
- Yes! Just head over to the developer dashboard and click on the Notifications tab to enable usage alerts. Note that users will receive an email once usage reaches the 80% and 100% thresholds. You may also optionally enable additional alerts at 50% and 90% credit usage.
-
I have reached 100% of my monthly calls consumption. What should I do?
-
It is your responsibility to review and monitor the plan's usage limitation by keeping track of your monthly quota usage to prevent overages. You can do this by tracking the number of API calls via the Developer Dashboard for up-to-date usage statistics.
Once you have reached 100% monthly calls consumption, we will be adding more requests to your account. You will be billed overages as an additional charge and added to the following month's invoice.
Feel free to visit the pricing page and consider upgrading to a higher tier plan to accommodate your increasing usage. -
Can I turn off overage billing?
- Yes. Overage billing is disabled by default. However, users with a paid subscription plan have the option to enable overage billing through the developer dashboard.
-
Is there an endpoint to check the number of calls used for the month/per minute?
- Yes, you may use our /key endpoint to check your monthly call credit balance and details.
-
How can I differentiate between the status codes I am receiving and what do they mean?
-
The server responds to a user’s request by issuing status codes when the request is made to the server. Kindly refer to the table below to further understand the status codes when indicating the success or failure of an API call.
Status codesDescription400 (Bad Request)This is due to an invalid request and the server could not process the user's request.401 (Unauthorised)This is due to the lack of valid authentication credentials for the requested resource by the user.429 (Too many requests)This is likely indicating that the rate limit has reached. The user should reduce the number of calls made, or consider scaling their service plan that has much higher rate limits and call credits.
To upgrade your plans, kindly refer to the “Plans” tab.500 (Internal Server Error)This is a generic error response indicating that the server has encountered an unexpected issue that prevented it from fulfilling the request.503 (Service Unavailable)The service is currently unavailable. Please check the API status and updates on https://status.coingecko.com/10002 (API Key Missing)You have provided incorrect API key credentials. Please check your keys in the developer dashboard and ensure that your request is authorised.10005You may not have access to this endpoint. E.g. 'This request is limited Pro API subscribers'. You may wanna subscribe to a paid plan here.1020 (Access Denied)This is due to violation of CDN firewall rule.CORS errorA CORS error occurs when the server doesn’t return the CORS headers required. You may learn more and attempt the recommended solutions here.
The data layer for leading crypto applications
Ethereum Mainnet
Base Mainnet
BNB Smart Chain
Arbitrum
Avalanche
Fantom
Flare
Gnosis
Linea
Optimism
Polygon
Polygon zkEVM
Scroll
Stellar
Story
Syscoin
Telos
X Layer
Xai