Solana Market Analyst AI

Demo

About

The problem it solves # Market Analyst AI A real-time Solana DEX market analysis system powered by ElizaOS AI agents and Modern.js frontend. ## 🚀 Features - **AI-Powered Analysis**: Intelligent market analysis using specialized Solana Market Analyst agent - **Real-time DEX Data**: Integration with DEXScreener API for live market data - **Interactive Charts**: GMGN real-time price charts integration - **Risk Assessment**: Automated risk scoring (1-10 scale) and opportunity detection - **Market Categories**: Hot tokens by volume, top gainers, new listings, and oversold opportunities - **Dark Theme UI**: Professional trading interface with modern glassmorphism design ## 📋 Prerequisites - [Bun](https://bun.sh/) runtime installed - Node.js 16.18+ (for compatibility) - OpenRouter API key for AI functionality ## 🛠️ Installation 1. Clone the repository: ```bash git clone <your-repo-url> cd market-analyst-AI ``` 2. Set up environment variables: ```bash cp env.md .env # Edit .env and add your OPENROUTER_API_KEY ``` 3. Install dependencies: ```bash bun install cd frontend && bun install && cd .. ``` ## 🚀 Quick Start start services manually: ### Backend (ElizaOS) ```bash elizaos dev # OR bun run dev ``` ### Frontend ```bash cd frontend bun run dev ``` ## 📍 Access Points - **Backend API**: http://localhost:3000 - **Frontend UI**: http://localhost:8080 ## 🏗️ Architecture ### Backend - ElizaOS Agent - **Character**: Solana Market Analyst (`src/market-analyst-character.ts`) - **Plugin**: market-analysis-plugin (`src/plugins/market-analysis-plugin.ts`) - **Actions**: - `ANALYZE_TOKEN` - Comprehensive token analysis with risk scoring - `FIND_HOT_TOKENS` - Discover trending tokens across categories ### Frontend - Modern.js React - **Dashboard**: Hot tokens overview with category filtering - **Boosted**: Currently promoted tokens (from DEXScreener boost API) - **High Volume**: Tokens with highest 24h trading volume - **Top Gainers**: Biggest price increases - **New Listings**: Recently launched tokens (<24h) - **Most Active**: Highest transaction count - **Token Details**: In-depth analysis with GMGN charts - **API Integration**: Direct DEXScreener API + optional AI analysis - **Dark Theme**: Professional trading interface ## 📊 Usage 1. **View Hot Tokens**: - Navigate to the dashboard at http://localhost:8080 - Browse different categories (High Volume, Top Gainers, New Listings, Oversold) - Click any token card for detailed analysis 2. **Analyze Specific Token**: - Click on any token card from dashboard - View AI-generated analysis with risk score - Check real-time price chart from GMGN - Review opportunities and risk factors 3. **Direct Token Analysis**: - Navigate to `/token/{address}` with any Solana token address - Example: `/token/So11111111111111111111111111111111111111112` ## 🔧 Development ### Adding New Features 1. **New AI Actions**: - Edit `src/plugins/market-analysis-plugin.ts` - Add new action following the existing pattern - Update character examples if needed 2. **Frontend Components**: - Add to `frontend/src/components/` - Follow the existing dark theme styling 3. **API Endpoints**: - Modify `frontend/src/services/agent-client.ts` - Add new hooks in `frontend/src/hooks/` ## Testing ElizaOS provides a comprehensive testing structure for projects: ### Test Structure - **Component Tests** (`__tests__/` directory): - **Unit Tests**: Test individual functions and components in isolation - **Integration Tests**: Test how components work together - Run with: `elizaos test component` - **End-to-End Tests** (`e2e/` directory): - Test the project within a full ElizaOS runtime - Run with: `elizaos test e2e` - **Running All Tests**: - `elizaos test` runs both component and e2e tests ### Writing Tests Component tests use Vitest: ```typescript // Unit test example (__tests__/config.test.ts) describe('Configuration', () => { it('should load configuration correctly', () => { expect(config.debug).toBeDefined(); }); }); // Integration test example (__tests__/integration.test.ts) describe('Integration: Plugin with Character', () => { it('should initialize character with plugins', async () => { // Test interactions between components }); }); ``` E2E tests use ElizaOS test interface: ```typescript // E2E test example (e2e/project.test.ts) export class ProjectTestSuite implements TestSuite { name = 'project_test_suite'; tests = [ { name: 'project_initialization', fn: async (runtime) => { // Test project in a real runtime }, }, ]; } export default new ProjectTestSuite(); ``` The test utilities in `__tests__/utils/` provide helper functions to simplify writing tests. ## Configuration ### Market Analyst Configuration: - `src/market-analyst-character.ts` - AI agent personality and behavior - `src/plugins/market-an