MoodRabbitBot - Crypto Sentiment Analyzer Telegram based.
Overview
MoodRabbitBot is a chatbot in Telegram that provides live sentiment in the cryptocurrency market based on the results of Membit and SentimAI. It allows the traders, researchers, and enthusiasts to know the current sentiment in the crypto world: is it bullish, bearish, or neutral, with just a few commands in Telegram.
The project illustrates the ability of AI-based social data to drive on-demand Web3 analytics that are easy to use.
Key Features
On-the-fly crypto sentiment with Membit API.
Most popular trending topics in the market.
Telegram chat Instant replies.
Scalable, asynchronous and lightweight python backend.
Environments Secure environment variables with `.env.
System Architecture
Flow:
User → Telegram App → MoodRabbitBot → Membit API → SentimAI Data → Telegram Response
Tech Stack
| Component | Technology |
|---|---|
| Programming Language | Python |
| Framework | python-telegram-bot v20.3 |
| APIs | Membit API, SentimAI |
| Hosting | Local PC / Render (tested) |
| Libraries | requests, python-dotenv |
| Version Control | GitHub |
Installation & Setup
- Clone the repository
git clone https://github.com/Dedecoltd/MoodRabbitBot.git cd MoodRabbitBot
- Install dependencies
pip install -r requirements.txt
- Create your .env file Copy the example environment file and add your API keys:
cp .env.example .env
Inside .env, provide:
TELEGRAM_BOT_TOKEN=your_telegram_bot_token MEMBIT_API_KEY=your_membit_api_key
- Run the bot locally
python bot_test.py
Note: The bot is designed for local deployment for maximum reliability. Hosting attempts on Render (free tier) were limited by Telegram polling constraints. Local execution ensures real-time API communication during the demonstration.
- Interact via Telegram
Open Telegram and search for your bot (e.g., @MoodRabbitBot), then try the following commands:
/start
/mood
/trend
/about
/time
/help
| Command | Description |
|---|---|
/start |
Displays welcome message and usage guide |
/mood |
Fetches current crypto sentiment (Bullish/Bearish/Neutral) |
/trend |
Shows trending crypto keywords |
/about |
Explains Membit, SentimAI, and the project purpose |
/time |
Displays current UTC time for analysis reference |
/help |
Lists all available commands and their functions |
Results & Testing
Responds in under 1.5 seconds
Under user concurrent requests stable.
Autonomous API downtime error handling.
Supports Telegram mobile and desktop clients.
Example Output:
Current Market Mood: Bullish Top Trends: BTC Halving, AI Tokens, Market Recovery
Challenges & Solutions
| Challenge | Solution |
|---|---|
| API connection errors | Implemented secure token management via .env |
| Library version conflicts | Locked dependency version (python-telegram-bot==20.3) |
| Hosting difficulties | Successfully tested both local and Render deployments |
| Rate limits | Added delays and exception handling for API throttling |
Demo & Documentation
Assets: Screenshots and demo clips are available in the /assets folder.
Report: The full technical documentation is located in /docs/MoodRabbitBot_Report.pdf.
Why a Telegram Bot Was Chosen
Telegram bots have immediate worldwide access, which is ideal in crypto-natives circles. Bots are better than websites or standalone applications because they:
Zero setup for users
Real-time data delivery
Smart interoperability with AI-based APIs.
Telegram is therefore the perfect sentiment analysis tool based on Membit.
Developer
Name: Dede GitHub: @Dedecoltd Project: MoodRabbitBot — built for the Membit Half-Hackathon
References
Membit API Documentation python-telegram-bot Documentation SentimAI Platform