Configuration

Environment

Target: Python 3.11+ in a virtual environment (local macOS and Ubuntu server).

Core Variables (Draft)

ENV=local|prod
LOG_LEVEL=info

POSTGRES_URL=postgresql+psycopg://user:pass@host:5432/dbname

RABBITMQ_URL=amqp://user:pass@host:5672/vhost

KALSHI_API_KEY_ID=...
KALSHI_PRIVATE_KEY_PATH=/path/to/key.pem

POLY_PRIVATE_KEY=0x...
POLY_FUNDER=0x...

DRY_RUN=1
PAUSE_EXECUTION=0

Opportunity Loop (Draft)

KALSHI_SERIES_TICKER=KXBTCD
OPPORTUNITY_INTERVAL_S=10
SPORTS_AGENT_INTERVAL_S=600

Telegram Alerts (Draft)

TELEGRAM_TOKEN=...
TELEGRAM_CHAT_ID=...
TELEGRAM_ENABLED=true

Retention (Draft)

SNAPSHOT_RETENTION_DAYS=30
RETENTION_CLEANUP_S=3600

Secrets Handling

• Keep secrets in .env for local use.
• Use server-managed secrets for prod (systemd env, Docker secrets, or vault).

Risk Limits (Draft)

MAX_POSITION_PER_MARKET=100
MAX_TOTAL_POSITION=500
MAX_DAILY_LOSS_CENTS=500000
MAX_CONSECUTIVE_ERRORS=5
COOLDOWN_SECS=60