CoinGecko API Guide
Public API Pro APIPricing Enterprise
  • Getting Started
    • 🦎Introduction
    • πŸš€Getting Started
    • πŸ”‘Authentication
    • πŸ“”Endpoint Overview
    • πŸ§ͺBest Practices
    • πŸŽ“10-min Tutorial Guide
      • #1: Get Data by ID or Address
      • #2: Get Historical Data
      • #3: Get Exchanges & NFT Data
    • πŸ“ΌEndpoint Demo
    • πŸ”¨Common Use Cases
    • ⚠️Error & Rate Limit
  • Exclusive Endpoints
    • πŸ‘‘Pro-API
    • for Paid Plan subscribers
    • for Enterprise-plan clients
  • Others
    • πŸ’œDEX Data API
    • πŸ•Changelog
    • 🟒API Status
    • πŸ‘©β€πŸ«Tutorials (beginner-friendly)
    • πŸ’ΌCase Studies
    • πŸ•ΈοΈClients (Unofficial)
    • ❓FAQs & Useful Links
Powered by GitBook
On this page

Was this helpful?

  1. Getting Started

Endpoint Overview

PreviousAuthenticationNextBest Practices

Last updated 1 year ago

Was this helpful?

The full list of Public API endpoints are listed here:

Other exclusive endpoints for paid plan users are listed on the page.

If you're new to CoinGecko, you may want to learn more about our on how we aggregate and calculate these data: market data (price, trading volume, .. ), exchanges, trust score, and listings.

CoinGecko API is divided into the following top-level categories

Endpoint Category
Description

/simple/*

The simplest & fastest endpoints to call the latest price of crypto assets, by id or contract address.

/coins/*

Endpoints that return list of coins on CoinGecko, and their respective price, market data, historical data, and metadata (image, descriptions, links, followers, token supply info, etc). More exclusive endpoints are available to discover trending coins, newly added coins and more.

/contract/*

Works similarly as /coins/* endpoint above , except that it is queried by contract address, instead of api id.

/asset_platforms

To get the full list of blockchain network supported on CoinGecko.

/coins/categories/*

/nfts/*

Endpoints that return list of NFT collections on CoinGecko, and their respective floor price, market data, metadata, and historical data.

/exchanges/*

Endpoints that return list of exchanges on CoinGecko, and their respective market data, tickers (trading pairs), metadata, and historical data.

/derivatives/*

Endpoints that return list of derivative exchanges on CoinGecko, and their respective market data, tickers (trading pairs), and metadata.

/search/*

To get query search result of coins, categories and exchanges.

/search/trending/*

To get the current trending search coins on CoinGecko.

/global/*

To get global crypto data such as current and historical global market cap

/companies/*

To get public companies data such as BTC and ETH treasuries

Overview on interval granularity of historical data:

The data granularity (interval) for market_chart and market_chart/range endpoints is automatic and based on the date range:

  • 1 day from current time = 5-minutely data

  • 1 day from anytime (except from current time) = hourly data

  • 2-90 days from current time or anytime = hourly data

  • above 90 days from current time or anytime = daily data (00:00 UTC)

For ohlc endpoint, the data granularity is automatic and based on the date range:

  • 1-2 days from current time = 30-minutely data

  • 3-30 days from current time = 4-hourly data

  • above 31 days from current time = 4-daily data

For paid plan subscribers, you have the option to specify exclusive interval parameters to bypass auto granularity.

Public
Analyst/Lite/Pro
Enterprise

coins/{id}/market_chart

  • auto

  • interval=daily

  • auto

  • interval=daily

  • auto

  • interval=daily

  • interval=hourly (100 days)

  • interval=5m (10 days)

coins/{id}/market_chart/range

  • auto

  • auto

  • interval=daily

  • auto

  • interval=daily

  • interval=hourly (100 days)

  • interval=5m (10 days)

coins/{id}/ohlc

  • auto

  • auto

  • interval=daily (180 days)

  • auto

  • interval=daily (180 days)

To get the full list of categories supported by CoinGecko & its market data, as seen on .

πŸ“”
https://www.coingecko.com/en/api/documentation
Exclusive Endpoints
methodologies
Categories page