.env.example

# Options Strategy Lab — environment configuration template.
# Copy to `.env` and fill in. All settings are prefixed OSL_ (see osl/config.py).

# --- Schwab Trader API (primary provider) ---
OSL_SCHWAB_APP_KEY=your-app-key
OSL_SCHWAB_APP_SECRET=your-app-secret
OSL_SCHWAB_CALLBACK_URL=https://127.0.0.1
OSL_SCHWAB_TOKEN_PATH=.secrets/schwab_token.json

# --- Reference data ---
# Optional; only needed when OSL_RISK_FREE_CURVE_SOURCE=fred
OSL_FRED_API_KEY=

# --- Additional providers (read-only chains; optional) ---
OSL_TRADIER_TOKEN=
OSL_MARKETDATA_TOKEN=

# --- Single-user app lock (optional) ---
# sha256 hex of the app password; generate with:
#   python -c "from osl.auth import hash_password; print(hash_password('your-password'))"
OSL_APP_PASSWORD_HASH=

# --- Storage roots ---
OSL_DATA_ROOT=./data
OSL_SNAPSHOT_ROOT=./data/snapshots

# --- Risk-free curve ---
# "fred" pulls Treasury zeros from FRED; "flat" uses OSL_RISK_FREE_FLAT_RATE.
OSL_RISK_FREE_CURVE_SOURCE=flat
OSL_RISK_FREE_FLAT_RATE=0.045

# --- Provider / analytics defaults ---
OSL_DEFAULT_PROVIDER=schwab
OSL_IV_LOOKBACK_DAYS=252

# Symbols the snapshot worker captures (comma-separated).
OSL_WATCHLIST=SPY,QQQ,IWM

# Gate v2 / experimental features.
OSL_ENABLE_EXPERIMENTAL=false