A Telegram bot for monitoring new token launches on Pump.fun in real-time. The bot allows users to set custom filters for token monitoring and sends alerts when matching tokens are found.
- Real-time monitoring of new token launches on Pump.fun
- Customizable filters for:
- Market cap (min/max)
- Liquidity (min/max)
- Number of holders (min/max)
- Developer token percentage
- Contract age
- Trading status
- Token data enrichment using Dexscreener API
- Detailed Telegram alerts with token information and relevant links
- PostgreSQL database for storing user profiles and filter settings
- Fast and responsive architecture using Fastify
- Node.js (v16 or higher)
- PostgreSQL database
- Telegram Bot Token (from @BotFather)
- Dexscreener API key
- Clone the repository:
git clone https://github.com/yourusername/heartbot-ai.git
cd heartbot-ai- Install dependencies:
npm install- Create a
.envfile in the project root with the following variables:
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
DATABASE_URL="postgresql://user:password@localhost:5432/heartbot?schema=public"
DEXSCREENER_API_KEY=your_dexscreener_api_key
PORT=3000
NODE_ENV=development- Initialize the database:
npm run prisma:generate
npm run prisma:migrate- Build and start the application:
# For development
npm run dev
# For production
npm run build
npm start- Start a chat with your bot on Telegram
- Use the following commands:
/start- Initialize the bot/setfilter- Configure your token alert filters/myfilters- View your current filters/help- Show available commands
When setting filters using /setfilter, use the following format:
/setfilter minMarketCap maxMarketCap minLiquidity maxLiquidity minHolders maxHolders maxDevTokens minContractAge tradingEnabled
Example:
/setfilter 100000 1000000 50000 500000 10 1000 5 30 true
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the ISC License.