⚡ Bolt

Bolt is a Telegram bot for tracking meme tokens across Robinhood Chain, Solana, and BNB Chain — inspired by Robinhood-style simplicity, built for degen speed.

Live bot: @Bolt_xbot

---

What it does

Bolt surfaces trending meme coins so you can spot what's moving without jumping between dashboards, launchpads, and chain explorers.

• Multi-chain meme tracking — Solana and BNB live today; Robinhood Chain on the roadmap
• Volume-ranked leaderboards — see what's actually trading, not just what's loud on Twitter
• Launchpad-aware data — pump.fun, four.meme, and more via Birdeye Data
• Telegram-native — query from your phone in seconds

---

Supported chains

Chain	Status	Launchpads / sources
🟣 Solana	✅ Live	pump.fun, Moonshot, Raydium LaunchLab
🟡 BNB Chain	✅ Live	four.meme
🟢 Robinhood Chain	🔜 Coming	NOXA, Uniswap pools (chain ID 4663)

---

Commands

Command	Description
/start	Intro and overview
/top	Top Solana memes by 24h volume
/top bnb	Top BNB / four.meme tokens by 24h volume
/chains	List supported chains
/help	Command reference

Example output

🟣 Top Solana memes (24h volume)

1. PEPE — $2.4M cap · $890K vol · 12.3x
2. BONK — $1.1M cap · $450K vol · 4.2x
...

---

Tech stack

• Runtime: Node.js 20+
• Language: TypeScript
• Bot framework: Grammy
• Data: Birdeye Data API (meme token lists + market stats)
• Dev: tsx for fast TypeScript execution

---

Getting started

Prerequisites

• Node.js 20 or later
• A Telegram bot token from @BotFather
• A Birdeye Data API key (email verification required)

1. Clone the repo

git clone https://github.com/stewieDev/bolt.git
cd bolt

2. Install dependencies

npm install

3. Configure environment

cp .env.example .env

Edit .env:

# Required
TELEGRAM_BOT_TOKEN=your_botfather_token
BIRDEYE_API_KEY=your_birdeye_api_key

# Optional (Robinhood Chain — coming soon)
ROBINHOOD_RPC_URL=
CODEX_API_KEY=

Never commit .env or share API keys in chat. Rotate tokens if exposed.

4. Run locally

# Development (auto-reload on file changes)
npm run dev

# Production
npm start

You should see:

⚡ Bolt starting…
Bot running as @your_bot_username

Open your bot in Telegram and send /start.

---

Project structure

bolt/
├── src/
│   ├── index.ts           # Entry point
│   ├── bot/
│   │   └── index.ts       # Telegram commands (/start, /top, …)
│   ├── config/
│   │   ├── chains.ts      # Chain definitions (Solana, BNB, Robinhood)
│   │   └── env.ts         # Environment variable loading
│   ├── services/
│   │   └── birdeye.ts     # Birdeye meme token fetch + formatting
│   └── types/
│       └── token.ts       # Shared MemeToken type
├── .env.example
├── package.json
└── tsconfig.json

---

Environment variables

Variable	Required	Description
TELEGRAM_BOT_TOKEN	Yes	Token from @BotFather
BIRDEYE_API_KEY	Yes	API key from BDS dashboard → Security
ROBINHOOD_RPC_URL	No	Alchemy or other RPC for Robinhood Chain (chain ID 4663)
CODEX_API_KEY	No	Codex API for Robinhood Chain token discovery

---

Roadmap

• Solana meme leaderboard (/top)
• BNB / four.meme leaderboard (/top bnb)
• Robinhood Chain meme feed
• 100x club — filter tokens that hit 100x from launch
• Auto-alerts for new launches and graduations
• Channel / group broadcast mode

---

Scripts

Script	Description
npm run dev	Start bot with hot reload
npm start	Start bot
npm run typecheck	Run TypeScript checks

---

Disclaimer

Bolt is for informational and educational purposes only. Meme tokens are highly speculative and carry significant risk of total loss.

• Not financial advice
• Not an offer to buy or sell any asset
• Always DYOR (Do Your Own Research)

---

License

MIT