CoinGecko API llms.txt

The actual file

Source Markdown

The saved llms.txt text, displayed as source. The file belongs to its publisher; the live endpoint may change.

Showing the first 18000 characters. Load the complete file to read the remainder.

# CoinGecko API

> CoinGecko API delivers real-time and historical cryptocurrency data — including prices, OHLCV, market cap, trading volume, NFT, and onchain DeFi data — for coins, tokens, pools, and exchanges via REST API, WebSocket, and Webhooks, with SDK and MCP server support for AI agents.

- [Welcome to CoinGecko API](https://docs.coingecko.com/index.md)
- [Setting Up Your API Key](https://docs.coingecko.com/docs/setting-up-your-api-key.md): Create an API key and start making requests
- [Errors & Rate Limits](https://docs.coingecko.com/docs/errors-and-rate-limits.md): HTTP status codes, CoinGecko error codes, and rate limit behavior
- [API Status](https://docs.coingecko.com/docs/api-status.md): Live status, incident history, and uptime for the CoinGecko API
- [Data Delivery Methods](https://docs.coingecko.com/docs/data-delivery-methods.md): REST API, WebSocket, and Webhooks — choose the right method for your use case
- [How-To](https://docs.coingecko.com/docs/how-to.md): Learn how to query CoinGecko and onchain data — identifiers, common patterns, and quick answers
- [Querying Coin Data](https://docs.coingecko.com/docs/querying-coin-data.md): Coin IDs, contract addresses, bulk queries, historical data, and common CoinGecko API patterns
- [Querying Onchain Data](https://docs.coingecko.com/docs/querying-onchain-data.md): Network IDs, DEX IDs, pool and token queries, and common onchain API patterns
- [Common Use Cases](https://docs.coingecko.com/docs/common-use-cases.md): Step-by-step guides for building with the CoinGecko API — trading, portfolio tracking, market research, and more
- [Trading](https://docs.coingecko.com/docs/trading.md): Build trading bots, charting tools, and backtesting pipelines with CoinGecko API
- [Portfolio Tracking](https://docs.coingecko.com/docs/portfolio-tracking.md): Build portfolio trackers with real-time valuation, cost basis, and multi-currency support from CoinGecko API
- [Market Research](https://docs.coingecko.com/docs/market-research.md): Conduct deep market research with fundamentals, trending data, sector analysis, and onchain analytics from CoinGecko API
- [DeFi & Onchain Analytics](https://docs.coingecko.com/docs/defi-onchain-analytics.md): Analyze onchain tokens, pools, trades, and holder distribution across 200+ networks from CoinGecko API
- [Compliance & Reporting](https://docs.coingecko.com/docs/compliance-reporting.md): Build tax reporting, fund accounting, and audit pipelines with timestamped historical prices from CoinGecko API
- [AI Agents & LLM Apps](https://docs.coingecko.com/docs/ai-agents-llm-apps.md): Build AI agents and LLM-powered apps with real-time crypto data from CoinGecko — MCP, SDK function calling, and prompt patterns
- [Endpoint Showcase](https://docs.coingecko.com/docs/endpoint-showcase.md): See how CoinGecko API powers CoinGecko.com and GeckoTerminal.com
- [Pay with Crypto](https://docs.coingecko.com/docs/crypto-payment.md): Pay for a CoinGecko API subscription with crypto (USDC, USDT, and more)
- [CoinGecko SDK](https://docs.coingecko.com/docs/sdk.md): Official TypeScript and Python SDKs for the CoinGecko API
- [TypeScript SDK](https://docs.coingecko.com/docs/sdk-typescript.md): Official CoinGecko TypeScript SDK — install, authenticate, and start querying
- [Python SDK](https://docs.coingecko.com/docs/sdk-python.md): Official CoinGecko Python SDK — install, authenticate, and start querying
- [Spreadsheet Add-ons](https://docs.coingecko.com/docs/spreadsheet.md): Pull live CoinGecko data into Google Sheets and Microsoft Excel
- [CoinGecko for Google Sheets](https://docs.coingecko.com/docs/google-sheets.md): Pull live prices, historical data, NFT floors, and onchain data into Google Sheets with the =COINGECKO() function
- [CoinGecko for Microsoft Excel](https://docs.coingecko.com/docs/excel.md): Pull live prices, historical data, NFT floors, onchain token prices, and market cap rankings into Excel with =CG. formulas
- [Fiat Currencies Support List](https://docs.coingecko.com/docs/fiat-currencies-support.md): Full coverage of fiat currencies supported by CoinGecko API endpoints, with their currency codes
- [Useful Links](https://docs.coingecko.com/docs/useful-links.md): Quick links to resources, specs, and tools for the CoinGecko API
- [AI Integration](https://docs.coingecko.com/ai-integration/index.md): Connect AI agents and coding assistants to CoinGecko — MCP servers, SDK prompts, CLI, and per-platform setup guides
- [CoinGecko MCP](https://docs.coingecko.com/ai-integration/mcp-server.md): Connect AI agents to real-time crypto data via the CoinGecko MCP Server
- [CoinGecko Docs MCP](https://docs.coingecko.com/ai-integration/docs-mcp.md): Let AI agents search CoinGecko documentation via the Docs MCP Server
- [CoinGecko Agent SKILL](https://docs.coingecko.com/ai-integration/agent-skill.md): Give AI agents built-in knowledge of the CoinGecko API with the installable SKILL package
- [CoinGecko CLI](https://docs.coingecko.com/ai-integration/cli.md): A high-performance terminal interface for real-time and historical crypto data
- [Pay-Per-Use Crypto Data (x402)](https://docs.coingecko.com/ai-integration/x402.md): Access CoinGecko API endpoints with native crypto payments — no API key or account required
- [Claude Code](https://docs.coingecko.com/ai-integration/claude-code.md): Wire CoinGecko into Anthropic's terminal coding agent — MCP, SKILL, and SDK prompts in one place
- [OpenAI Codex](https://docs.coingecko.com/ai-integration/openai-codex.md): Wire CoinGecko into OpenAI's Codex coding agent — MCP, SKILL, and SDK prompts in one place
- [Cursor](https://docs.coingecko.com/ai-integration/cursor.md): Connect CoinGecko to Cursor — MCP server and SDK prompts in one place
- [AWS Kiro](https://docs.coingecko.com/ai-integration/kiro.md): Connect CoinGecko to Kiro — MCP server, SKILL, and steering rules in one place
- [Google Antigravity](https://docs.coingecko.com/ai-integration/antigravity.md): Connect CoinGecko to Antigravity — MCP server, SKILL, and SDK prompts in one place
- [OpenClaw](https://docs.coingecko.com/ai-integration/openclaw.md): Connect CoinGecko to your OpenClaw agent — MCP server, SKILL, and CLI in one place
- [Notion](https://docs.coingecko.com/ai-integration/notion.md): Connect your Notion AI agent to CoinGecko MCP for live crypto data
- [Endpoint Overview](https://docs.coingecko.com/reference/endpoint-overview.md): Complete list of endpoints available in the Pro API
- [Authentication (Pro API)](https://docs.coingecko.com/reference/authentication.md): How to authenticate requests to the CoinGecko Pro API
- [Price](https://docs.coingecko.com/reference/price-overview.md): Current prices for coins and tokens by ID, symbol, name, or contract address.
- [Coin Price by IDs, Symbols, or Names](https://docs.coingecko.com/reference/simple-price.md): To query the prices of one or more coins by using their unique Coin API IDs, symbols, or names
- [Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price.md): To query one or more token prices by using their token contract addresses
- [Search & ID Map](https://docs.coingecko.com/reference/search-and-id-map-overview.md): Search coins, categories and markets, and look up the coin, asset platform and currency IDs other endpoints require.
- [Search Queries](https://docs.coingecko.com/reference/search-data.md): To search for coins, categories and markets listed on CoinGecko
- [Coins List](https://docs.coingecko.com/reference/coins-list.md): To query all the supported coins on CoinGecko with coin ID, name and symbol
- [Asset Platforms List](https://docs.coingecko.com/reference/asset-platforms-list.md): To query all the supported asset platforms (blockchain networks) on CoinGecko
- [Token Lists by Asset Platform ID](https://docs.coingecko.com/reference/token-lists.md): To get full list of tokens of a blockchain network (asset platform) that is supported by [Ethereum token list standard](https://tokenlists.org/)
- [Currencies List](https://docs.coingecko.com/reference/simple-supported-currencies.md): To query all the supported currencies on CoinGecko
- [Coins](https://docs.coingecko.com/reference/coins-overview.md): Coin metadata, market data, tickers, historical snapshots, new listings and top gainers and losers.
- [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets.md): To query all the supported coins with price, market cap, volume and market related data
- [Coin Data by ID](https://docs.coingecko.com/reference/coins-id.md): To query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on a particular coin ID
- [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address.md): To query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on an asset platform and a particular token contract address
- [Coin Tickers by ID](https://docs.coingecko.com/reference/coins-id-tickers.md): To query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID
- [Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history.md): To query the historical data (price, market cap, 24hrs volume, etc.) at a given date for a coin based on a particular coin ID
- [Recently Added Coins](https://docs.coingecko.com/reference/coins-list-new.md): To query the latest 200 coins that recently listed on CoinGecko
- [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers.md): To query the top 30 coins with largest price gain and loss by a specific time duration
- [Coin Supply Breakdown by ID](https://docs.coingecko.com/reference/coins-id-supply-breakdown.md): To query the supply breakdown of a coin based on provided coin ID
- [Coin Charts](https://docs.coingecko.com/reference/coin-charts-overview.md): Historical price, market cap, volume, OHLC and supply charts for any coin, by coin ID or token contract address.
- [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart.md): To get the historical chart data of a coin including time in UNIX, price, market cap and 24hrs volume based on particular coin ID
- [Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range.md): To get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hrs volume based on particular coin ID
- [Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart.md): To get the historical chart data including time in UNIX, price, market cap and 24hrs volume based on asset platform and particular token contract address
- [Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range.md): To get the historical chart data within certain time range in UNIX along with price, market cap and 24hrs volume based on asset platform and particular token contract address
- [Coin OHLC Chart by ID](https://docs.coingecko.com/reference/coins-id-ohlc.md): To get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID
- [Coin OHLC Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-ohlc-range.md): To get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID
- [Circulating Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart.md): To query historical circulating supply of a coin by number of days away from now based on provided coin ID
- [Circulating Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range.md): To query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID
- [Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart.md): To query historical total supply of a coin by number of days away from now based on provided coin ID
- [Total Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range.md): To query historical total supply of a coin, within a range of timestamp based on the provided coin ID
- [Categories](https://docs.coingecko.com/reference/categories-overview.md): Coin categories and their aggregate market cap and volume, for filtering coins by sector.
- [Coins Categories List](https://docs.coingecko.com/reference/coins-categories-list.md): To query all the supported coins categories on CoinGecko
- [Coins Categories List with Market Data](https://docs.coingecko.com/reference/coins-categories.md): To query all the coins categories with market data (market cap, volume, etc.) on CoinGecko
- [Real World Assets (RWA)](https://docs.coingecko.com/reference/rwa-overview.md): Aggregated onchain market data for tokenized stocks, commodities and ETFs, their tokens and issuers.
- [RWA List](https://docs.coingecko.com/reference/rwas-list.md): To query all the supported tokenized real world assets (RWAs) on CoinGecko with RWA ID, name and symbol
- [RWA List with Market Data](https://docs.coingecko.com/reference/rwas-markets.md): To query all the supported RWAs with price, market cap, volume and market related data
- [RWA Data by ID](https://docs.coingecko.com/reference/rwas-id.md): To query all the metadata, market data and tokens of a RWA based on a particular RWA ID
- [RWA Tickers by ID](https://docs.coingecko.com/reference/rwas-id-tickers.md): To query the RWA tokens tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular RWA ID
- [RWA Historical Chart Data by ID](https://docs.coingecko.com/reference/rwas-id-market-chart.md): To get the historical chart data of a RWA including time in UNIX, price, market cap and 24hrs volume based on a particular RWA ID
- [RWA Issuers List](https://docs.coingecko.com/reference/rwas-issuers-list.md): To query all the supported RWA issuers on CoinGecko
- [RWA Issuer Data by ID](https://docs.coingecko.com/reference/rwas-issuers-id.md): To query the market data (market cap, volume, etc.) and tokens of an issuer based on a particular issuer ID
- [Exchanges](https://docs.coingecko.com/reference/exchanges-overview.md): Centralized exchange data, trading pairs and tickers, and historical exchange volume in BTC.
- [Exchanges List](https://docs.coingecko.com/reference/exchanges-list.md): To query all the supported exchanges with ID and name
- [Exchanges List with Data](https://docs.coingecko.com/reference/exchanges.md): To query all the supported exchanges with exchanges' data (ID, name, country, etc.) that have active trading volumes on CoinGecko
- [Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id.md): To query exchange's data (name, year established, country, etc.), exchange volume in BTC and top 100 tickers based on exchange's ID
- [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers.md): To query exchange's tickers based on exchange's ID
- [Exchange Volume Chart by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart.md): To query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID
- [Exchange Volume Chart within Time Range by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range.md): To query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID
- [Derivatives](https://docs.coingecko.com/reference/derivatives-overview.md): Derivatives exchanges, perpetual and futures tickers, open interest and trading volume.
- [Derivatives Exchanges List](https://docs.coingecko.com/reference/derivatives-exchanges-list.md): To query all the supported derivatives exchanges with ID and name on CoinGecko
- [Derivatives Tickers List](https://docs.coingecko.com/reference/derivatives-tickers.md): To query all the tickers from derivatives exchanges on CoinGecko
- [Derivatives Exchanges List with Data](https://docs.coingecko.com/reference/derivatives-exchanges.md): To query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko
- [Derivatives Exchange Data by ID](https://docs.coingecko.com/reference/derivatives-exchanges-id.md): To query the derivatives exchange's related data (name, open interest, trade volume, ...) based on the exchange's ID
- [Public Treasury](https://docs.coingecko.com/reference/public-treasury-overview.md): Bitcoin and crypto holdings of public companies and governments, with holding charts and transaction history.
- [Entities List](https://docs.coingecko.com/reference/entities-list.md): To query all the supported entities on CoinGecko with entity ID, name, symbol, and country
- [Crypto Treasury Holdings by Coin ID](https://docs.coingecko.com/reference/companies-public-treasury.md): To query public companies' and governments' cryptocurrency holdings by coin ID
- [Crypto Treasury Holdings by Entity ID](https://docs.coingecko.com/reference/public-treasury-entity.md): To query public companies' and governments' cryptocurrency holdings by entity ID
- [Crypto Treasury Holdings Historical Chart Data by ID](https://docs.coingecko.com/reference/public-treasury-entity-chart.md): To query historical cryptocurrency holdings chart of public companies and governments by entity ID and coin ID
- [Crypto Treasury Transaction History by Entity ID](https://docs.coingecko.com/reference/public-treasury-transaction-history.md): To query public companies' and governments' cryptocurrency transaction history by entity ID
- [NFTs](https://docs.coingecko.com/reference/nfts-overview.md): NFT collection floor