Documentation for CoinGecko API V3 (Beta)

Access CoinGecko data with this API such as live pricing, historical, volume, tickers, exchanges, developer, community, and public interest.

We have integrated with over 250 exchanges and over 3000 coins and tokens.


The CoinGecko API is free and without warranty.

Link back or a mention of 'Powered by CoinGecko API' would be appreciated!


The API root endpoint is api.coingecko.com

Here are a few example calls

For more endpoints, refer to the documentation below

Resources

Coingecko

Resource Description
GET /api/v3/ping Checks API server status

Application

Resource Description
GET /api/v3/ping Checks API server status

Coins

Resource Description
GET /api/v3/coins List all coins with data (name, price, market, developer, community, etc)
GET /api/v3/coins List all supported coins id, name and symbol (no pagination required)
GET /api/v3/markets List all supported coins market data (no pagination required)
GET /api/v3/coins/:id Get current data (name, price, market, ... including exchange tickers) for a coin
GET /api/v3/coins/:id/tickers Get coin tickers (paginated to 100 items)
GET /api/v3/coins/:id/history Get historical data (name, price, market, stats) at a given date for a coin
GET /api/v3/coins/:id/market_chart Get historical market data include price, market cap, and 24h volume (granularity auto)
GET /api/v3/coins/:id/status_updates Get status updates for a given coin

Events

Resource Description
GET /api/v3/events Get Events, paginated by 100
GET /api/v3/types Get list of events types
GET /api/v3/countries Get list of events country_code

Exchange rates

Resource Description
GET /api/v3/exchange_rates Get BTC-to-Currency exchange rates

Exchanges

Resource Description
GET /api/v3/exchanges List all exchanges
GET /api/v3/exchanges/:id Get exchange volume in BTC and top 100 tickers only
GET /api/v3/exchanges/:id/tickers Get exchange tickers (paginated)
GET /api/v3/exchanges/:id/status_updates Get status updates for a given exchange
GET /api/v3/coins List all supported markets id and name (no pagination required)

Global

Resource Description
GET /api/v3/global Get cryptocurrency global data
GET /api/v3/global/coin_dominance_chart_data Get dominance chart data
GET /api/v3/global/total_market_cap_chart_data Get total_market_cap chart data (only in USD for now)
GET /api/v3/global/tree_map_chart_data Get tree map data of top 100 coins

Portfolio status updates

Resource Description
GET /api/v3/status_updates List all status_updates with data (description, category, created_at, user, user_title and pin) under user dashboard

Private

Resource Description
GET /api/v3/private/links Get current price of any cryptocurrency in any other currency that you need.

Search

Resource Description
GET /api/v3/search Search coins and exchanges

Simple

Resource Description
GET /api/v3/simple/price Get current price of any cryptocurrency in any other currency that you need.
GET /api/v3/simple/supported_vs_currencies Get list of supported_vs_currencies.

Status updates

Resource Description
GET /api/v3/status_updates List all status_updates with data (description, category, created_at, user, user_title and pin)