How bhavyakachhadiya/btc-news works
BTC Signal Engine is a Bitcoin market-intelligence and quantitative research platform: it gathers market and contextual telemetry, computes technical signals, persists decisions, and simulates paper-trading outcomes. The main user workflow runs through the dashboard and analysis API; a cron route can also trigger analysis. The README documents backtesting and strategy research as additional capabilities. Some feature implementations and dashboard wiring are not sampled, so those connections are shown only where the tree or documentation supports them.
Main entry points: orchestrator.service.ts Analysis orchestrator · route.ts Analysis API · history.service.ts Signal history · alert-engine.service.ts Alert engine
Components 26
App and API
- Dashboard
app/dashboard/page.tsx - Analysis API
app/api/analysis/route.ts - Cron API
app/api/cron/route.ts - Signals API
app/api/signals/route.ts - Strategy API
app/api/strategies/route.ts - Alerts API
app/api/alerts/route.ts
Market Intelligence
- Market data
src/features/market/services/coingecko.service.ts - Network telemetry
src/features/network/services/mempool.service.ts - News feed
src/features/news/services/news.service.ts - Extended context
src/features/analysis/services/orchestrator.service.ts
Signal Pipeline
- Technical indicators
src/features/technical-analysis/services/technical-analysis.service.ts - Jev interpretation
src/features/jev/services/jev.service.ts - Signal engine
src/features/signal/services/signal.service.ts - Analysis orchestrator
src/features/analysis/services/orchestrator.service.ts
Research and Simulation
- Paper trading
src/features/paper-trading/services/paper-trading.service.ts - Backtesting
src/features/backtesting/services/backtest.service.ts - Strategy storage
src/features/strategy-lab/services/strategy-storage.service.ts
Persistence and Alerts
- Signal history
src/features/history/services/history.service.ts - Alert engine
src/features/alerts/services/alert-engine.service.ts - Prisma client
src/shared/database/prisma.ts
Other components
- Dashboard user
- MongoDB
- CoinGecko
- mempool.space
- RSS news sources
- TypeSafe AI
Connections 26
- Dashboard user → Dashboard: opens
- Dashboard → Analysis API: requests analysis
- Cron API → Analysis orchestrator: runs pipeline
- Analysis API → Analysis orchestrator: runs pipeline
- Signals API → Signal history: reads history
- Signals API → Analysis orchestrator: runs if empty
- Market data → CoinGecko: fetches data
- Network telemetry → mempool.space: fetches telemetry
- News feed → RSS news sources: aggregates feeds
- Analysis orchestrator → Market data: fetches market
- Analysis orchestrator → Network telemetry: fetches network
- Analysis orchestrator → News feed: fetches news
- Analysis orchestrator → Extended context: fetches context
- Analysis orchestrator → Technical indicators: calculates indicators
- Analysis orchestrator → Jev interpretation: sends context
- Jev interpretation → TypeSafe AI: requests interpretation
- Analysis orchestrator → Signal engine: builds signal
- Analysis orchestrator → Signal history: saves decision
- Analysis orchestrator → Paper trading: processes signal
- Analysis API → Alert engine: evaluates alerts
- Alerts API → Alert engine: manages alerts
- Alert engine → Dashboard user: dispatches webhook
- Signal history → Prisma client: persists decisions
- Strategy API → Strategy storage: manages strategies
- Strategy storage → Prisma client: reads and writes
- Prisma client → MongoDB: stores records