Configuration

Use environment variables to control market data, alerts, risk settings, and outcome tracking.

Market Data

Controls which exchange, symbols, timeframes, and strategies are used when the scanner loads market candles. Use a US-friendly exchange ID if binance.com is geo-blocked in your region.

Variable	Purpose
`EXCHANGE_ID`	Exchange used for market data (e.g. kraken).
`EXCHANGE_API_KEY`	Exchange API key for authenticated market data access (optional).
`EXCHANGE_API_SECRET`	Exchange API secret paired with EXCHANGE_API_KEY (optional).
`SYMBOLS`	Comma-separated list of trading pairs to scan (e.g. BTC/USDT,ETH/USDT).
`TIMEFRAMES`	Comma-separated candle intervals to scan (e.g. 15m,1h,4h).
`STRATEGIES`	Strategy selector for scan and watch commands (e.g. all).

AI And Alerts

Enables AI-generated scoring and explanation output, plus Telegram or Discord delivery for final signals (approved and rejected).

Variable	Purpose
`OPENAI_API_KEY`	Enables AI scoring and explanations when provided (optional).
`OPENAI_MODEL`	OpenAI model used for signal explanations (e.g. gpt-4o-mini).
`TELEGRAM_BOT_TOKEN`	Telegram bot token for sending alerts (optional).
`TELEGRAM_CHAT_ID`	Telegram chat target for alert messages (optional).
`DISCORD_WEBHOOK_URL`	Discord webhook endpoint for alerts (optional).

Risk And Scheduling

Defines position sizing assumptions, daily signal limits, default stop/target behavior, and recurring task intervals.

Variable	Purpose
`MAX_RISK_PER_TRADE`	Fraction of account equity used as max risk per signal (e.g. 0.02 for 2%).
`ACCOUNT_EQUITY`	Account size used for suggested position sizing.
`MAX_DAILY_SIGNALS`	Maximum approved signals allowed per day.
`DEFAULT_STOP_ATR_MULTIPLIER`	Default ATR multiplier used for stop-loss distance.
`DEFAULT_TAKE_PROFIT_RR`	Default take-profit risk/reward multiple.
`SCAN_INTERVAL_SECONDS`	Delay between scan cycles in watch mode.
`OUTCOME_UPDATE_INTERVAL_SECONDS`	Delay between outcome update cycles in watch mode.

Outcome Tracking

Controls how many candles are checked when resolving pending signal outcomes.

Variable	Purpose
`OUTCOME_MAX_BARS`	Maximum number of bars before a pending signal expires.
`OUTCOME_FETCH_LIMIT`	Number of candles fetched while updating outcomes.