- TRADE LOGS
- POOL STATUS
- HUMAN ACTION
- TRENDS
Short answer
How can I track onchain trades with my AI?
Your AI uses GeckoTerminal to pull real-time trade logs and liquidity pool snapshots. You get a clear view of market movements and specific wallet actions. This breakdown shows how the data flows to your agent.
Market insights
What you can track
The AI pulls raw data from the blockchain and organizes it for you.
TRADE LOGS
Recent transaction history
The AI pulls the latest trades from a specific pool. You see the size, price, and direction of recent swaps.
POOL STATUS
Liquidity snapshots
Your AI checks the current state of a liquidity pool. You get the current depth and token balances instantly.
HUMAN ACTION
Manual trade execution
The AI identifies large buys or unusual volume. You decide when to enter or exit a position based on these signals.
TRENDS
Volume analysis
The AI looks at recent activity to spot shifts in momentum. You get a sense of whether a pool is heating up or cooling down.
The workflow
What your AI does when the data arrives.
The AI acts as your data layer, pulling specific onchain details from GeckoTerminal.
Locate the pool
The AI finds the specific liquidity pool you want to watch using its address.
get_poolPull trade history
The AI fetches the most recent individual transactions from that pool.
list_tradesAnalyze volume
The AI scans the trade list to identify large orders or heavy selling pressure.
list_tradesReport pool state
The AI summarizes the current liquidity and price data for the pool.
get_pool
Try it
Copy these to start.
Use these prompts to begin monitoring immediately.
Starting points
Swap the pool addresses and token names for the ones you are actually watching.
GeckoTerminal Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_SXdYlOpyZ8acZz2gelcL7kGVR6l16hy26p0zeECs/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — GeckoTerminal capabilities are ready to use.
{
"mcpServers": {
"geckoterminal-defi-token-tracker-mcp": {
"url": "https://edge.vinkius.com/vk_preview_SXdYlOpyZ8acZz2gelcL7kGVR6l16hy26p0zeECs/mcp"
}
}
}Show me the last 10 trades for the pool at 0x123...
What is the current liquidity in the USDC/WETH pool?
Check the recent activity for pool 0xabc... and tell me if there are any large sells.
Summarize the recent trade volume for the SOL/USDC pool.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Start here
Connect GeckoTerminal once, then ask.
One link connects the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.
Connect GeckoTerminal to your AIFAQ
How this task behaves
- 01
Can my AI execute trades for me?
No. The AI can only read and report on trade data. You must use your own wallet to execute any swaps or trades.
- 02
Can the AI change the liquidity in a pool?
No. This MCP is read-only. It can pull data from pools, but it cannot add or remove liquidity.
- 03
Does the AI send me alerts automatically?
No. The AI does not push notifications. You need to ask your AI client to check the data for updates.
- 04
How recent is the trade data?
The AI pulls the most recent trades available through the GeckoTerminal API when you ask for them.
- 05
Can I track any pool on any chain?
Yes, as long as the pool is supported and visible on GeckoTerminal.
More questions about GeckoTerminal? The Connector page answers them. See everything the GeckoTerminal Connector can do
Connect GeckoTerminal to Claude, Cursor, ChatGPT & more
