• MONITOR
  • VERIFY
  • WATCH
  • HUMAN

How to track onchain liquidity and trades with your AI

Connect once to give your agent access to GeckoTerminal. From there, you can monitor pools and trade flows through simple chat commands.

Ask AI about this page

Short answer

How can I track onchain liquidity and trades with my AI?

Connect the CoinGecko MCP to your AI client to pull live data from GeckoTerminal. Your agent can then inspect specific tokens, monitor liquidity in pools, and watch real-time DEX trades. This setup gives you a direct view of onchain activity.

The outcomes.

What you get from the data.

Your agent turns raw onchain data into clear information.

MONITOR

Live pool tracking

The AI pulls liquidity stats from specific DEX pools. You get a clear view of depth and volume without manual searching.

VERIFY

Token data checks

Your agent fetches contract and token details. This helps you confirm exactly what you are looking at before you act.

WATCH

Real-time trade flow

The AI tracks recent swaps in a pool. You can see large moves or sudden activity as it happens.

HUMAN

Manual decisions

The AI provides the data, but you make the calls. It cannot execute trades or move money for you.

The workflow

What your AI does when the data arrives.

Your agent acts as the bridge between GeckoTerminal and your chat window.

  1. Identify the asset

    The AI finds the specific token you want to investigate on various DEXs.

    get_onchain_token

  2. Locate the pool

    It finds the exact liquidity pool where the token is being traded.

    get_onchain_pool

  3. Watch the flow

    The agent pulls the latest transaction history from the identified pool.

    get_onchain_pool_trades

  4. Map the landscape

    It can list available decentralized exchanges to see where liquidity lives.

    list_onchain_dexes

Try it

Copy these to start.

Use these prompts to kick off your research.

Starting points

Swap the token addresses and pool IDs for the ones you are actually watching.

CoinGecko Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_EsobUpDR0PAn2zJIeSY6RL7zGeSLSm2b99Z8Getx/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 — CoinGecko capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "coingecko-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_EsobUpDR0PAn2zJIeSY6RL7zGeSLSm2b99Z8Getx/mcp"
    }
  }
}
Copy into chat04

  • Get the details for the token at address 0x123...

  • Show me the current liquidity in the pool at this address...

  • What are the most recent trades in this specific DEX pool?

  • List the DEXs available to see where I can find liquidity for this token.

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

Start here

Connect CoinGecko once, then ask.

Click the link to connect. Your credentials stay encrypted, and you can start asking questions immediately.

Connect CoinGecko to your AI

FAQ

How this task behaves.

  • 01

    Can my AI execute trades for me?

    No. The AI only reads and reports on liquidity and trade data. You must use your own wallet to execute transactions.

  • 02

    Can the AI change the liquidity in a pool?

    No. This MCP is read-only. It can inspect pools and trades, but it cannot add or remove liquidity.

  • 03

    How real-time is the trade data?

    The AI pulls data from GeckoTerminal, so it reflects the most recent onchain activity available through their API.

  • 04

    Can the AI see my private wallet balance?

    No. The AI only sees the public onchain data it fetches through the provided tools.

  • 05

    Does the AI delete any data?

    No. The AI only reads data from GeckoTerminal. It has no ability to delete or modify any onchain or offchain records.

  • More questions about CoinGecko? See everything the CoinGecko Connector can do

Connect CoinGecko to Claude, Cursor, ChatGPT & more