Snipe Pools Solana

This bot helps to catch brand new liquidity pools on Solana as they're being created. It watches Raydium, Meteora, Pump, and PumpSwap in real time and sends Telegram alerts when it spots qualifying SOL liquidity.

What This Bot Can Do

• Spot New Pools Instantly - Catch current Raydium, Meteora, and PumpSwap pools
• Graduation Alerts - Detect Pump.fun graduations and launchpad migrations into current AMMs
• Telegram Alerts - Get notifications right on your phone and interact with the bot through commands
• Powered by Helius - Uses Helius WebSockets and RPC for reliable blockchain data
• Simple SOL Threshold Filtering - Only alerts on pools with SOL liquidity above your configured threshold
• Smart Token Analysis - Get the full scoop on tokens and their liquidity situation

What You'll Need

• A Helius API key (the free tier is supported)
• Telegram Bot API credentials
• Python 3.11 or newer

🏁 Getting Started

1. Clone this repo
2. Create a virtual environment:

   # Create a venv
   python -m venv venv
   
   # Activate it on Mac/Linux
   source venv/bin/activate
   
   # Or on Windows
   venv\Scripts\activate

3. Set up your .env file with your Helius and Telegram credentials
4. Install dependencies:

   # Install required packages
   pip install -r requirements.txt

5. Fire it up with python main.py

The default Helius streaming mode is logs, which uses standard logsSubscribe notifications followed by selective getTransaction calls. Set monitoring.subscription_mode in config.yaml to transactions only when the Helius key has Enhanced WebSocket / transactionSubscribe access. The optional HELIUS_SUBSCRIPTION_MODE environment variable overrides the YAML value.

Environment Setup (.env file)

Create a .env file in the root directory with the following structure:

# Helius API credentials
HELIUS_API_KEY=your_helius_api_key_here

# Telegram credentials
TELEGRAM_API_ID=123456789
TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890
TELEGRAM_CHANNEL_ID_SNIPE_POOLS=-1001234567890
TELEGRAM_STRING_SESSION_SNIPE_POOLS=1AQAxxxxxx...long_string_here...xxxxxx

You'll need to:

1. Get a Helius API key from helius.xyz. The bot uses standard logsSubscribe notifications plus selective getTransaction calls, which are available on the free plan subject to its credit and rate limits.
2. Create a Telegram app at my.telegram.org to get API_ID and API_HASH
3. Generate a string session (utils/generate_session.py)

Tweaking Settings

Just pop open config.yaml to adjust trading parameters, volume thresholds, and how you want your notifications. The bot uses a simple filtering mechanism - it will only alert you about pools where the SOL liquidity exceeds your configured minimum threshold.