Skip to content

betimez/cryptoedge

Repository files navigation

CryptoEdge

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.

CryptoEdge


Features

  • 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

Tech Stack

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

Getting Started

Prerequisites

  • Node.js 18+
  • PostgreSQL database

1. Clone the repo

git clone https://github.com/yourusername/cryptoedge.git
cd cryptoedge

2. Install dependencies

npm install

3. Set environment variables

Create a .env file in the project root:

DATABASE_URL=postgresql://user:password@localhost:5432/cryptoedge
GOOGLE_API_KEY=your_gemini_api_key
  • DATABASE_URL — required for search history and chat persistence
  • GOOGLE_API_KEY — required for AI analysis and chat. Get one free at Google AI Studio

4. Push the database schema

npm run db:push

5. Start the development server

npm run dev

The app runs on http://localhost:5000.


Project Structure

├── 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

Available Scripts

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

Environment Variables

Variable Required Description
DATABASE_URL Yes PostgreSQL connection string
GOOGLE_API_KEY Yes Google Gemini API key for AI features

License

MIT — see LICENSE

About

Multi-source crypto analysis dashboard with AI insights

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors