.env.example

# Observe mode is the default. Never put real credentials in this file.
EXCHANGE_ID=polymarket-us
TRADING_MODE=observe
LLM_PROVIDER=openai
# Optional for OpenAI-compatible providers; defaults to https://api.openai.com/v1
# LLM_BASE_URL=https://gateway.example/v1
LLM_MODEL=
# Optional cheaper model from the same provider/endpoint. When set, it is used
# only for catalog facet, discovery, and market-detail calls before handing the
# conversation to LLM_MODEL. Blank or omitted uses LLM_MODEL for every round.
# LLM_CATALOG_MODEL=

# For local runs, put these in the ignored .env file. In GitHub, use environment
# secrets. Never commit real values.
POLYMARKET_KEY_ID=
POLYMARKET_SECRET_KEY=
# Required only when EXCHANGE_ID=kalshi. The private key may use literal \n
# sequences when a multiline secret cannot be stored directly.
KALSHI_API_KEY_ID=
KALSHI_PRIVATE_KEY=
# Optional; only official Kalshi production/demo HTTPS endpoints are accepted.
# KALSHI_API_BASE_URL=https://external-api.kalshi.com/trade-api/v2
# KALSHI_API_BASE_URL=https://external-api.demo.kalshi.co/trade-api/v2
# Optional stable profile label for notes across exchange API-key rotation. The
# value is hashed before use and must contain only letters, digits, ., _, or -.
# AGENT_MEMORY_SCOPE=primary-agent-account
LLM_API_KEY=

# Optional deployment overlays. If omitted, MarketCaster uses the checked-in
# public reference configuration and prompt and writes beneath ./reports.
# Explicit missing or invalid files fail the cycle; they never fall back.
# MARKETCASTER_CONFIG_PATH=/path/to/deployment.json
# MARKETCASTER_DECISION_PROMPT_PATH=/path/to/decision-system.md
# MARKETCASTER_REPORT_DIR=/path/to/deployment/reports