• LIQUIDITY
  • PRICE
  • METRICS
  • HUMAN

How to analyze token liquidity and price with your AI

Connect GeckoTerminal to your AI client to pull real-time DeFi data. Once connected, your agent handles the heavy lifting of data gathering and math.

Ask AI about this page

Short answer

How can I use my AI to check token liquidity and price?

Your AI pulls live data from GeckoTerminal to inspect liquidity pools, market caps, and price history. You get a breakdown of token health and volatility through these specific data points.

Data outcomes

What you get

The specific insights your agent produces.

LIQUIDITY

Pool depth analysis

The AI uses pool data to show how much capital is backing a token. This helps you see if a price move is backed by real depth.

PRICE

Historical trends

Your agent pulls price history to identify patterns or sudden spikes. You get a clear view of how the asset has moved over time.

METRICS

Market cap checks

The AI calculates and verifies market capitalization. This gives you the scale of the token relative to its liquidity.

HUMAN

Manual verification

You decide if the data justifies a trade. The AI provides the numbers, but you make the final call on risk.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat and the GeckoTerminal data streams.

  1. Identify the token

    The AI finds the specific token or pool you are interested in to ensure the data is accurate.

    list_top_pools_for_token

  2. Check liquidity

    It looks at the specific liquidity pools to see how much depth is available for trading.

    get_pool

  3. Pull price history

    The agent fetches historical price candles to build a timeline of the token's performance.

    get_ohlcv

  4. Summarize findings

    The AI combines the market cap and liquidity data into a single report for you.

    get_token_info

Try it

Copy these to start.

Use these prompts to trigger the data pull.

Starting points

Swap out the token names or pool addresses with the ones you are actually watching.

GeckoTerminal Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_SXdYlOpyZ8acZz2gelcL7kGVR6l16hy26p0zeECs/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — GeckoTerminal capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "geckoterminal-defi-token-tracker-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SXdYlOpyZ8acZz2gelcL7kGVR6l16hy26p0zeECs/mcp"
    }
  }
}
Copy into chat04

  • Get the market cap and liquidity for the PEPE token.

  • Show me the historical price data for the WETH/USDC pool.

  • List the top pools for the BONK token and tell me which has the most liquidity.

  • Analyze the price volatility for this token using recent OHLCV data.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect GeckoTerminal once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted and the setup is handled on our end.

Connect GeckoTerminal to your AI

FAQ

How this task behaves

  • 01

    Can the AI execute trades for me?

    No. The AI only reads data from GeckoTerminal. It cannot send transactions or interact with your wallet.

  • 02

    Does the AI update the liquidity in the pools?

    No. The AI is a read-only connection. It can only report on the current state of the pools.

  • 03

    How recent is the price data?

    The AI pulls the most recent data available through the GeckoTerminal tools.

  • 04

    Can I use this with any AI client?

    Yes, as long as the client supports the Model Context Protocol (MCP).

  • 05

    Can the AI find tokens that aren't listed on GeckoTerminal?

    No. The AI is limited to the data provided by the GeckoTerminal tools.

  • More questions about GeckoTerminal? The Connector page answers them. See everything the GeckoTerminal Connector can do

Connect GeckoTerminal to Claude, Cursor, ChatGPT & more