.env.example

# Copy this file to `.env` and fill in your own keys.
# `.env` is gitignored — do NOT commit your real keys.

# === Required ===

# LLM providers. The codebase routes per-agent via `config/settings.yaml`
# (e.g. `tech_analyst_model: gpt-5.4`). Either provider may be used; both
# are supported by `src/agents/base.py`. You only need keys for the
# providers your settings.yaml actually uses.
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# Alpaca brokerage. Defaults to paper trading (see config/settings.yaml:
# `alpaca.paper: true`). Get keys at https://app.alpaca.markets/paper/dashboard/overview
ALPACA_API_KEY=PK...
ALPACA_SECRET_KEY=...

# FRED economic data (free). Used by macro_analyst for VIX, treasury
# yields, Fed funds, CPI, unemployment, HY OAS. Register at
# https://fred.stlouisfed.org/docs/api/api_key.html
FRED_API_KEY=...

# === Optional (tuning knobs — leave unset for defaults) ===

# Per-LLM-call retry budget. Default 7 with full positive jitter
# (~140s worst-case window). Bump higher only if you observe sustained
# provider outages exceeding the default window.
# QUANT_AGENT_MAX_RETRIES=7