DEX Agentic Bot

A blockchain-agnostic CLI tool for querying token and pool information across DEXs. Powered by Gemini AI and MCP servers for DexScreener and DexPaprika.

Features

• 🤖 Agentic Mode - Gemini AI decides which tools to call based on your query
• 🔗 Blockchain Agnostic - Works with Ethereum, Base, Solana, Arbitrum, and more
• 📊 Table Output - Results displayed in clean, formatted tables
• 💬 Interactive Mode - REPL with conversation memory

Quick Start

Installation

./scripts/install.sh

Configuration

Create a .env file (copy from .env.example):

GEMINI_API_KEY=your-key-here
GEMINI_MODEL=gemini-2.5-flash

# MCP Server commands
MCP_DEXSCREENER_CMD=npx @mcp-dexscreener/server
MCP_DEXPAPRIKA_CMD=npx dexpaprika-mcp

Usage

# Single query
./scripts/start.sh "search for PEPE on ethereum"

# Interactive mode
./scripts/start.sh --interactive

# JSON output for scripting
./scripts/start.sh --output json "top pools on base"

Example Queries

Query	Description
search for PEPE	Search tokens by name/symbol
trending tokens	Get latest trending tokens
top pools on base	Top pools by volume on Base
new pools on ethereum	Recently created pools
token info for 0x...	Get info for specific token

CLI Options

Option	Description
-i, --interactive	Start interactive REPL mode
-o, --output {text,json,table}	Output format (default: table)
-v, --verbose	Show debug information
--stdin	Read query from stdin

Interactive Commands

Command	Description
/quit	Exit the CLI
/clear	Clear conversation context
/context	View stored tokens
/help	Show available commands

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        User Query (CLI)                     │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                    Gemini Agentic Agent                     │
│  - Analyzes user query                                      │
│  - Selects tools dynamically                                │
│  - Multi-turn reasoning                                     │
│  - Table-formatted responses                                │
└─────────────────────────┬───────────────────────────────────┘
                          │
          ┌───────────────┴───────────────┐
          ▼                               ▼
┌─────────────────┐             ┌─────────────────┐
│   DexScreener   │             │   DexPaprika    │
│     (MCP)       │             │     (MCP)       │
├─────────────────┤             ├─────────────────┤
│ • searchPairs   │             │ • getNetworkPools│
│ • getTrending   │             │ • getPoolDetails │
│ • getTokenInfo  │             │ • getNetworks    │
└─────────────────┘             └─────────────────┘

Development

# Activate virtual environment
source .venv/bin/activate

# Run tests
pytest

# Run the CLI directly
python -m app "your query"

License

MIT