How binqqarenyu/kalshi-simulator works
This is a multi-asset Kalshi prediction-market trading terminal and quantitative bot platform. The principal workflow runs from live market feeds through strategy evaluation and risk authorization to paper or live order execution, followed by settlement and analytics. The README also documents a paper-trading incubator, sealed live-bot authorization, presets, and a unified terminal. Some subsystem paths and calls are supported only by the source index or README; unsampled implementation details are not inferred.
Main entry points: server.py API Server · App.tsx Terminal UI · ingestion_agent.py Market Ingestion · bot1_v4_engine.py Strategy Bots
Components 20
Unified Terminal
- Terminal UI
frontend/src/App.tsx - Baby Bot Console
frontend/src/components/BabyBotConsole.tsx - Parent Hub
frontend/src/components/ParentHub.tsx - API Server
app_2_execution_bot/server.py
Market Data
- Market Ingestion
src/kalshi_sim/ingestion_agent.py - Market Discovery
src/kalshi_sim/market_discovery.py - Order Book State
shared/schemas.py
Strategy and Simulation
- Strategy Bots
src/kalshi_sim/ml/bot1_v4_engine.py - EV Evaluation
src/kalshi_sim/ml/statistical_ev_engine.py - Paper Incubator
src/kalshi_sim/simulation_agent.py
Trade Execution
- Order API
src/kalshi_sim/routers/orders.py - Live Coordination
app_2_execution_bot/live_coordinator.py - Exchange Client
app_2_execution_bot/order_client.py
Governance and Incubation
- Deployment Auditor
app_3_autonomous_chef/bot_deployment_auditor.py - Trade Guardrails
src/kalshi_sim/agent_guardrails.py - Preset Vault
src/kalshi_sim/preset_manager.py
State and Analytics
- Trading Database
src/kalshi_sim/db/writer.py - Analytics API
src/kalshi_sim/routers/analytics.py - Settlement
src/kalshi_sim/settlement.py
Other components
- Trader
Connections 19
- Trader → Terminal UI: uses
README.md - Terminal UI → Parent Hub: renders
frontend/src/App.tsx - Terminal UI → Baby Bot Console: renders
frontend/src/App.tsx - Terminal UI → API Server: connects to
README.md - API Server → Market Ingestion: starts
app_2_execution_bot/server.py - Market Ingestion → Market Discovery: uses
src/kalshi_sim/ingestion_agent.py - Market Ingestion → Paper Incubator: uses
src/kalshi_sim/ingestion_agent.py - API Server → Order Book State: serves
README.md - API Server → Strategy Bots: coordinates
README.md - Strategy Bots → EV Evaluation: evaluates with
src/kalshi_sim/ml/bot1_v4_engine.py - API Server → Order API: routes
app_2_execution_bot/server.py - Order API → Live Coordination: coordinates
README.md - Live Coordination → Exchange Client: submits orders
README.md - API Server → Deployment Auditor: checks deployment
app_2_execution_bot/server.py - Deployment Auditor → Trade Guardrails: audits
app_3_autonomous_chef/bot_deployment_auditor.py - API Server → Preset Vault: manages presets
app_2_execution_bot/server.py - Paper Incubator → Trading Database: records trades
- API Server → Analytics API: serves
app_2_execution_bot/server.py - API Server → Settlement: syncs settlements
README.md