> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://coingecko.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://coingecko.ferndocs.com/_mcp/server.

# Best Practices

> Wonder how to use different endpoints together? This is the perfect place for you

## User Journey for CoinGecko API Endpoints

![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/docs/60fecdf-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=509cde2f1085a0102c86f391db0837b1)

### "Discovery/Navigational Endpoints"

**Examples:**

* [/coins/list](/api-reference/api-reference/coins/list/get) — can be used to query all the supported coins on CoinGecko with names, symbols and coin IDs that can be used in other endpoints.
* [/search/trending](/api-reference/api-reference/search/trending/get) — can be used to query trending search coins, categories and NFTs on CoinGecko.

### "Supporting Endpoints"

**Examples:**

* [/simple/supported\_vs\_currencies](/api-reference/api-reference/simple/supported-vs-currencies/get) — can be used to query the list of currencies for other endpoints that include parameters like `vs_currencies`, allowing you to obtain the corresponding data for those currencies.
* [/asset\_platforms](/api-reference/api-reference/asset-platforms/get) — can be used to query the list of asset platforms for other endpoints that contain parameters like `id` or `ids` (asset platforms), allowing the retrieval of corresponding data for these asset platforms.

### "Data Endpoints"

**Examples:**

* [/simple/price](/api-reference/api-reference/simple/price/get) — can be used to query the prices of coins using the unique coin IDs that can be obtained from the "Discovery/Navigational Endpoints" mentioned above.
* [/coins/](/api-reference/api-reference/coins/get-id)\{id} — can be used to query the coin data using the unique coin IDs that can be obtained from the "Discovery/Navigational Endpoints" mentioned above.

## User Journey for Onchain DEX API Endpoints (GeckoTerminal data)

![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/docs/fc38fa8-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=011c5c6d5cb8ff880eb957e528c57891)

### "Discovery/Navigational Endpoints"

**Examples:**

* [/onchain/trending\_pools](/api-reference/api-reference/onchain/networks/trending-pools/get) - can be used to query trending pools across all networks on GeckoTerminal.
* [/onchain/search/pools](/api-reference/api-reference/onchain/search/pools/get) - can be used to search for any pools on GeckoTerminal.

### "Supporting Endpoints"

**Examples:**

* [/onchain/networks-list](/api-reference/api-reference/onchain/networks/get) - can be used to query all the supported networks on GeckoTerminal.
* [/onchain/networks/](/api-reference/api-reference/onchain/networks/dexes/get)\{network}[/dexes](/api-reference/api-reference/onchain/networks/dexes/get) - can be used to query all the supported decentralized exchanges (DEXs/`dexes`) on GeckoTerminal based on network id that can be obtained from the endpoint mentioned above.

### "Data Endpoints"

**Examples:**

* [/onchain/simple/networks/](/api-reference/api-reference/onchain/simple/networks/token-price/get-addresses)\{network}[/token\_price/](/api-reference/api-reference/onchain/simple/networks/token-price/get-addresses)\{addresses} - can be used to query any token price using the token address and network id that can be obtained from the "Discovery/Navigational Endpoints" and "Supporting Endpoints" mentioned above.
* [/onchain/networks/](/api-reference/api-reference/onchain/networks/pools/get-address)\{network}[/pools/](/api-reference/api-reference/onchain/networks/pools/get-address)\{address} - can be used to query the data of a specific pool based on the pool address and network id that can be obtained from the "Discovery/Navigational Endpoints" and "Supporting Endpoints" mentioned above.

---

🔥 New: [Flexible Data Delivery Methods](/docs/guides/data-delivery-methods)

[](/docs/guides/data-delivery-methods)

Optimize your infrastructure by fetching, streaming, or pushing crypto data. You can now pull on-demand market data via REST, stream ultra-low latency live prices and trades via WebSocket, and receive automated metadata updates via Webhook.

Subscribe to our [**paid API plan**](https://www.coingecko.com/en/api/pricing) (Analyst plan & above) to access all three data delivery methods.