.env.example

# --- Required ---

# Postgres credentials (consumed by every Spring service via SPRING_DATASOURCE_*).
POSTGRES_USER=mariaalpha
POSTGRES_PASSWORD=mariaalpha
POSTGRES_DB=mariaalpha

# Shared secret enforced by api-gateway. Required for every UI request and WebSocket
# subscription. Any non-empty string works for local development.
MARIAALPHA_API_KEY=local-dev-key

# --- Optional (only needed for Alpaca paper-trading smoke; see docs/runbooks/alpaca-smoke-test.md) ---

ALPACA_API_KEY_ID=your_alpaca_api_key_here
ALPACA_API_SECRET_KEY=your_alpaca_secret_key_here

# Profile selectors. Default `simulated` boots the in-memory CSV replay and the simulated
# fill engine — no external dependencies required. Flip to `alpaca` for real paper trading.
MARKET_DATA_PROFILE=simulated
EXECUTION_PROFILE=simulated

# --- Optional: portfolio construction & risk (roadmap 4.6.1) ---

# Notional cash base used to compute NAV. MariaAlpha has no cash ledger, so NAV is
# this plus the marked gross exposure; every response says so via `navSource`.
ANALYTICS_PORTFOLIO_BASE_NAV=1000000
# Bucket ticks by wall-clock arrival ('arrival', correct for the looping simulated tape,
# whose CSV timestamps repeat on every pass) or by the tick's own timestamp ('event',
# correct for a live Alpaca feed).
ANALYTICS_RETURNS_CLOCK=arrival
# Allow POST /api/analytics/portfolio/rebalance/submit to send a real basket order.
ANALYTICS_REBALANCE_SUBMIT_ENABLED=false
# COVARIANCE (default) gives diversification credit using the model analytics-service
# publishes; SUM_OF_ABSOLUTES pins the pre-4.6.1 behaviour.
EXECUTION_ENGINE_VAR_AGGREGATION=COVARIANCE