🎛️ Reference
Configuration Reference
Every PolyBot setting explained. All settings can be changed from the Dashboard → Settings panel without editing files directly — but this reference documents what each value does.
Complete Annotated config.yml
This is the full configuration file with all settings and their defaults. Copy from config.example.yml and edit to suit your setup:
# ── Core Credentials ──────────────────────────────────────────
API_KEY: "your-l2-api-key"
API_SECRET: "your-api-secret"
API_PASSPHRASE: "your-passphrase"
WALLET_ADDRESS: "0xYourPolygonWalletAddress"
CHAIN_ID: 137 # 137 = Polygon mainnet (do not change)
# ── Bot Mode ───────────────────────────────────────────────────
MODE: "paper" # paper | dry-run | live
DRY_RUN_BALANCE: 500 # Fake USDC balance for paper mode
# ── Trade Sizing ───────────────────────────────────────────────
SIZING_MODE: "fixed" # fixed | percentage | kelly
BET_AMOUNT: 10 # USDC per trade (fixed mode)
BET_PERCENTAGE: 0.05 # 5% of balance per trade (percentage mode)
KELLY_FRACTION: 0.25 # 1/4 Kelly (kelly mode) — recommended
# ── Position Limits ────────────────────────────────────────────
MAX_POSITION_USDC: 50 # Cap per individual position in USDC
MAX_OPEN_POSITIONS: 10 # Max simultaneous open positions
# ── Risk Controls ──────────────────────────────────────────────
DAILY_LOSS_LIMIT: 30 # Bot pauses if daily losses exceed this
MAX_CONSECUTIVE_LOSSES: 3 # Pause after N losses in a row (45min)
STOP_LOSS_PCT: 0.5 # Exit position if down 50% (0 = disabled)
# ── Telegram Alerts ────────────────────────────────────────────
TELEGRAM_TOKEN: "" # BotFather token (leave blank to disable)
TELEGRAM_CHAT_ID: "" # Your chat ID (get via @userinfobot)
NOTIFY_ON_TRADE: true
NOTIFY_ON_EXIT: true
NOTIFY_ON_ERROR: true
NOTIFY_ON_DAILY_SUMMARY: true
# ── Copy Bot Settings ──────────────────────────────────────────
MIN_WIN_RATE: 0.70 # Minimum wallet win rate to copy
MIN_VOLUME_USDC: 10000 # Min historical volume to qualify
MAX_WALLETS_TO_COPY: 15 # How many leaderboard wallets to track
FOLLOW_EXITS: true # Mirror when leader closes a position
SKIP_SPORTS: true # Skip all sports prediction markets
SKIP_CRYPTO_WINDOWS: true # Skip BTC/ETH 15-min coinflip markets
SKIP_NEAR_EXPIRY_MINS: 30 # Skip markets expiring within N minutes
SKIP_EXTREME_PRICES: true # Skip YES>0.95 or YES<0.05 markets
# ── 15-Min AI Bot Settings ─────────────────────────────────────
STRATEGIES:
- "ml" # LightGBM+ExtraTrees prediction
- "snipe" # Chainlink oracle snipe (80-90%+ acc)
- "arb" # Risk-free arbitrage detection
MAX_ENTRIES_PER_WINDOW: 3 # Entries per 15-min window
MIN_CONFIDENCE: 0.60 # ML prediction confidence threshold
SNIPE_TRIGGER_SECS: 20 # Fire snipe N seconds before window close
MIN_BOOK_DEPTH: 100 # Min USDC depth to enter (thin book guard)
Setting Details
MODE
| Value | Description | Use When |
|---|
| paper | Fake money, real signals | Testing and learning |
| dry-run | Real orders submitted then cancelled | Final pre-live check |
| live | Full live trading | After 50+ paper trades |
SIZING_MODE
| Value | Description | Best For |
|---|
| fixed | Fixed USDC per trade (BET_AMOUNT) | Beginners — predictable per-trade cost |
| percentage | % of current balance (BET_PERCENTAGE) | Growing accounts — auto-scales |
| kelly | Kelly criterion × KELLY_FRACTION | Advanced — confidence-weighted sizing |
DAILY_LOSS_LIMIT
When cumulative realized losses in a calendar day reach this USDC amount, the bot automatically pauses and sends a Telegram alert. It resumes at midnight UTC. Set this to roughly 5–10% of your total deployed capital.
💡 Dashboard takes priority. All config changes made via Dashboard → Settings take effect immediately without restarting. You only need to edit config.yml directly if you're setting up a fresh install or cloning the bot to a new server.
Setting Up Telegram Alerts
- Open Telegram and search for @BotFather
- Send
/newbot and follow prompts — copy the token
- Message @userinfobot to get your chat ID
- Paste both into Dashboard → Settings → Telegram, click Send Test