.env.example

# --- AI news context (optional) ---
# If set, a cached "🧠 News:" line explaining the move is added to alerts.
# Leave unset to run pure trend analysis with no LLM calls (and no cost).
OPENAI_API_KEY=

# Model used for the news line (default: gpt-5.6-luna, the cheapest tier).
# OPENAI_MODEL=gpt-5.6-luna

# --- Cost controls for the AI news line ---
# Master switch (default true when a key is set). Set false to disable.
# AI_EXPLAIN=true

# Only call the LLM when the day's move magnitude is at least this many percent
# (or when a trend-change alert fires). Default 3.0.
# AI_EXPLAIN_MIN_MOVE_PCT=3.0

# Within a day the explanation is cached and reused for free. It is only
# re-generated if the move flips sign or jumps by at least this many percent.
# Default 2.0. Raise it to spend less; lower it for fresher explanations.
# AI_CACHE_REFRESH_PCT=2.0