A cryptocurrency research and analysis platform. Search any token and get real-time market data, AI-generated scenario models, sentiment analysis, whale tracking, and an interactive AI chat assistant — all in a clean, dark-themed interface.
- AI Scenario Models — Bull, base, and bear case price projections with probabilities, generated by Google Gemini
- Real-time Market Data — Price, market cap, FDV, 24h volume, circulating/max/total supply via CoinGecko
- TradingView Integration — Advanced candlestick chart (EMA 50, RSI 14, volume), technical analysis widget, token profile, top stories
- Sentiment Analysis — Composite sentiment score with bull/neutral/bear breakdown
- Whale Tracking — Top holder distribution and selling pressure indicators
- AI Chat Assistant — Streaming chat powered by Gemini with persistent conversation history
- Fear & Greed Index — Live embed from Alternative.me
- Market Widgets — Heatmap, screener, economic calendar, mini charts, and ticker tape
- 60-second Auto-refresh — Market metrics update automatically with a flash animation on change
| Layer | Technology |
|---|---|
| Frontend | React 18, TypeScript, Vite |
| Styling | Tailwind CSS, shadcn/ui, Framer Motion |
| Backend | Node.js, Express.js, TypeScript |
| Database | PostgreSQL, Drizzle ORM |
| AI | Google Generative AI (Gemini 1.5 Flash) |
| Market Data | CoinGecko API, Yahoo Finance |
| Charts | TradingView Embed Widgets |
| Routing | Wouter |
| State | TanStack React Query |
- Node.js 18+
- PostgreSQL database
git clone https://github.com/yourusername/cryptoedge.git
cd cryptoedgenpm installCreate a .env file in the project root:
DATABASE_URL=postgresql://user:password@localhost:5432/cryptoedge
GOOGLE_API_KEY=your_gemini_api_keyDATABASE_URL— required for search history and chat persistenceGOOGLE_API_KEY— required for AI analysis and chat. Get one free at Google AI Studio
npm run db:pushnpm run devThe app runs on http://localhost:5000.
├── client/ # React frontend (Vite)
│ └── src/
│ ├── components/ # UI components (MetricCard, SentimentGauge, PriceChart, ...)
│ ├── hooks/ # React Query hooks + toast
│ └── pages/ # Dashboard (main page) + ChatAssistant
├── server/ # Express backend
│ ├── routes.ts # API endpoints, market data fetching, AI analysis
│ └── replit_integrations/
│ └── chat/ # Gemini SSE streaming chat routes
├── shared/ # Shared Zod schemas and route types
└── package.json
| Command | Description |
|---|---|
npm run dev |
Start dev server with hot reload (port 5000) |
npm run build |
Build for production |
npm run start |
Run the production build |
npm run db:push |
Push schema changes to the database |
| Variable | Required | Description |
|---|---|---|
DATABASE_URL |
Yes | PostgreSQL connection string |
GOOGLE_API_KEY |
Yes | Google Gemini API key for AI features |
MIT — see LICENSE
