How idanya/algo-trader works
algo-trader is a Python strategy builder, historical backtester, and partially implemented real-time trader. Its principal workflow reads market candles, passes them through configurable processors and per-candle strategies, and can persist results or dispatch signals; pipeline terminators run after source exhaustion. The README documents historical Yahoo/Binance loading, real-time Binance input, technical indicators, and optional Interactive Brokers support. The pipeline execution and sink calls are shown in excerpts; several feature branches are documented but their runtime wiring is unsampled, so those links are omitted rather than inferred.
Main entry points: pipeline/pipeline.py Pipeline · processors Candle Processors · client.py IB API Client · cli/pipeline.py Pipeline Loading
Components 27
Market Data
- Candle Sources
src/algotrader/pipeline/sources - Market Providers
src/algotrader/market - Candle Model
src/algotrader/entities/candle.py
Pipeline Runtime
- CLI
src/algotrader/cli/main.py - Pipeline Loading
src/algotrader/cli/pipeline.py - Pipeline
src/algotrader/pipeline/pipeline.py - Pipeline Runner
src/algotrader/pipeline/runner.py - Candle Processors
src/algotrader/pipeline/processors - Shared Context
src/algotrader/pipeline/shared_context.py - Technical Analysis
src/algotrader/pipeline/processors/technicals.py - Indicator Calculations
src/algotrader/calc/technicals.py - Pipeline Terminators
src/algotrader/pipeline/terminators
Strategy Trading
- Strategy Processor
src/algotrader/pipeline/processors/strategy.py - Trading Strategies
src/algotrader/pipeline/strategies - Strategy Signals
src/algotrader/entities/strategy_signal.py - Signal Executor
src/algotrader/trade/signals_executor.py
IB Integration
- IB Connector
src/algotrader/providers/ib/interactive_brokers_connector.py - IB API Client
libs/ib_client/ibapi/client.py - IB Protocol Models
libs/ib_client/ibapi/common.py - IB Message Decoder
libs/ib_client/ibapi/decoder.py - IB Response Wrapper
libs/ib_client/ibapi/wrapper.py - IB Order Model
libs/ib_client/ibapi/order.py
Persistence
- Storage Sink
src/algotrader/pipeline/processors/storage_provider_sink.py - Storage Provider
src/algotrader/storage/storage_provider.py - MongoDB Storage
src/algotrader/storage/mongodb_storage.py - Serialization
src/algotrader/serialization/store.py
Other components
- Pipeline User
Connections 26
- Pipeline User → CLI: runs
src/algotrader/cli/main.py - CLI → Pipeline Loading: routes to
src/algotrader/cli/main.py - Pipeline Loading → Pipeline: loads
src/algotrader/cli/pipeline.py - Pipeline Loading → Pipeline Runner: runs via
src/algotrader/cli/pipeline.py - Pipeline Runner → Pipeline: runs
- Pipeline → Candle Sources: reads
src/algotrader/pipeline/pipeline.py - Pipeline → Candle Processors: processes candles
src/algotrader/pipeline/pipeline.py - Pipeline → Pipeline Terminators: terminates with
src/algotrader/pipeline/pipeline.py - Candle Sources → Candle Model: produces
- Market Providers → Candle Sources: supplies data
- Candle Processors → Shared Context: shares state
src/algotrader/pipeline/processors/storage_provider_sink.py - Candle Processors → Technical Analysis: includes
- Technical Analysis → Indicator Calculations: calculates with
src/algotrader/calc/technicals.py - Candle Processors → Strategy Processor: includes
- Strategy Processor → Trading Strategies: executes
- Trading Strategies → Strategy Signals: dispatches
- Strategy Processor → Signal Executor: passes signals
- Storage Sink → Storage Provider: saves candles
src/algotrader/pipeline/processors/storage_provider_sink.py - Storage Provider → MongoDB Storage: implemented by
src/algotrader/storage/mongodb_storage.py - Pipeline → Serialization: serializes via
src/algotrader/pipeline/pipeline.py - IB Connector → IB API Client: uses
- IB API Client → IB Protocol Models: encodes messages
libs/ib_client/ibapi/client.py - IB API Client → IB Message Decoder: decodes responses
libs/ib_client/ibapi/client.py - IB Message Decoder → IB Response Wrapper: dispatches callbacks
libs/ib_client/ibapi/decoder.py - IB API Client → IB Order Model: encodes orders
libs/ib_client/ibapi/client.py - IB Message Decoder → IB Order Model: decodes orders
libs/ib_client/ibapi/decoder.py