How diman4iggg/arbitrage_terminal works
Arbitrage Terminal is a read-only perpetual-market arbitrage monitor, not an execution system. Its principal workflow polls enabled exchanges and pairs, normalizes market data, calculates spreads, enriches funding context, persists results, and optionally sends cooldown-protected Telegram alerts; users inspect and configure it through a REST-backed web interface. The graph preserves documented charting and trade-watch capabilities. Several route and service implementations were not excerpted, so their connections are based on the README’s documented pipeline or capabilities rather than claims of source inspection.
Main entry points: monitoring_service.py Monitoring cycle · router.py API router · pages Dashboard and views · models.py PostgreSQL data
Components 20
Web terminal
- Web app routes
arbitrage-terminal/frontend/src/App.tsx - Dashboard and views
arbitrage-terminal/frontend/src/pages - Opportunity table
arbitrage-terminal/frontend/src/components/OpportunityTable.tsx - API client
arbitrage-terminal/frontend/src/api/client.ts
REST API
- API router
arbitrage-terminal/backend/app/api/router.py
Market monitoring
- Monitoring cycle
arbitrage-terminal/backend/app/services/monitoring_service.py - Background scheduler
arbitrage-terminal/backend/app/core/scheduler.py - Exchange adapters
arbitrage-terminal/backend/app/exchanges - Market data service
arbitrage-terminal/backend/app/services/market_data_service.py - Spread calculation
arbitrage-terminal/backend/app/services/arbitrage_service.py - Price spread strategy
arbitrage-terminal/backend/app/strategies/price_spread.py - Funding enrichment
arbitrage-terminal/backend/app/services/opportunity_funding_service.py
Persistence and settings
- Runtime settings
arbitrage-terminal/backend/app/services/settings_service.py - PostgreSQL data
arbitrage-terminal/backend/app/db/models.py - Persistence service
arbitrage-terminal/backend/app/services/persistence_service.py
Trade watches and alerts
- Trade watch service
arbitrage-terminal/backend/app/services/trade_watch_service.py - Notification service
arbitrage-terminal/backend/app/services/notification_service.py - Telegram sender
arbitrage-terminal/backend/app/notifications/telegram.py
Other components
- Terminal user
- Telegram Bot API
Connections 23
- Terminal user → Web app routes: uses
- Web app routes → Dashboard and views: routes to
arbitrage-terminal/frontend/src/App.tsx - Dashboard and views → API client: requests data
arbitrage-terminal/frontend/src/api/client.ts - Dashboard and views → Opportunity table: presents opportunities
arbitrage-terminal/frontend/src/pages/Dashboard.tsx - API client → API router: calls REST
- Background scheduler → Monitoring cycle: runs cycle
arbitrage-terminal/backend/app/core/scheduler.py - Monitoring cycle → Runtime settings: loads enabled markets
arbitrage-terminal/backend/app/services/monitoring_service.py - Monitoring cycle → Exchange adapters: fetches market data
arbitrage-terminal/backend/app/services/monitoring_service.py - Monitoring cycle → Market data service: collects tickers
arbitrage-terminal/backend/app/services/monitoring_service.py - Market data service → Exchange adapters: queries exchanges
- Monitoring cycle → Spread calculation: calculates spreads
arbitrage-terminal/backend/app/services/monitoring_service.py - Spread calculation → Price spread strategy: delegates calculation
arbitrage-terminal/backend/app/services/arbitrage_service.py - Monitoring cycle → Funding enrichment: enriches opportunities
arbitrage-terminal/backend/app/services/monitoring_service.py - Monitoring cycle → Persistence service: saves results
arbitrage-terminal/backend/app/services/monitoring_service.py - Persistence service → PostgreSQL data: writes snapshots
arbitrage-terminal/backend/app/services/persistence_service.py - Runtime settings → PostgreSQL data: reads and writes
arbitrage-terminal/backend/app/services/settings_service.py - API router → PostgreSQL data: serves persisted data
- Monitoring cycle → Trade watch service: updates watched positions
arbitrage-terminal/backend/app/services/monitoring_service.py - Monitoring cycle → Notification service: checks alerts
arbitrage-terminal/backend/app/services/monitoring_service.py - Notification service → Telegram sender: sends alerts
arbitrage-terminal/backend/app/services/notification_service.py - Telegram sender → Telegram Bot API: delivers messages
- API router → Dashboard and views: provides charts and status
- API router → Trade watch service: routes trade-watch requests