lox/.env.example at main · pythonjeff/lox · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
# =============================================================================
# LOX CAPITAL - Environment Configuration
# =============================================================================
# Copy this file to .env and fill in your API keys
# Required keys are marked with (required)
# =============================================================================

# -----------------------------------------------------------------------------
# ALPACA - Brokerage & Market Data (required)
# Get keys at: https://app.alpaca.markets/
# -----------------------------------------------------------------------------
ALPACA_API_KEY=
ALPACA_API_SECRET=
ALPACA_PAPER=true

# Alpaca market data (optional, if different from trading keys)
ALPACA_DATA_KEY=
ALPACA_DATA_SECRET=

# Options market data feed hint for Alpaca (commonly "opra" for US options)
ALPACA_OPTIONS_FEED=

# -----------------------------------------------------------------------------
# OPENAI - LLM Features (required for --llm, chat, analyze)
# Get key at: https://platform.openai.com/api-keys
# Or use OpenRouter: https://openrouter.ai/keys
# -----------------------------------------------------------------------------
OPENAI_API_KEY=
OPENAI_MODEL=gpt-4o-mini
# Optional: custom base URL for OpenRouter, Ollama, or other OpenAI-compatible providers
# OPENAI_BASE_URL=https://openrouter.ai/api/v1

# -----------------------------------------------------------------------------
# FRED - Macro/Economic Data (required)
# Get key at: https://fred.stlouisfed.org/docs/api/api_key.html
# -----------------------------------------------------------------------------
FRED_API_KEY=

# -----------------------------------------------------------------------------
# BLS - Bureau of Labor Statistics (required for Lived Inflation Index)
# Get key at: https://data.bls.gov/registrationEngine/
# -----------------------------------------------------------------------------
BLS_API_KEY=

# -----------------------------------------------------------------------------
# FMP - Financial Modeling Prep (required for news, calendar, quotes)
# Get key at: https://financialmodelingprep.com/developer/docs/
# -----------------------------------------------------------------------------
FMP_API_KEY=

# Price data source: "fmp" or "alpaca" (default: fmp)
AOT_PRICE_SOURCE=fmp

# -----------------------------------------------------------------------------
# TRADING ECONOMICS - Economic Calendar (optional, primary source)
# Get key at: https://tradingeconomics.com/api/
# Falls back to FMP if not set
# -----------------------------------------------------------------------------
TRADING_ECONOMICS_API_KEY=

# -----------------------------------------------------------------------------
# FUND CONFIGURATION
# -----------------------------------------------------------------------------
# Total capital invested (for P&L calculations if no investor flows)
FUND_TOTAL_CAPITAL=1000

# Admin secret for force-refresh endpoints
ADMIN_SECRET=

# Flask secret key for session cookies (required in production)
FLASK_SECRET_KEY=

# Database URL override (defaults to sqlite:///data/lox_users.db)
# DATABASE_URL=

# -----------------------------------------------------------------------------
# POLYGON.IO / MASSIVE - Options OI, Volume, Greeks (optional)
# -----------------------------------------------------------------------------
# MASSIVE_API_KEY=

# -----------------------------------------------------------------------------
# MARINETRAFFIC - Real-time AIS vessel tracking (optional)
# Supplements free IMF PortWatch daily data with ~5-second latency AIS.
# Get key at: https://www.marinetraffic.com/en/p/plans
# Free tier available for basic tracking; Pro+ needed for area monitoring.
# Without this key, oil chokepoint data uses IMF PortWatch (daily, ~1-2d lag).
# -----------------------------------------------------------------------------
# MARINETRAFFIC_API_KEY=

# -----------------------------------------------------------------------------
# CRYPTO PERPS - Data & Trading (optional)
# No API keys needed for market data (uses public CCXT endpoints)
# -----------------------------------------------------------------------------
# Exchange for crypto perps data (default: okx). Options: okx, bybit, binance
# Note: bybit/binance may be geo-blocked in the US
CCXT_EXCHANGE=okx
# Comma-separated coins to track (default: BTC,ETH,SOL)
CRYPTO_COINS=BTC,ETH,SOL

# Aster DEX trading (optional, only needed for lox crypto trade/close/positions)
# Get wallet details from: https://app.asterdex.com/
# ASTER_USER_ADDRESS=
# ASTER_SIGNER_ADDRESS=
# ASTER_PRIVATE_KEY=

# -----------------------------------------------------------------------------
# OPTIONAL: Override Default Data Paths
# -----------------------------------------------------------------------------
# AOT_CACHE_DIR=data/cache
# AOT_NAV_SHEET=data/nav_sheet.csv
# AOT_NAV_FLOWS=data/nav_flows.csv
# AOT_NAV_INVESTOR_FLOWS=data/nav_investor_flows.csv
# AOT_TRACKER_DB=data/tracker.sqlite3