An open API service indexing awesome lists of open source software.

https://github.com/mesamirh/pricepanda


https://github.com/mesamirh/pricepanda

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# Price Panda Bot 🐼

A powerful Telegram bot that provides real-time cryptocurrency price tracking, charts, alerts, and portfolio management features.

## Features 🚀

- **Real-time Price Tracking**
- Get instant price updates for any cryptocurrency
- View detailed market statistics
- Support for multiple price pairs

- **Interactive Charts 📈**
- 30-day price history visualization
- Dynamic chart generation
- Price trend indicators

- **Price Alerts 🔔**
- Set custom price targets
- Multiple alerts per user
- Instant notifications when targets are hit

- **Favorites Management ⭐**
- Save your favorite cryptocurrencies
- Quick access to frequently checked tokens
- Personalized watchlist

- **Market Data 📊**
- Market cap information
- 24h trading volume
- Supply statistics
- Price change percentages (1H, 24H, 7D, 30D)

## Installation 🛠️

1. Clone the repository:
```bash
git clone https://github.com/mesamirh/PricePanda.git
cd PricePanda
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file with your credentials:
```bash
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
CMC_API_KEY=your_coinmarketcap_api_key
```
4. Start the bot:
```bash
npm start
```

## Usage 💡

### Basic Commands

- `/start` - Initialize the bot and see welcome message
- `/help` - Display all available commands
- `/price` or `/p ` - Get current price (e.g., `/p BTC`)
- `/chart` or `/c ` - View price chart (e.g., `/c ETH`)

### Alert Commands

- `/alert ` - Set price alert (e.g., `/alert BTC 50000`)
- `/alerts` - View your active alerts
- `/delalert ` - Delete specific alert

### Favorite Commands

- `/addfav ` - Add to favorites (e.g., `/addfav BTC`)
- `/delfav ` - Remove from favorites
- `/favorites` - View your favorite list

## Dependencies 📦

- node-telegram-bot-api
- axios
- canvas
- dotenv
- node-schedule
- web3
- chart.js

## Technical Features 🔧

- Real-time data from CoinMarketCap API
- Custom chart generation using Canvas
- Persistent data storage using JSON
- Error handling and automatic reconnection
- Interactive keyboard interface
- Support for group chats

## Acknowledgments 🙏

- CoinMarketCap API for cryptocurrency data
- Telegram Bot API for messaging interface
- Node.js community for amazing packages

## Support 💪

If you encounter any issues or have questions, please open an issue in the repository.

## Disclaimer ⚠️

This bot is for informational purposes only. Cryptocurrency trading involves risk, and you should do your own research before making any investment decisions.