How imikerussell/beebots works
beebots is a paper-first OKX perpetual-futures trading experiment with three independently styled AI bees and a live dashboard. Users configure keys, risk acknowledgements and bee playbooks in Setup; the engine gathers market data, gets Jev decisions, applies code-enforced risk controls and simulates or submits orders, then records and broadcasts outcomes. The dashboard presents live decisions and equity. Opt-in Hive reporting shares paper results for a public, replay-verified leaderboard. The engine and server excerpts are partial, so the graph omits uncertain internal wiring.
Main entry points: engine.ts Trading engine · server.ts HTTP and SSE server · data.ts Market feed · setup.ts Setup service
Components 25
Setup and profiles
- Setup form
dashboard/src/Setup.tsx - Setup service
src/setup.ts - Settings
src/settings.ts
Trading engine
- Trading engine
src/engine.ts - Bee styles
src/bees/index.ts - Custom bee brain
src/bees/custom.ts - Jev decisions
src/jev.ts - Risk controls
src/risk.ts - Order execution
src/exec/executor.ts
Market and exchange
- Market feed
src/market/data.ts - Universe gates
src/market/universe.ts - Market indicators
src/market/indicators.ts - OKX public API
src/okx/public.ts - Public REST client
src/okx/rest.ts
State and events
- Trade ledger
src/ledger.ts - SQLite database
src/db.ts - Event bus
src/events.ts - HTTP and SSE server
src/server.ts
Dashboard and Hive
- Dashboard app
dashboard/src/App.tsx - Live feed hook
dashboard/src/useFeed.ts - Hive reporting
src/hive.ts
Other components
- Owner
- OpenAI
- OKX exchange
- Public leaderboard
Connections 31
- Owner → Setup form: configures
- Setup form → Setup service: submits setup
- Setup service → OpenAI: designs bees
- Setup service → Settings: saves settings
- Settings → Trading engine: configures
- Trading engine → Market feed: refreshes market
- Market feed → Universe gates: filters universe
- Market feed → Market indicators: computes stats
- Market feed → OKX public API: requests data
- OKX public API → Public REST client: uses client
- Public REST client → OKX exchange: fetches public data
- Trading engine → Bee styles: selects style
- Trading engine → Custom bee brain: loads custom brain
- Trading engine → Jev decisions: requests decision
- Trading engine → Risk controls: checks proposal
- Trading engine → Order execution: places orders
- Order execution → OKX exchange: submits orders
- Trading engine → Trade ledger: updates positions
- Trade ledger → SQLite database: persists trades
- Trading engine → SQLite database: reads and records
- Trading engine → Event bus: emits updates
- HTTP and SSE server → SQLite database: serves history
- HTTP and SSE server → Event bus: streams events
- Owner → Dashboard app: views
- Dashboard app → HTTP and SSE server: requests feed
- Dashboard app → Live feed hook: uses live feed
- Live feed hook → HTTP and SSE server: loads snapshots
- Trading engine → Hive reporting: reports paper results
- Hive reporting → Public leaderboard: shares results
- Owner → HTTP and SSE server: joins or leaves Hive
- HTTP and SSE server → Hive reporting: handles membership