The problem Solana Market Analyst AI 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 runtime installed
• Node.js 16.18+ (for compatibility)
• OpenRouter API key for AI functionality

🛠️ Installation

1. Clone the repository:

git clone <your-repo-url>
cd market-analyst-AI

2. Set up environment variables:

cp env.md .env
# Edit .env and add your OPENROUTER_API_KEY

3. Install dependencies:

bun install
cd frontend && bun install && cd ..

🚀 Quick Start

start services manually:

Backend (ElizaOS)

elizaos dev
# OR
bun run dev

Frontend

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:

// 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:

// 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