# Endpoint Overview

{% hint style="info" %}
The full list of Public API endpoints are listed here: <https://www.coingecko.com/en/api/documentation>

Other exclusive endpoints for paid plan users are listed on the [Exclusive Endpoints](https://coingecko-api.gitbook.io/coingecko-api-guide/exclusive-endpoints/pro-api) page.
{% endhint %}

If you're new to CoinGecko, you may want to learn more about our [methodologies](https://www.coingecko.com/en/methodology) 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**

<table><thead><tr><th width="202">Endpoint Category</th><th>Description</th></tr></thead><tbody><tr><td>/simple/*</td><td>The simplest &#x26; fastest endpoints to call the latest price of crypto assets, by id or contract address.</td></tr><tr><td>/coins/*</td><td>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).<br>More exclusive endpoints are available to discover trending coins, newly added coins and more.</td></tr><tr><td>/contract/*</td><td>Works similarly as /coins/* endpoint above , except that it is queried by contract address, instead of api id.</td></tr><tr><td>/asset_platforms</td><td>To get the full list of blockchain network supported on CoinGecko.</td></tr><tr><td>/coins/categories/*</td><td>To get the full list of categories supported by CoinGecko &#x26; its market data, as seen on <a href="https://www.coingecko.com/en/categories">Categories page</a>.</td></tr><tr><td>/nfts/* </td><td>Endpoints that return list of NFT collections on CoinGecko, and their respective floor price, market data, metadata, and historical data.</td></tr><tr><td>/exchanges/*</td><td>Endpoints that return list of exchanges on CoinGecko, and their respective market data, tickers (trading pairs), metadata, and historical data.</td></tr><tr><td>/derivatives/*</td><td>Endpoints that return list of derivative exchanges on CoinGecko, and their respective market data, tickers (trading pairs), and metadata.</td></tr><tr><td>/search/*</td><td>To get query search result of coins, categories and exchanges.</td></tr><tr><td>/search/trending/*</td><td>To get the current trending search coins on CoinGecko.</td></tr><tr><td>/global/*</td><td>To get global crypto data such as current and historical global market cap</td></tr><tr><td>/companies/*</td><td>To get public companies data such as BTC and ETH treasuries</td></tr></tbody></table>

#### **Overview on interval granularity of historical data:**

{% hint style="info" %}
The data granularity (<mark style="color:green;">interval</mark>) for **market\_chart** and **market\_chart/range** endpoints is automatic and based on the <mark style="color:yellow;">date range</mark>:

* <mark style="color:yellow;">**1 day**</mark> from current time = <mark style="color:green;">**5-minutely**</mark> data
* <mark style="color:yellow;">**1 day**</mark> from anytime (except from current time) = <mark style="color:green;">**hourly**</mark> data
* <mark style="color:yellow;">**2-90 days**</mark> from current time or anytime = <mark style="color:green;">**hourly**</mark> data
* <mark style="color:yellow;">**above 90 days**</mark> from current time or anytime = <mark style="color:green;">**daily**</mark> data (00:00 UTC)&#x20;

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

* <mark style="color:yellow;">**1-2 days**</mark> from current time = <mark style="color:green;">**30-minutely**</mark> data
* <mark style="color:yellow;">**3-30 days**</mark> from current time = <mark style="color:green;">**4-hourly**</mark> data
* <mark style="color:yellow;">**above 31 days**</mark> from current time = <mark style="color:green;">**4-daily**</mark> data
  {% endhint %}

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

<table><thead><tr><th width="182"></th><th width="131">Public</th><th width="171">Analyst/Lite/Pro</th><th>Enterprise</th></tr></thead><tbody><tr><td><strong>coins/{id}/market_chart</strong></td><td><ul><li>auto</li><li>interval=daily</li></ul></td><td><ul><li>auto</li><li>interval=daily</li></ul></td><td><ul><li>auto</li><li>interval=daily</li><li>interval=hourly (100 days)</li><li>interval=5m (10 days)</li></ul></td></tr><tr><td><strong>coins/{id}/market_chart/range</strong></td><td><ul><li>auto</li></ul></td><td><p></p><ul><li>auto</li><li>interval=daily</li></ul></td><td><ul><li>auto</li><li>interval=daily</li><li>interval=hourly (100 days)</li><li>interval=5m (10 days)</li></ul></td></tr><tr><td><strong>coins/{id}/ohlc</strong></td><td><ul><li>auto</li></ul></td><td><ul><li>auto</li><li>interval=daily (180 days)</li></ul></td><td><ul><li>auto</li><li>interval=daily (180 days)</li></ul></td></tr></tbody></table>