polyalpha/.env.example at master · Genius740Code/polyalpha · 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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
# Polyalpha Environment Configuration Example
# Copy this file to .env and customize with your settings

# ============================================================================
# General Configuration
# ============================================================================

# Paper trading starting balance (default: 100.0)
POLYALPHA_BALANCE=100.0

# Logging level: DEBUG, INFO, WARNING, ERROR (default: WARNING)
POLYALPHA_LOG_LEVEL=WARNING

# Optional: log to a file instead of only stdout/stderr (e.g., ./polyalpha.log)
# Logs are rotated at 10 MB with up to 3 backups retained.
# POLYALPHA_LOG_FILE=./polyalpha.log

# Log output format: "text" (default) or "json" (machine-parseable JSON lines)
# POLYALPHA_LOG_FORMAT=json

# Log color highlighting: auto (default, enabled on TTY), 1 (force), 0 (off)
# Also respects the NO_COLOR convention.
# POLYALPHA_LOG_COLORS=auto

# API rate limit: max requests per second (default: unlimited)
# POLYALPHA_RATE_LIMIT=10

# HTTP timeout in seconds (default: 10)
POLYALPHA_TIMEOUT=10

# HTTP retries on 5xx errors (default: 3)
POLYALPHA_RETRIES=3

# ============================================================================
# Paper Trading Configuration
# ============================================================================

# Fee mode: polymarket, custom, or zero (default: custom)
POLYALPHA_PAPER_FEE_MODE=custom

# Market category for polymarket fee mode: crypto, sports, geopolitical, etc. (default: crypto)
POLYALPHA_PAPER_MARKET_CATEGORY=crypto

# Custom fee rate when fee_mode=custom (default: 0.02 for 2%)
POLYALPHA_PAPER_CUSTOM_FEE_RATE=0.02

# Maker fee rate (default: 0.0)
POLYALPHA_PAPER_MAKER_FEE_RATE=0.0

# Enable fee rebate tracking (default: true)
POLYALPHA_PAPER_ENABLE_REBATES=true

# Maker rebate percentage as decimal (default: 0.25 for 25%)
POLYALPHA_PAPER_MAKER_REBATE_PCT=0.25

# Execution delay in milliseconds (default: 0)
# POLYALPHA_PAPER_EXECUTION_DELAY_MS=2000

# Delay randomness as percentage 0-1 (default: 0.0)
# POLYALPHA_PAPER_DELAY_RANDOMNESS=0.2

# Slippage percentage (default: 0.0)
# POLYALPHA_PAPER_SLIPPAGE_PCT=0.03

# Slippage randomness as percentage 0-1 (default: 0.0)
# POLYALPHA_PAPER_SLIPPAGE_RANDOMNESS=0.1

# Max slippage before no fill as percentage 0-1 (default: 0.10)
POLYALPHA_PAPER_MAX_SLIPPAGE_NO_FILL=0.10

# Fill probability for limit orders 0-1 (default: 1.0)
# POLYALPHA_PAPER_FILL_PROBABILITY=0.85

# Condition check mode: continuous, once, or integer N (default: continuous)
POLYALPHA_PAPER_CHECK_MODE=continuous

# Enable risk management checks (default: true)
POLYALPHA_PAPER_ENABLE_RISK_MANAGEMENT=true

# Maximum daily loss in USDC (default: 500.0)
POLYALPHA_PAPER_MAX_DAILY_LOSS=500.0

# Maximum trades per day (default: 100)
POLYALPHA_PAPER_MAX_TRADES_PER_DAY=100

# Maximum order size in USDC (default: 1000.0)
POLYALPHA_PAPER_MAX_ORDER_SIZE=1000.0

# Maximum position size per market in USDC (default: 2000.0)
POLYALPHA_PAPER_MAX_POSITION_SIZE=2000.0

# Maximum concurrent open positions (default: 10)
POLYALPHA_PAPER_MAX_OPEN_POSITIONS=10

# Maximum risk per trade as percentage of balance 0-1 (default: 0.02 for 2%)
POLYALPHA_PAPER_MAX_RISK_PER_TRADE=0.02

# ============================================================================
# Real Trading Configuration (Optional - for real trading only)
# ============================================================================

# Wallet private key (WARNING: Keep this secret!)
# POLYALPHA_PRIVATE_KEY=your_private_key_here

# Polygon RPC URL (default: https://polygon-rpc.com)
# POLYALPHA_RPC_URL=https://polygon-rpc.com

# Polymarket API credentials for CLOB access
# Get these by calling derive_api_credentials() or from Polymarket settings
# POLYALPHA_POLYMARKET_API_KEY=your_api_key_here
# POLYALPHA_POLYMARKET_API_SECRET=your_api_secret_here
# POLYALPHA_POLYMARKET_API_PASSPHRASE=your_api_passphrase_here

# ============================================================================
# AI Features Configuration (Optional)
# ============================================================================

# OpenRouter API key for AI-powered analysis
# POLYALPHA_OPENROUTER_API_KEY=your_openrouter_key_here

# ============================================================================
# Database Configuration (Optional)
# ============================================================================

# Path to SQLite database file for trade persistence
# POLYALPHA_DB_PATH=./polyalpha.db

# ============================================================================
# Telegram Notifications Configuration (Optional)
# ============================================================================

# Telegram bot token for sending notifications
# Get this from @BotFather on Telegram
# TELEGRAM_BOT_TOKEN=your_bot_token_here

# Telegram chat ID to send notifications to
# Get this by messaging @userinfobot on Telegram
# TELEGRAM_CHAT_ID=your_chat_id_here