PumpKit

Open-source framework for building PumpFun Telegram bots on Solana. Claim monitors, channel feeds, group trackers, whale alerts — build your own or use ours.

What is PumpKit?

PumpKit is a TypeScript framework and collection of production-ready bots for monitoring PumpFun activity on Solana via Telegram. It provides:

• @pumpkit/core — Shared framework: bot scaffolding, Solana monitoring, formatters, storage, config, health checks
• @pumpkit/monitor — All-in-one monitoring bot (fee claims, launches, graduations, whale trades, CTO alerts)
• @pumpkit/tracker — Group call-tracking bot (leaderboards, PNL cards, rankings, multi-chain)

Why PumpKit?

Claim bots and PumpFun monitors are some of the most popular Telegram bots in crypto. But every builder starts from scratch — writing the same grammy setup, Solana RPC connections, message formatters, and deployment configs.

PumpKit gives you production-tested building blocks so you can ship a bot in hours, not weeks.

Architecture

┌───────────────────────────────────────────────────┐
│                  @pumpkit/core                    │
│                                                   │
│  bot/       grammy scaffolding, command router    │
│  monitor/   WebSocket + HTTP event monitors       │
│  solana/    RPC client, program IDs, decoders     │
│  formatter/ HTML message builder (Telegram)       │
│  storage/   File-based + SQLite adapters          │
│  config/    Typed env loader with validation      │
│  health/    HTTP health check server              │
│  logger/    Leveled console logger                │
│  api/       REST + SSE + webhook server           │
│  social/    Twitter/X + GitHub integrations       │
│  types/     Shared event & program types          │
└──────────┬────────────────────────┬───────────────┘
           │                        │
    ┌──────▼───────┐          ┌──────▼───────┐
    │  @pumpkit/   │          │  @pumpkit/   │
    │   monitor    │          │   tracker    │
    │              │          │              │
    │ DM commands  │          │ Group calls  │
    │ Channel feed │          │ Leaderboards │
    │ REST API     │          │ PNL cards    │
    │ Webhooks     │          │ Rankings     │
    │ SSE stream   │          │ Multi-chain  │
    └──────────────┘          └──────────────┘

Quick Start

Use a pre-built bot

# Clone the repo
git clone https://github.com/pumpkit/pumpkit.git
cd pumpkit

# Install dependencies
npm install

# Configure
cp packages/monitor/.env.example packages/monitor/.env
# Edit .env with your TELEGRAM_BOT_TOKEN and SOLANA_RPC_URL

# Run the monitor bot
npm run dev --workspace=@pumpkit/monitor

Build your own bot

import { createBot, ClaimMonitor, formatClaim, createHealthServer } from '@pumpkit/core';

const bot = createBot({
  token: process.env.BOT_TOKEN!,
  commands: {
    start: (ctx) => ctx.reply('Welcome to my claim bot!'),
    help: (ctx) => ctx.reply('I monitor PumpFun fee claims.'),
  },
});

const monitor = new ClaimMonitor({
  rpcUrl: process.env.SOLANA_RPC_URL!,
  onClaim: async (event) => {
    await bot.broadcast(formatClaim(event));
  },
});

createHealthServer({ port: 3000, monitor });
monitor.start();
bot.launch();

Packages

| Package | Description | Status | |---------|-------------|--------| | @pumpkit/core | Shared framework — logger, health server, config, shutdown, types | ✅ Ready | | @pumpkit/monitor | All-in-one PumpFun monitor bot (DM + channel + API) | ✅ Ready | | @pumpkit/channel | Read-only Telegram channel feed (broadcasts token events) | ✅ Ready | | @pumpkit/claim | Fee claim tracker by token CA or X handle | ✅ Ready | | @pumpkit/tracker | Group call-tracking bot with leaderboards & PNL cards | ✅ Ready | | @pumpkit/web | Frontend dashboard and documentation site | 🏗️ Skeleton |

npm: Packages will be published to npm under the @pumpkit scope. See npm Packages for the publishing roadmap.

Live Bots

Production bots running on Telegram, powered by PumpKit:

| Bot | Link | Description | |-----|------|-------------| | PumpFun Claims | @pumpfunclaims | Channel feed — broadcasts first fee claims by GitHub-assigned developers | | Migrated PumpFun | @migratedpumpfun | Channel feed — tracks token graduations from bonding curve to PumpSwap AMM | | Cryptocurrency Vision | @cryptocurrencyvisionbot | Interactive bot — PumpFun token analytics, whale alerts, and market insights |

