DEX K-line (GeckoTerminal)

An MCP server that streams K-line (candlestick) data from decentralized exchanges (DEXs) to power your AI agents and workflows.

Features

• K-line Data Retrieval: Fetches OHLCV (Open, High, Low, Close, Volume) data for specified tokens on supported chains (Ethereum, Binance Smart Chain, Solana).
• Dynamic Timeframes: Supports multiple timeframes (1m, 5m, 15m, 1h, 4h, 12h, 1d) with appropriate API endpoints.
• Best Pool Selection: Automatically selects the pool with the highest liquidity for accurate data.
• Flexible End Time: Allows specifying an end time in ISO 8601 format or defaults to the current UTC time.
• Tabular Output: Formats K-line data into a clean, readable table using the tabulate library.

Installation

Prerequisites

• Python 3.10 or higher
• uv for dependency management

Setup

1. Clone the repository:

   git clone https://github.com/kukapay/dex-kline-mcp.git
   cd dex-kline-mcp
   

2. Install dependencies:

   uv sync
   

3. Installing to Claude Desktop:

   Install the server as a Claude Desktop application:

   uv run mcp install main.py --name "DEX K-line"
   

   Configuration file as a reference:

   {
      "mcpServers": {
          "DEX K-line": {
              "command": "uv",
              "args": [ "--directory", "/path/to/dex-kline-mcp", "run", "main.py" ]
          }
      }
   }
   

   Replace /path/to/dex-kline-mcp with your actual installation path.

Usage

Tool: get_kline

The server exposes a single tool, get_kline, which retrieves K-line data for a specified token.

Parameters

• chain (str): Blockchain network (e.g., eth, bsc, solana)
• address (str): Token contract address
• timeframe (str): K-line timeframe (e.g., 1m, 5m, 15m, 1h, 4h, 12h, 1d). Default: 1h
• end_time (str, optional): ISO 8601 timestamp for data end time (e.g., 2025-07-03T02:14:00Z). Default: current UTC time
• limit (int): Number of data points to return (max 1000). Default: 100

Example Prompt

Fetch the 1-hour K-line data for the token with the contract address 0xf4b385849f2e817e92bffbfb9aeb48f950ff4444 on the Binance Smart Chain (BSC).

Example Output

Pair: TOKEN/USDT

+---------------------+------------+------------+------------+------------+------------+
| Timestamp           | Open       | High       | Low        | Close      | Volume     |
+---------------------+------------+------------+------------+------------+------------+
| 2025-07-03 01:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
| 2025-07-03 00:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
+---------------------+------------+------------+------------+------------+------------+

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

Data powered by GeckoTerminal API.