PumpFetch Telegram Bot Documentation

Overview

PumpFetch Telegram Bot is a professional tool designed to deliver comprehensive token data directly within Telegram. The bot automatically recognizes valid Solana contract addresses (also called mint addresses or CAs), which are exactly 44 alphanumeric characters long, and returns detailed information such as Bundle, Sniper, and Developer holdings.

It seamlessly works in private chats, groups, and channels—providing dynamic responses and automatically formatting output with dynamic links and risk/security indicators.

Architecture & Programming

The Telegram Bot is implemented in Python using python-telegram-bot v20+ and asynchronous programming. Recent improvements include:

• Input Validation: The bot now only processes messages that are exactly 44 characters long (using a regular expression) to ensure that only valid contract addresses are processed.
• Asynchronous Execution: Blocking operations such as database queries and external API calls are offloaded using asyncio.get_running_loop().run_in_executor() to keep the bot responsive.
• Dynamic Message Formatting: Responses now include dynamic links that automatically incorporate the queried contract address, along with conditional formatting for critical metrics (e.g. a red alert emoji for high bundle holdings).

The code is modular and well-structured, enabling easy maintenance and future enhancements.

Functionality & Features

• Contract Address Detection: The bot processes only messages that exactly match a 44‑character alphanumeric pattern, ensuring that only valid Solana contract addresses (mint addresses/ CAs) trigger a data query.
• Dynamic Data Response: Once a valid address is detected, the bot queries the MySQL database and external APIs to fetch token details, then returns a well‑formatted Markdown message including:
  • Token information with dynamic links (DEXSCREENER, SOLSCAN, Twitter, MEVX)
  • Detailed holdings: Bundle, Sniper, and Developer (Dev) holdings
  • Risk and security indicators with informative emojis
• Channel & Group Integration: The bot can be added to Telegram groups and channels. In these contexts, it automatically responds to each valid contract address posted.

Code & Implementation Details

The core processing function, process_mint_address(), has been updated with the following key changes:

1. Input Filtering: Uses a regular expression (/^[A-Za-z0-9]{44}$/) to verify that the incoming message is a valid contract address.
2. Asynchronous Data Fetching: Utilizes asyncio.get_running_loop().run_in_executor() to run the synchronous fetch_all_data() function without blocking the event loop.
3. Dynamic Formatting: Constructs a detailed Markdown message with dynamic links, conditional formatting (for example, highlighting high Bundle holdings with a red alert emoji), and risk level mapping.

if (!preg_match('/^[A-Za-z0-9]{44}$/', $mint_address)) {
    // Ignore messages that are not valid contract addresses.
    return;
}
      

This design ensures that only valid contract addresses trigger a data query, making the bot more efficient and reducing noise in group chats.

Deployment & Monitoring

The Telegram Bot is deployed on a dedicated Python 3 server. Continuous polling is used to receive updates, and detailed logging captures any errors or issues. The bot’s asynchronous architecture ensures high responsiveness even in high-traffic scenarios.