Documentation Index
Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
Use this file to discover all available pages before exploring further.
Welcome to the CoinGecko Keyless Public API. Unlike other industry providers that require complex registration, API key management, and credit systems for basic testing, our Keyless Public API allows you to start testing and prototyping in seconds.
This API is designed for light experimentation, open-source projects, and rapid prototyping; offering comprehensive crypto market data and deep-dive onchain analytics without the friction of authentication headers.
🚦 Rate Limits & Fair Usage
To ensure the stability of the public infrastructure for the entire developer community, the Public API is strictly rate-limited.
- Shared Public Pool: All requests are subject to IP-based throttling.
- Limits are dynamic and managed to prioritize fair access. If you receive a
429 Too Many Requests error, please implement an exponential backoff in your code.
- Intended Use: This tier is optimized for low-volume, client-side testing, and non-commercial educational use.
Need higher throughput?If your application requires high-frequency updates, historical data, or production-grade reliability, consider upgrading to a Paid Plan to receive a dedicated API Key and significantly higher limits. Key Differences: Keyless vs. Keyed API
While our Public API is the best way to start, please note the following operational differences compared to our Demo and Paid tiers:
- No Auth Header: Do not include
x-cg-demo-api-key and x-cg-pro-api-key in your headers.
- Rate Limits: Public endpoints are subject to IP-based rate limiting. For high-throughput production environments or historical data, we recommend upgrading to a Demo or Paid Pro Plan.
- Onchain Depth: The
geckoterminal root provides deep liquidity data and OHLCV charts for pools that may not yet be listed on the main CoinGecko market data API.
Quick Start
Our data is split into two primary routes depending on whether you need high-level market data or deep-dive onchain analytics.
To use the Keyless Public API, simply route your requests to the appropriate base URL based on the data you need. No API Key is required.
| Data Type | Base URL | Documentation Reference |
|---|
| CoinGecko Aggregated Price & Market Data (Coins, Exchanges, NFT Floor) | https://api.coingecko.com/api/v3 | CG API Reference |
| Onchain Data (DEXs, Pools, Networks) | https://api.geckoterminal.com/api/v2 | Onchain DEX API Reference |
1. Aggregated Price & Market Data (CoinGecko)
Access the world’s most reliable crypto market data: coins, categories, historical price data, exchanges, derivatives, public treasury, NFTs, and more.
Usage Protocol
- Endpoint Access: All endpoints in our Reference Guide are available except those explicitly marked as “Exclusive” (e.g., historical data beyond a certain range or advanced enterprise metrics).
- Endpoint URL: Use the public root instead of the pro root.
- ❌
https://pro-api.coingecko.com/api/v3/...
- ✅
https://api.coingecko.com/api/v3/...
Example Request:
- Get multiple live crypto prices in multiple currencies, e.g. price of Bitcoin, Ethereum, Solana in USD, EUR, JPY.
curl -X 'GET' \
'https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana&vs_currencies=usd,eur,jpy' \
-H 'accept: application/json'
- Get price and market data of the market cap coins, e.g. top 250 market cap coins.
curl -X 'GET' \
'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&per_page=250&page=1' \
-H 'accept: application/json'
- Get list of a coin (with price & market data) under a specific category, e.g. Tokenized Gold.
curl -X 'GET' \
'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&category=tokenized-gold' \
-H 'accept: application/json'
- Get the past 1 year daily historical data (price, market cap, volume) of Bitcoin.
curl -X 'GET' \
'https://api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=365&interval=daily' \
-H 'accept: application/json'
- Get the latest trending coins, NFTs, and categories.
curl -X 'GET' \
'https://api.coingecko.com/api/v3/search/trending' \
-H 'accept: application/json'
CoinGecko Endpoints: Coins
| Endpoint | Description |
|---|
| /ping | Check the API server status |
| /simple/price | Query the prices of one or more coins by using their unique Coin API IDs |
| /simple/token_price/:id | Query the prices of one or more tokens by using their token contract addresses |
| /simple/supported_vs_currencies | Query all the supported currencies on CoinGecko |
| /coins/list | Query all the supported coins on CoinGecko with coins ID, name and symbol |
| /coins/markets | Query all the supported coins with price, market cap, volume and market related data |
| /coins/:id | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID |
| /coins/:id/tickers | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID |
| /coins/:id/history | Query the historical data (price, market cap, 24hr volume, …) at a given date for a coin based on a particular coin ID |
| /coins/:id/market_chart | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID |
| /coins/:id/market_chart/range | Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hr volume based on particular coin ID |
| /coins/:id/ohlc | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID |
| /coins/../contract/.. | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address |
| /coins/../contract/../market_chart | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address |
| /coins/../contract/../market_chart/range | Get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address |
| /coins/categories/list | Query all the coins categories on CoinGecko |
| /coins/categories | Query all the coins categories with market data (market cap, volume, …) on CoinGecko |
CoinGecko Endpoints: NFT
| Endpoint | Description |
|---|
| /nfts/list | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko |
| /nfts/.. | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection ID |
| /nfts/../contract/.. | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection contract address and respective asset platform |
CoinGecko Endpoints: Exchanges & Derivatives
| Endpoint | Description |
|---|
| /exchanges | Query all the supported exchanges with exchanges’ data (ID, name, country, …) that have active trading volumes on CoinGecko |
| /exchanges/list | Query all the exchanges with ID and name |
| /exchanges/:id | Query exchange’s data (name, year established, country, …), exchange volume in BTC and tickers based on exchange’s ID |
| /exchanges/:id/tickers | Query exchange’s tickers based on exchange’s ID |
| /exchanges/:id/volume_chart | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange’s ID |
| /derivatives | Query all the tickers from derivatives exchanges on CoinGecko |
| /derivatives/exchanges | Query all the derivatives exchanges with related data (ID, name, open interest, …) on CoinGecko |
| /derivatives/exchanges/:id | Query the derivatives exchange’s related data (ID, name, open interest, …) based on the exchange’s ID |
| /derivatives/exchanges/list | Query all the derivatives exchanges with ID and name on CoinGecko |
CoinGecko Endpoints: Public Treasuries
| Endpoint | Description |
|---|
| /entities/list | Query all the supported entities on CoinGecko with entity ID, name, symbol, and country |
| /:entity/public_treasury/:coin_id | Query public companies & governments’ cryptocurrency holdings by coin ID |
| /public_treasury/:entity_id | Query public companies & governments’ cryptocurrency holdings by entity ID |
| /public_treasury/:entity_id/…/holding_chart | Query public companies & governments’ cryptocurrency historical holdings by entity ID and coin ID |
| /public_treasury/:entity_id/transaction_history | Query public companies & governments’ cryptocurrency transaction history by entity ID |
CoinGecko Endpoints: General
| Endpoint | Description |
|---|
| /asset_platforms | Query all the asset platforms (blockchain networks) on CoinGecko |
| /exchange_rates | Query BTC exchange rates with other currencies |
| /search | Search for coins, categories and markets listed on CoinGecko |
| /search/trending | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours |
| /global | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap, etc. |
| /global/decentralized_finance_defi | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume |
2. Onchain & DEX Data (GeckoTerminal)
For real-time data on decentralized exchanges, liquidity pools, and specific token mints across 250+ networks, use the Onchain /networks/ endpoints below.
Usage Protocol
- Endpoint URL: Use the geckoterminal v2 public root instead of the pro or coingecko root.
- ❌
https://pro-api.coingecko.com/api/v3/onchain
- ❌
https://api.coingecko.com/api/v3/onchain
- ✅
https://api.geckoterminal.com/api/v2
Example Request:
- Get the latest trending pools and tokens (price, liquidity, volume, etc) on blockchain network, e.g. Solana.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/networks/solana/trending_pools' \
-H 'accept: application/json'
- Get the newest pools and tokens across all blockchain networks.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/networks/new_pools?include=base_token' \
-H 'accept: application/json'
- Get the live onchain DEX prices, market cap, and volume of multiple tokens.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2%2C0x6982508145454ce325ddbe47a25d4ec3d2311933?include_market_cap=true&mcap_fdv_fallback=true&include_24hr_vol=true&include_24hr_price_change=true' \
-H 'accept: application/json'
- Get the live onchain DEX prices & market data (supply, liquidity reserve, transactions, etc) of multiple tokens.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/networks/solana/tokens/multi/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN%2C2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump%2C2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv' \
-H 'accept: application/json'
- Get the OHLCV chart data of a onchain DEX pool, e.g. PEPE on Ethereum network.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/networks/eth/pools/0xa43fe16908251ee70ef74718545e4fe6c5ccec9f/ohlcv/hour?token=base&aggregate=4&limit=100¤cy=usd' \
-H 'accept: application/json'
- Get the metadata (image, links, security info, GT score, etc) of a token.
curl -X 'GET' \
'https://api.geckoterminal.com/api/v2/networks/base/tokens/0x3722264ab15a1dfce5a5af89e6547f7949a8aba3/info' \
-H 'accept: application/json'
Onchain DEX Endpoints (GeckoTerminal)
| Endpoint | Description |
|---|
| /simple/networks/../token_price/.. | Get token price based on the provided token contract address on a network |
| /networks | Query all the supported networks on GeckoTerminal |
| /networks/../dexes | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal |
| /networks/../pools/.. | Query the specific pool based on the provided network and pool address |
| /networks/../pools/multi/.. | Query multiple pools based on the provided network and pool address |
| /networks/trending_pools | Query all the trending pools across all networks on GeckoTerminal |
| /networks/../trending_pools | Query the trending pools based on the provided network |
| /networks/../pools | Query all the top pools based on the provided network |
| /networks/../dexes/../pools | Query all the top pools based on the provided network and decentralized exchange (DEX) |
| /networks/new_pools | Query all the latest pools across all networks on GeckoTerminal |
| /networks/../new_pools | Query all the latest pools based on the provided network |
| /search/pools | Search for pools on a network |
| /networks/../tokens/../pools | Query top pools based on the provided token contract address on a network |
| /networks/../tokens/.. | Query specific token data based on the provided token contract address on a network |
| /networks/../tokens/multi/.. | Query multiple tokens data based on the provided token contract addresses on a network |
| /networks/../tokens/../info | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network |
| /networks/../pools/../info | Query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network |
| /tokens/info_recently_updated | Query 100 most recently updated tokens info across all networks on GeckoTerminal |
| /networks/../pools/../ohlcv/.. | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network |
| /networks/../pools/../trades | Query the last 300 trades in the past 24 hours based on the provided pool address |
