Production-ready Solana risk dashboard with proprietary 12-point Omniverse Math
This is a complete institutional-grade trading terminal built on top of BlockForecast v1's proprietary 12-point matrix engine.
- Live Market Ticker - Real-time price, volume, liquidity, mcap, holders
- Live Trades Feed - Animated trade history with timestamps
- Hot Tokens Widget - Trending tokens right now
- Gainers Leaderboard - Top performers ranked
- Enhanced Panels - Top Traders, Pools, Pairs all with 2-second polling
- Central hub with real-time stats
- 3-column layout (Hot Tokens | Trades | Gainers)
- Live clock and system status
- Professional dark theme (axiom.trade level)
- Automatic BitQuery → BirdEye failover
- Zero code changes to upgrade BitQuery later
- Graceful degradation (always shows something)
- Production-ready redundancy
- Node.js 18+
- npm 9+
# 1. Install dependencies
npm install
# 2. Build production bundle
npm run build
# 3. Start server
npx tsx server.ts
# or with PM2:
pm2 start server.ts --name blockforecast
# 4. Open browser
# http://localhost:9001BlockForecast v2.0
├── Frontend (React 18 + TypeScript)
│ ├── Dashboard View (main hub)
│ ├── Token Detail Page (live analysis)
│ ├── Live Components (6 new)
│ └── Ghost Mode Trading (paper trading)
│
├── Backend (Node.js + Express)
│ ├── 12-Point Matrix Engine (scoring)
│ ├── Tri-Node Radar (data collection)
│ ├── Fallback System (reliability)
│ └── WebSocket Broadcaster (real-time)
│
└── Data Sources
├── BirdEye (primary: trending tokens)
├── BitQuery (fallback: DEX data)
└── Helius + DexScreener (supporting)
| Component | Interval |
|---|---|
| Market Ticker | 2 seconds |
| Top Traders Panel | 2 seconds |
| Pools Panel | 2 seconds |
| Pairs Panel | 2 seconds |
| Hot Tokens Widget | 5 seconds |
| Gainers Leaderboard | 5 seconds |
| Trades Feed | 1 second |
| Dashboard Stats | 5 seconds |
| Real-time Clock | 1 second |
All endpoints support 2-second polling with automatic fallback:
GET /api/token/:mint/top-traders → Top traders by volume
GET /api/token/:mint/pools → Liquidity pools
GET /api/token/:mint/pairs → Trading pairs
GET /api/token/:mint/market-data → Live price/volume/liquidity
GET /api/trades/live → Recent trades feed
GET /api/tokens/hot → Trending tokens
GET /api/tokens/gainers → Top gainers leaderboard
Default configuration (BitQuery unavailable):
USE_BITQUERY_DEX=falseWhen BitQuery is upgraded:
USE_BITQUERY_DEX=trueHow it works:
- User requests data
- System tries BitQuery first (if enabled)
- If BitQuery fails → fallback to BirdEye
- If both fail → graceful degradation
- Zero user impact either way
src/components/
├── LiveMarketTicker.tsx (6 live metrics)
├── LiveTradesFeed.tsx (animated trades)
├── HotTokensWidget.tsx (trending tokens)
├── GainersLeaderboard.tsx (top performers)
└── [Enhanced panels with polling]
src/views/
└── DashboardView.tsx (main hub)
/
├── ARCHITECTURE.md (investor pitch)
├── DEPLOYMENT_CHECKLIST.md (launch guide)
└── DELIVERY_SUMMARY.txt (this work)
intelligence.ts (+3 wrapper functions)
server.ts (+7 endpoints)
src/components/TopTradersPanel.tsx (live polling + animations)
src/components/PoolsPanel.tsx (live polling + animations)
src/components/PairsPanel.tsx (live polling + animations)
src/pages/TokenPage.tsx (new tabs + ticker)
src/App.tsx (dashboard route)
.env (+2 config keys)
- ✅ 12-Point Omniverse Math Matrix
- ✅ Tri-Node Radar System
- ✅ Bucketing (Live/Watchlist/Graveyard)
- ✅ Ghost Mode Paper Trading
- ✅ DeepSeek AI Research Agent
- ✅ DeepChain Forensics
- ✅ Cinematic Login
- ✅ Real-time dashboard
- ✅ Live market ticker
- ✅ Trade feed with animations
- ✅ Trending tokens widget
- ✅ Gainers leaderboard
- ✅ 2-second polling on all data
- ✅ Professional UI (axiom.trade level)
- ✅ Fallback system (BitQuery → BirdEye)
Professional dark institutional theme:
- Primary: Blue (#526FFF) - Info
- Success: Green (#2FE3AC) - Safe/Positive
- Danger: Red (#EC397A) - Danger/Rug
- Warning: Orange (#E78C19) - Caution
- Text: White (#FCFCFC) / Gray (#777A8C)
- Background: Dark gray (#06070B) / Near-black (#0A0C0F)
All animations are smooth and professional (pulse, scale, shadow effects).
- Real-time clock (1-second updates)
- Network status indicator
- Connection status badge
- Total Tokens Scanned (live counter)
- Safe Entries (Watchlist count)
- High Risk (Live count)
- Rug Detected (Graveyard count)
- Hot Tokens - Trending right now
- Live Trades - Recent paper trades with timestamps
- Top Gainers - Best performers ranked
- Data source indicator (BirdEye + BitQuery)
- Update frequency (2 seconds)
- System status (All Systems Operational)
- ✅ No hardcoded secrets
- ✅ All API keys in .env
- ✅ WebSocket validated
- ✅ CORS configured
- ✅ Rate limits respected
- ✅ Error handling robust
Problem: Solana has 20K tokens daily. 95% are scams.
Solution: BlockForecast uses proprietary 12-point Omniverse Math to identify legitimate tokens.
Differentiators:
- Proprietary matrix (your edge)
- 3 independent data sources
- Automatic fallback system
- Paper trading simulator
- AI research agent
- Institutional-grade UI
- Production ready
Market: $50B Solana, $500M/day lost to scams
Business Model:
- Free: 5 tokens/day
- Pro: $99/mo
- Institutional: $999/mo
See ARCHITECTURE.md for full pitch document.
npm install
npm run build
npm run dev # Vite dev servernpm install
npm run build
pm2 start server.ts --name blockforecast
pm2 startup
pm2 savePORT=9001
NODE_ENV=production
BIRDEYE_API_KEY=your_key_here
BITQUERY_API_KEY=your_key_here
HELIUS_API_KEY=your_key_here
DEEPSEEK_API_KEY=your_key_here
USE_BITQUERY_DEX=false
POLLING_INTERVAL=2000- ARCHITECTURE.md - Complete system design + investor pitch
- DEPLOYMENT_CHECKLIST.md - Pre-launch verification
- DELIVERY_SUMMARY.txt - What was built and why
- README_V2.md - This file (quick reference)
- All 12-point matrix features preserved
- Tri-Node Radar operational
- Real-time data polling (2s intervals)
- Fallback system tested
- Production build verified
- No TypeScript errors
- Professional UI implemented
- Documentation complete
- Zero feature loss
- Ready to pitch
npm install && npm run buildpm2 start server.ts- Visit http://localhost:9001
- Authenticate and explore dashboard
- Read ARCHITECTURE.md (sets context)
- Demo the dashboard (shows execution)
- Explain 12-point matrix (shows IP)
- Discuss market opportunity
- Request funding
- Monitor CPU/memory usage
- Optimize database indexes
- Plan for 1K+ concurrent users
- Load test with k6 or Artillery
- Set up CDN for static assets
Your proprietary risk scoring algorithm:
- Mint authority check
- Freeze authority check
- Liquidity drain detection
- Sybil airdrop detection
- Whale monopoly check
- Creator hoarding check
- Wash trading detection
- Developer dump detection
- Fake renouncement detection
- Social presence check
- Sniper concentration check
- Obfuscated data detection
Score: 0-39 (Safe) | 40-79 (Risk) | 80-100 (Rug)
Three independent data sources:
- BitQuery - Top 30 Pump.fun tokens
- BirdEye - Trending tokens ($1k+ liquidity)
- DexScreener - Paid profiles & boosts
Automatic failover ensures reliability:
- Primary: BirdEye (fully operational)
- Secondary: BitQuery (when upgraded)
- No user-facing errors (graceful degradation)
Paper trading simulator:
- Start with 100 SOL virtual balance
- Execute unlimited trades
- Test strategies without real money
- Track performance metrics
✅ Professional execution ✅ Institutional UI ✅ Real-time data ✅ Fallback redundancy ✅ Complete documentation ✅ Zero feature loss ✅ Ready to deploy
This is a $1-10M company.
# Clear node_modules and rebuild
rm -rf node_modules package-lock.json
npm install
npm run build# Check logs
pm2 logs blockforecast
# Restart
pm2 restart blockforecast# Use BirdEye (default)
USE_BITQUERY_DEX=false
# Use BitQuery when upgraded
USE_BITQUERY_DEX=trueBlockForecast v2.0 © 2026 | All Rights Reserved
Built with production-grade architecture. Ready for institutional deployment.
BlockForecast: Institutional-Grade Solana Risk Dashboard
Where legitimate opportunities meet institutional rigor.
🚀