Skip to content

A Telegram bot for tracking and alerting major Solana token movements and whale activities using NestJS and Telegraf.

Notifications You must be signed in to change notification settings

iamnas/SolanaWhaleAlert

Repository files navigation

Solana Whale Alert Bot

A Telegram bot built with NestJS and Telegraf for tracking and alerting about major token movements, whale activities, and other Solana blockchain updates.

Features

  • /start - Welcome message and list of available commands
  • /top10 - Get the top 10 tokens by market cap and trading volume
  • /newlistings - Get newly listed tokens on Solana
  • /whalealerts - Receive alerts for major token movements and whale activity
  • /createwallet - Create a new wallet address on Solana
  • /tokeninfo [address] - Get detailed information about a specific token by its address
  • /help - Get a list of all available commands

Prerequisites

Before running the bot, make sure you have the following:

  • Node.js installed
  • A Telegram bot token from BotFather
  • A BirdEye API key for fetching Solana token data

Installation

  1. Clone the repository:

    git clone https://github.com/iamnas/SolanaWhaleAlert.git
    cd SolanaWhaleAlert
  2. Install the dependencies:

    npm install
  3. Set up your environment variables by creating a .env file in the root directory:

    touch .env
  4. Add the following configuration to your .env file:

    # Telegram Bot Configuration
    CHATID=your-telegram-chat-id
    TELEGRAM_TOKEN=your-telegram-bot-token
    
    # Solana and USDC Configuration
    USDC_ADDRESS=your-usdc-token-address
    THRESHOLD_AMOUNT=1000 # Set your desired threshold amount
    
    # BirdEye API Configuration
    BIRDEYE_API_KEY=your-birdeye-api-key
    BIRDEYE_URL=https://api.birdeye.so
    BIRDEYE_TOP_TOKEN_URL=https://api.birdeye.so/top-tokens
    BIRDEYE_NEW_LIST_URL=https://api.birdeye.so/new-listings
    
    # Webhook Configuration
    setWebhook=your-webhook-url
    

    Replace the placeholders with your actual values.

  5. Run the bot:

    npm run start

Usage

Once the bot is running, you can use the following commands in your Telegram chat:

  • /start: Displays a welcome message and a list of available commands.
  • /top10: Fetches the top 10 tokens by market cap and trading volume.
  • /newlistings: Retrieves newly listed tokens on Solana.
  • /whalealerts: Provides alerts for major token movements and whale activity.
  • /createwallet: Generates a new wallet address on Solana.
  • /tokeninfo [address]: Fetches detailed information about a specific token using its address.
  • /help: Lists all available commands with a brief description.

You can start using the bot by following this link: Solana Whale Alert Bot

Contributing

Feel free to submit issues or pull requests if you find bugs or have suggestions for improvements.

License

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

About

A Telegram bot for tracking and alerting major Solana token movements and whale activities using NestJS and Telegraf.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published