// DOCS

Setup & Reference

Everything needed to run the 6-agent pipeline locally against fixtures, then flip individual agents to live APIs as credentials arrive.

Quickstart

pip install -r requirements.txt
npm install
cp .env.example .env
python scripts/seed_db.py          # creates organizedmarket.db
python scripts/dev.py              # boots all 6 agents in mock mode
# another terminal:
npx wrangler pages dev dashboard   # serves /, /dashboard, /docs, /signals

Env Variables

All AGENT_*_LIVE flags default to 0. Every client has a mock and a live implementation; the flag selects which one is loaded at boot.

Variable	Purpose
`AGENT_SIGNAL_LIVE`	TastyTrade REST + DXLink WebSocket
`AGENT_POLY_LIVE`	Polymarket CLOB via py-clob-client
`AGENT_KALSHI_LIVE`	Kalshi REST w/ RSA-JWT auth
`AGENT_SENTIMENT_LIVE`	Twitter/X v2 filtered stream + NewsAPI
`OPENCLAW_URL`	Gateway URL (default `http://127.0.0.1:18789`)
`SLACK_WEBHOOK_URL` / `DISCORD_WEBHOOK_URL`	HIGH-tier alerts; blank = no-op

Going Live (one agent at a time)

Populate the credential block in .env for one agent (e.g. TastyTrade).
Flip its flag: AGENT_SIGNAL_LIVE=1.
Restart that agent only. Other five stay mocked.
Capture real payloads back into fixtures/ via scripts/record_fixture.py for reproducible dev.

Message Topics (Pydantic)

Topic	Publisher	Subscriber
`quote.update`	agent-signal	agent-correlator
`odds.update`	agent-poly, agent-kalshi	agent-correlator
`sentiment`	agent-sentiment	agent-correlator
`signal`	agent-correlator	agent-dispatcher

Confidence tiers: HIGH > 0.75 · MED 0.45–0.75 · LOW < 0.45.

Operational Checklist

Sandbox creds active, 48h validation complete
All 6 agents reporting healthy in openclaw agents status
>100 entries in signal_log; false-positive rate reviewed
TastyTrade session token refresh tested (24h expiry)
Twitter rate limits monitored (<500k tweets/month on Basic)
Lima VM snapshot before production credentials swap
Slack / Discord webhooks tested
.env and keys/ in .gitignore
CF Pages dashboard deployed; docs reviewed

OrganizedMarket surfaces signals — it does not execute trades.