A Telegram bot built with NestJS and Telegraf for tracking and alerting about major token movements, whale activities, and other Solana blockchain updates.
- /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
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
-
Clone the repository:
git clone https://github.com/iamnas/SolanaWhaleAlert.git cd SolanaWhaleAlert
-
Install the dependencies:
npm install
-
Set up your environment variables by creating a
.env
file in the root directory:touch .env
-
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.
-
Run the bot:
npm run start
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
Feel free to submit issues or pull requests if you find bugs or have suggestions for improvements.
This project is licensed under the MIT License. See the LICENSE file for details.