Features

Monitor Bot (@pumpkit/monitor)

Consolidates 3 existing production bots into one:

| Feature | Source | Description | |---------|--------|-------------| | Fee Claim Alerts | telegram-bot, claim-bot | Real-time notifications when creators claim fees | | Token Launch Monitor | telegram-bot, channel-bot | Detect new PumpFun token mints | | Graduation Alerts | telegram-bot, channel-bot | Bonding curve completion → AMM migration | | Whale Trade Alerts | telegram-bot, channel-bot | Large buy/sell above configurable threshold | | CTO Alerts | telegram-bot | Creator Takeover (fee redirection) detection | | Fee Distributions | telegram-bot, channel-bot | Fee sharing payouts to shareholders | | Channel Broadcast | channel-bot | Read-only Telegram channel feed mode | | DM Commands | telegram-bot, claim-bot | /watch, /add, /remove, /list, /status | | REST API + SSE | telegram-bot | HTTP endpoints, Server-Sent Events streaming | | Webhooks | telegram-bot | Outbound webhook dispatch for integrations | | Twitter/X Tracking | claim-bot, channel-bot | Track tokens by X handle, follower counts | | GitHub Social Fees | channel-bot | Social fee PDA lookup via GitHub |

Tracker Bot (@pumpkit/tracker)

| Feature | Description | |---------|-------------| | Call Tracking | Paste a token CA → bot registers and tracks performance | | Leaderboards | Top calls by multiplier, rankings by points (24h/7d/30d/all) | | PNL Cards | Shareable Canvas-rendered images (entry, ATH, gain) | | Ranking System | Amateur → Novice → Contender → Guru → Oracle | | Points System | -1 to +5 based on call multiplier | | Win Rate | Percentage of calls hitting ≥ 2x | | Hardcore Mode | Auto-kick below minimum win rate | | Multi-Chain | Solana, Ethereum, Base, BSC |

Hosting

| Component | Platform | Cost | |-----------|----------|------| | Monitor Bot | Railway | ~$5/mo (Hobby) | | Tracker Bot | Railway | ~$5/mo (Hobby) | | Documentation | Vercel | Free |

Tech Stack

• Runtime: Node.js 20+
• Language: TypeScript (ES modules, strict mode)
• Telegram: grammy v1.35+
• Solana: @solana/web3.js v1.98+
• Database: better-sqlite3 (tracker), file-based JSON (monitor)
• Build: tsup (library), tsc (bots)
• Monorepo: Turborepo
• Deployment: Docker + Railway

Documentation

Getting Started

• Getting Started — Setup, configuration, first bot
• Development — Local environment, commands, debugging
• Architecture — System design, module boundaries, data flow
• Deployment — Railway, Docker, Vercel setup
• FAQ — Common questions and troubleshooting

Package Docs

• Core API — @pumpkit/core module reference
• Monitor Bot — Feature spec, commands, configuration
• Tracker Bot — Feature spec, commands, configuration
• npm Packages — Package installation and usage

Pump Protocol Reference

• Protocol Overview — All 9 official protocol specs + IDLs
• Bonding Curve Math — Constant-product formula, buy/sell calculations
• Fee Tiers — Market-cap-based dynamic fee selection
• Fee Sharing — Multi-shareholder fee distribution
• Social Fees — GitHub identity-based fee sharing
• Cashback — Trader cashback opt-in system
• Token Incentives — Volume-based PUMP rewards
• Mayhem Mode — Alternate vault routing, Token2022
• Events Reference — 20+ on-chain event types
• Analytics — Price impact, graduation progress, market cap
• End-to-End Workflow — Full token lifecycle

Reference

• Glossary — Key terms and definitions
• Code Examples — Practical code samples
• Error Reference — Custom error classes and fixes
• RPC Best Practices — Provider selection, batching, rate limiting
• Performance — Benchmarks, latency, and optimization tips
• Security Guide — Crypto library rules, key management
• Troubleshooting — Common issues and solutions
• Support — Getting help, bug reports, feature requests
• Roadmap — Where PumpKit is headed

Tutorials

26 hands-on guides in tutorials/:

| Tutorial | Topic | |----------|-------| | Create Token | Launch a token on bonding curve | | Buy Tokens | Purchase tokens via bonding curve | | Sell Tokens | Sell tokens back for SOL | | Create & Buy | Atomic create + first buy | | Bonding Curve Math | Price calculation formulas | | [Migration](tutorials/