Solana Coin Indexing Backend

A fast and scalable backend service for indexing new and updated tokens on the Solana blockchain. Includes a RESTful API with Swagger documentation and Telegram integration for real-time notifications.

✨ Features

• ✅ Index new token mints and metadata
• 🔁 Monitor for token updates (price, liquidity, holders, etc.)
• 📬 Send Telegram alerts for new token listings
• 📘 Swagger UI for API documentation
• 🛠️ Written in Node.js / TypeScript
• ⚡ PostgreSQL or Redis for persistent storage

---

📦 Tech Stack

• Solana Web3.js
• Node.js / Express
• Redis
• Swagge
• Telegram Bot API

---

🚀 Getting Started

Prerequisites

• Node.js ≥ 18
• Redis
• A Telegram Bot Token (from @BotFather)
• A Telegram Chat ID (group or user)

Clone the Repo

git clone https://github.com/vvizardev/coin-indexing-app-backend.git

Install Dependencies

npm install

Environment Variables

Create a .env file:

SOLANA_TRACKER_API_KEY=
PORT=
BOT_TOKEN=
CHANNEL_HANDLE=
BOT_NAME=
API_URL=

Run the Indexer

npm run start
# or
cargo run

---

🧠 How It Works

1. Connects to the Solana RPC and scans for new token mints.
2. Fetches metadata using Metaplex or TokenList.
3. Stores tokens in PostgreSQL or Redis.
4. Sends Telegram messages when criteria match.
5. Exposes an API to retrieve token data via REST.

---

📘 API Documentation

After running the server, visit:

http://localhost:3000

Here you’ll find Swagger UI with full documentation.

---

🔔 Telegram Notifications

Example message sent to Telegram:

🚀 New Token Detected!
Name: Banana Coin 🍌
Mint: F5vA...DxP
Symbol: BANANA

Customize filters in src/indexer/filter.ts to reduce spam.

---

📡 API Endpoints

🔥 Trending

• Trending SOL Pools
  GET /api/v1/trending
  Get trending SOL pools

• Trending Tokens (Tracker)
  GET /api/v1/tracker/trending
  Get trending tokens from tracker

---

📈 Token Lists (Tracker)

• Tokens by Volume
  GET /api/v1/tracker/tokens/volume
  Get tokens sorted by trading volume

• Tokens by Multi
  GET /api/v1/tracker/tokens/multi
  Get tokens by multi-metric logic

• Latest Tokens
  GET /api/v1/tracker/tokens/latest
  Get the most recently listed tokens

• Graduated Tokens
  GET /api/v1/tracker/tokens/graduated
  Get tokens that have graduated from tracker status

---

🔍 Token Details (Tracker)

• Get Token Details
  GET /api/v1/tracker/tokens/{tokenAddress}
  Fetch token details by its address

---

🧪 Test

npm run test

---

🛡️ Production

Use Docker:

docker build -t solana-indexer .
docker run --env-file .env -p 3000:3000 solana-indexer

---

🙌 Contributing

PRs welcome! Please open an issue first to discuss any major changes.

---

📄 License

MIT © 2025 @vvizardev

---

📬 Contact

• Telegram: @vvizardev
• Twitter: @wizardev_sol