# GeckoTerminal MCP

> GeckoTerminal tracks DeFi tokens, liquidity pools, and DEX activity across 100+ blockchains. It gives your agent real-time access to detailed metrics on millions of assets and thousands of liquidity pools, letting you monitor market health without switching tabs or querying multiple APIs.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** defi, dex-tracker, token-analytics, liquidity-pools, crypto-trading

## Description

You can connect this MCP to pull live data from the decentralized finance world. Need to know what's hot right now? You can ask it to find trending pools across specific networks, or look up new pools that just launched globally. For deep analysis, you get precise pricing and liquidity depth for any pool address. It also handles token intelligence, giving detailed metadata and market caps on any DeFi asset. Want to analyze price action? Pulling historical OHLCV data lets you chart performance over time, while accessing recent trades helps track where the big money is moving. The Vinkius catalog makes it simple: connect your preferred agent once, and this massive crypto data source is available immediately.

## Tools

### get_multiple_pools
Retrieves detailed information for a batch of specified liquidity pools.

### get_multiple_tokens
Fetches details and metadata for several requested tokens simultaneously.

### get_network
Gets all relevant data points for a specific blockchain network.

### get_ohlcv
Generates historical Open-High-Low-Close-Volume data points for any given pool.

### get_pool
Retrieves the full, current details of a single specified liquidity pool.

### get_token_info
Pulls comprehensive metadata, like market cap and contract details, for a specified token.

### get_token
Gets specific data points for an individual crypto token address.

### list_dexes
Provides a list of all decentralized exchanges operating on a specific blockchain.

### list_networks
Returns the complete, supported list of all connected blockchain networks.

### list_top_pools_dex
Fetches a ranked list of top pools for a specific decentralized exchange.

### list_top_pools_for_token
Identifies the highest liquidity pools associated with a particular token.

### list_top_pools_network
Gets a ranked list of top performing pools on an entire network.

### list_trades
Retrieves the most recent trade records for analysis on a specific pool.

### get_new_pools_all
Lists pools that have recently launched across every supported network.

### get_new_pools_network
Checks for newly created liquidity pools limited to a single, chosen network.

### get_trending_pools_all
Identifies the most active or popular pools across all connected networks.

### get_trending_pools_network
Lists trending liquidity pools confined to a single, designated network.

## Prompt Examples

**Prompt:** 
```
List all supported blockchain networks on GeckoTerminal.
```

**Response:** 
```
I've retrieved the list of supported networks. GeckoTerminal currently supports over 100 networks, including Ethereum (eth), Solana (solana), Arbitrum (arbitrum), and Polygon (polygon_pos). Which network would you like to explore?
```

**Prompt:** 
```
Show me the trending pools on the Ethereum network.
```

**Response:** 
```
Fetching trending pools on Ethereum... I found several active pools. The top trending ones include PEPE/WETH on Uniswap V3 and USDC/WETH. Would you like detailed analytics for any of these specific pools?
```

**Prompt:** 
```
Get token information for the contract address 0x... on Ethereum.
```

**Response:** 
```
Analyzing token data... For the provided address on Ethereum, the token is identified as 'ExampleToken' (EXT). It has a current market cap of $5M and is traded primarily on Uniswap. Would you like to see the top liquidity pools for this token?
```

## Capabilities

### Map Blockchain Infrastructure
List all supported networks and decentralized exchanges operating on them.

### Track Pool Activity
Identify trending or newly launched liquidity pools across multiple chains.

### Analyze Liquidity Depth
Get granular details, including pricing and 24-hour volume, for a specific pool address.

### Verify Token Details
Retrieve detailed metadata, contract information, and market capitalization for any DeFi token.

### Model Price Changes
Access historical OHLCV data or recent trade logs to analyze price movements.

## Use Cases

### Determining liquidity risk for a new asset.
A developer needs to know if 'MegaCoin' is viable. They ask their agent to use `get_token_info` to check its market cap, and then use `list_top_pools_for_token` to see which existing pools give it the most liquidity cushion.

### Comparing performance across chains.
A trader wants to know if ETH or SOL is better for stablecoin pairs. They ask their agent to run `list_top_pools_network` on both networks and then use `get_multiple_pools` to compare the depth of three key pools.

### Analyzing a specific market failure.
The team suspects an exploit. They ask the agent to use `list_trades` on the relevant pool, cross-reference it with `get_ohlcv`, and check if any new suspicious activity appeared using `get_new_pools_network`.

## Benefits

- Instantly track global market activity: Use `get_trending_pools_all` to see what's gaining traction across every major chain, instead of checking dashboards manually.
- Deep dive on asset health: Get full token metadata using `get_token_info`, verifying contract details and current market cap before any trade.
- Model price action accurately: Running `get_ohlcv` provides historical data points necessary for charting or building predictive models, which is better than guessing based on a single snapshot.
- Scope the ecosystem quickly: Use `list_networks` and `list_dexes` to map out exactly what infrastructure exists on any given blockchain without manual research.
- Track money flow: Pulling recent trades via `list_trades` lets you analyze whale movement patterns or gauge immediate retail interest in a pool.

## How It Works

The bottom line is that you tell your agent what you want; it handles the complex network calls and delivers structured crypto data.

1. Subscribe to this MCP and provide your API key (if required for high usage limits).
2. Instruct your agent to scope the problem by listing supported networks or specific DEXes.
3. Request the desired data—whether it's historical price movement, token metadata, or a list of top pools.

## Frequently Asked Questions

**How do I check which blockchains this MCP supports? (list_networks)**
Running `list_networks` gives you a definitive list of all connected blockchain networks. This is the first step to scoping any cross-chain analysis.

**Can I find out what tokens are trending across all chains? (get_trending_pools_all)**
Yes, `get_trending_pools_all` gathers the most active pools from every network. It's much faster than checking each chain individually.

**How do I get historical price data for a pool? (get_ohlcv)**
`get_ohlcv` generates Open-High-Low-Close-Volume data points. This allows you to chart the exact performance of any specific liquidity pool over time.

**What is the best way to analyze token risk? (get_token_info)**
`get_token_info` provides crucial metadata, like contract details and market cap. This lets you assess the underlying asset's stability before diving into pool metrics.

**If I want to analyze recent whale movements for a pool, how do I use `list_trades`?**
It retrieves the most recent transactions associated with a specific liquidity pool. This lets you track real-time activity and see exactly when large amounts of tokens are moving in or out.

**What is the purpose of `list_dexes` if I want to map out all available exchanges on a network?**
This function lists every decentralized exchange (DEX) operating within a selected blockchain. Use it when you need an overview of the entire market structure, not just the major players.

**When checking many token contracts, how do I use `get_multiple_tokens` for efficiency?**
It lets you fetch data and metadata for a list of tokens simultaneously. This is faster than querying each contract individually, which saves time when analyzing large batches of assets.

**How do I use `list_top_pools_network` to find the best performing pools on a chain?**
This tool aggregates and returns the highest-performing liquidity pools across an entire network. It helps you quickly compare top assets without having to check multiple individual addresses.

**Can I see the trending liquidity pools on a specific network like Solana?**
Yes! Use the `get_trending_pools_network` tool with the network ID 'solana'. The agent will return a list of the most active pools currently trending on that blockchain.

**How do I get historical price data (OHLCV) for a specific token pool?**
You can use the `get_ohlcv` tool. Provide the network ID and the pool address to retrieve historical open, high, low, close, and volume data for various timeframes.

**Is it possible to list the most recent trades for a pair?**
Absolutely. Use the `list_trades` tool with the network ID and pool address. It will fetch the latest transaction history, including trade size and timestamps.