Paper vs Live Mode
Every bot has a Paper trading (dry run) switch. Paper mode simulates the exact same logic against live market data without placing real orders. Live mode places real orders with your own funds.
| Paper (dry run) | |
|---|---|
| Orders placed | None — fills are simulated at observed market prices |
| Funds at risk | None |
| Wallet key required | No |
| PnL tracked | Yes — simulated positions settle at resolution like real ones |
| Trade status | Recorded as SIMULATED |
| Live | |
|---|---|
| Orders placed | Real orders on the Polymarket CLOB |
| Funds at risk | Yes — your own USDC on Polygon |
| Wallet key required | Yes — added in Settings → API Keys |
| PnL tracked | Yes — from your actual fills |
| Trade status | Recorded as OPEN, then CLOSED at settlement |
How the two are kept separate
Each trade is tagged with an explicit dryRun flag rather than being guessed from its on-chain shape. That means your paper and live histories, balances, and risk counters never mix: a live daily-loss limit only counts live losses, and paper performance never inflates your live numbers.
Switching modes
Toggle Paper trading in the bot's Settings tab and Save. You cannot switch a bot between paper and live while it is running — stop it first, flip the switch, then start again.
Recommended workflow
Run every new configuration in paper mode long enough to see positions open and settle. Only move to live once the simulated results and behaviour match your expectations.