How anabol21/arb_bots works
The repository spans three documented tracks: public market-data collection and storage (D), historical strategy research and simulation (M), and bot decision-making with a stub-first/private execution path (B). D collects public exchange data, validates and publishes it locally, then compacts and backs it up. M analyzes historical ticks and runs frozen gear-2.2 simulations. B turns market signals into would_send records by default; gated private WebSocket execution is a separate path. The graph preserves major documented capabilities, but several unsampled modules are represented only at directory level; their internal calls are not inferred.
Main entry points: ws_private.py Private WebSocket flow · screaner_b_o.py Spread collector · theta_trade_manager.py Theta trade manager · writer.py Parquet publisher
Components 34
D · Collection
- Spread collector
app/screaner_b_o.py - HL v2 runtime
app/hl_v2/runtime.py - Market listeners
app/hl_v2/listeners_hl.py - Lean event schema
app/schema/lean_event.py - Universe intersection
app/discovery/intersection.py - Reconnect policy
app/utils/ws_reconnect.py
D · Storage
- Parquet publisher
app/storage/writer.py - Durable spool
app/storage/spool.py - Mount state
app/storage/mount_state.py - Dataset compactor
app/storage/compactor.py - Backup transfer
app/storage/backup_transfer.py
M · Research
- Historical tick reader
research/lean_ticks_io.py - Frozen gear-2.2 policy
research/gear22_backtest/policy.py - Frozen parameters
research/gear22_backtest/params_frozen.py - Observation ledger
research/gear22_backtest/venue_ledger.py - Parameter-space analysis
research/gear22_backtest/venue_param_space.py - Gear-2 research
research/gear2_coin_overview_html.py
B · Bot
- Bot runtime
app/bot/runtime.py - Theta trade manager
app/bot/theta_trade_manager.py - Trade policy
app/policy/trade_manager.py - Would-send broker
app/bot/stub_broker.py
B · Private
- Private WebSocket flow
app/bot/private/ws_private.py - Warm session supervisor
app/bot/private/ws_warm_session.py - Send gates
app/bot/private/ws_gates.py - Order planning
app/bot/private/order_plan.py - Order signing
app/bot/private/order_sign.py - Venue configuration
app/bot/private/venue.py - Private journal
app/bot/private/journal_v1.py - WebSocket transport
app/bot/private/ws_socket.py
Other components
- Research user
- Bot operator
- Public exchanges
- Private venues
- Backup destination
Connections 31
- Public exchanges → Spread collector: send quotes
- Spread collector → Lean event schema: uses schema
app/screaner_b_o.py - Spread collector → Parquet publisher: publishes records
app/screaner_b_o.py - Spread collector → Reconnect policy: plans reconnects
app/screaner_b_o.py - HL v2 runtime → Market listeners: starts listeners
app/hl_v2/runtime.py - HL v2 runtime → Parquet publisher: builds publisher
app/hl_v2/runtime.py - HL v2 runtime → Durable spool: configures spool
app/hl_v2/runtime.py - Market listeners → Reconnect policy: uses reconnect
app/hl_v2/listeners_hl.py - Parquet publisher → Durable spool: spools failures
app/storage/writer.py - Parquet publisher → Mount state: checks mount
app/storage/writer.py - Dataset compactor → Backup transfer: feeds backup
- Backup transfer → Backup destination: transfers copy
- Research user → Historical tick reader: analyzes ticks
research/lean_ticks_io.py - Historical tick reader → Gear-2 research: supplies tick data
research/gear2_coin_overview_html.py - Historical tick reader → Observation ledger: reads ticks
research/gear22_backtest/venue_ledger.py - Frozen parameters → Frozen gear-2.2 policy: sets frozen rules
research/gear22_backtest/params_frozen.py - Frozen gear-2.2 policy → Observation ledger: guides replay
research/gear22_backtest/venue_ledger.py - Frozen gear-2.2 policy → Parameter-space analysis: evaluates frozen rules
research/gear22_backtest/venue_param_space.py - Bot operator → Bot runtime: starts bot
- Bot runtime → Theta trade manager: drives signals
app/bot/theta_trade_manager.py - Theta trade manager → Trade policy: requests decision
app/bot/theta_trade_manager.py - Theta trade manager → Would-send broker: records would-send
app/bot/theta_trade_manager.py - Theta trade manager → Private WebSocket flow: optional live send
- Private WebSocket flow → Send gates: checks gates
app/bot/private/ws_private.py - Private WebSocket flow → Order planning: builds order plan
app/bot/private/ws_private.py - Private WebSocket flow → Order signing: signs order
app/bot/private/ws_private.py - Private WebSocket flow → Venue configuration: uses venue config
app/bot/private/ws_private.py - Private WebSocket flow → Private journal: writes events
app/bot/private/ws_private.py - Private WebSocket flow → WebSocket transport: sends messages
app/bot/private/ws_private.py - Warm session supervisor → Private WebSocket flow: supervises session
app/bot/private/ws_warm_session.py - Private WebSocket flow → Private venues: trades gated