https://github.com/apollotoday/token-index-app
✅Token indexing app🔥Real-time Solana Token Tracker API – Easily fetch trending SOL pools, top tokens by volume, latest token listings, multi-metric insights, and detailed token info by address. Perfect for DeFi dashboards, trading bots, and Web3 analytics tools built on the Solana blockchain.
https://github.com/apollotoday/token-index-app
bot index marke telegram token volume
Last synced: 9 months ago
JSON representation
✅Token indexing app🔥Real-time Solana Token Tracker API – Easily fetch trending SOL pools, top tokens by volume, latest token listings, multi-metric insights, and detailed token info by address. Perfect for DeFi dashboards, trading bots, and Web3 analytics tools built on the Solana blockchain.
- Host: GitHub
- URL: https://github.com/apollotoday/token-index-app
- Owner: apollotoday
- Created: 2025-09-18T06:40:00.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-18T06:42:49.000Z (9 months ago)
- Last Synced: 2025-09-18T08:38:16.397Z (9 months ago)
- Topics: bot, index, marke, telegram, token, volume
- Language: TypeScript
- Homepage: https://coin-indexing-app-backend.vercel.app/
- Size: 27.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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
---
[](https://coin-indexing-app-backend.vercel.app/)
## 📦 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](https://t.me/BotFather))
- A Telegram Chat ID (group or user)
### Clone the Repo
```bash
git clone https://github.com/apollotoday/coin-indexing-app-backend.git
```
### Install Dependencies
```bash
npm install
```
### Environment Variables
Create a `.env` file:
```env
SOLANA_TRACKER_API_KEY=
PORT=
BOT_TOKEN=
CHANNEL_HANDLE=
BOT_NAME=
API_URL=
```
### Run the Indexer
```bash
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
```bash
npm run test
```
---
## 🛡️ Production
Use Docker:
```bash
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 @apolllotoday
---
## 📬 Contact
- Telegram: [@web3_maxim](https://t.me/web3_maxim)