Settings

Configuring the system

Overview

The Settings page shows all system configuration organized by category. Each setting shows its current value, default, and whether it can be changed live or requires a restart. Some categories are read-only — their values come from environment variables and cannot be changed from the UI. Several lower-level categories (Execution, Workers, Gas, Timeouts, Price, Network) are admin-only and are not shown to normal users.

Categories

Category	What it controls
Covered Pairformerly "Automation"	Covered-pair toggles: enabled, auto-execute, require-approval
Risk	Position size limits, exposure limits, min edge, max open orders
Exit	Take-profit, stop-loss, trailing stop, max hold time
Filters	Market type allow/block lists
Engine	Dry-run mode, paused state, circuit breaker
Wallet	Deposit address, balances (pUSD / USDC / POL), withdraw to your login wallet, and key export. Polymarket contract approvals are set automatically for deposit wallets.
API Keys	Trading credential status. For the standard deposit wallet, these are provisioned automatically — this tab just shows they're ready.
Topics	Topic subscriptions, quota usage display (pipeline requests, monthly LLM tokens)
Execution	Max intents per tick, max polls, inter-order delay. Admin only — Settings → Admin settings (/admin/settings).
Workers	Worker intervals and jitter. Admin only — Settings → Admin settings (/admin/settings).
Gas	Gas price multiplier, MATIC/USD rate, gas limits. Admin only — Settings → Admin settings (/admin/settings).
Timeouts	RPC, CLOB, Gamma API timeouts. Admin only — Settings → Admin settings (/admin/settings).
Price	Price feed refresh rate, stale threshold, WebSocket settings. Admin only — Settings → Admin settings (/admin/settings).
Network	RPC URL, CLOB URL, Gamma API URL. Admin only — Settings → Admin settings (/admin/settings).

Strategy Profile Presets

At the top of the Settings page, a "Strategy Profile" bar offers one-click presets — Orbit, Voyager, and Nova. Applying a preset bulk-updates several trading strategy settings at once (a confirmation dialog shows how many settings will change). The currently applied preset shows an "Active" badge; if your settings don't match any preset, the bar shows "Custom".

Live vs Restart-Required

Settings come from different sources with different update behaviors:

Live-editable (no badge) — Changes take effect immediately. These include all automation config, risk limits, exit rules, and engine state (paused, dry_run). Most day-to-day settings are live.
Restart-required (amber badge) — Changes are saved but only take effect after restarting the backend. These include execution intervals, worker timing, gas settings, timeouts, and price feed config. A banner appears at the top with a "Restart server" button.

Tip

If you see "Restart required" after changing a setting, click the "Restart server" button at the top of the page. The backend will restart gracefully.

Danger Settings

Two settings trigger a confirmation dialog because they have significant consequences:

engine.dry_run = false — Disables simulation mode. The engine will place real orders on the CLOB and real money will move. Make sure your wallet is funded and your automation config is correct before disabling.
automation.auto_execute = true — Enables fully automated execution. Approved intents will be executed without manual confirmation. Combined with disabled dry-run, this means the system trades completely autonomously.

Danger

Disabling dry-run AND enabling auto-execute means AntFlow trades with real money, fully autonomously. Start with simulation mode, then manual approval, then auto-execute — in that order.

Searching and Filtering

Use the search bar to find settings by name (e.g., search "edge" to find min_edge settings).
Click category tabs to filter by area.
A dot appears on tabs that have unsaved changes.

Settings vs Automation Page

Settings that belong to categories like Covered Pair, Risk, Exit, and Filters also appear on the Automation page in a grouped layout. Both pages read and write the same backend configuration store, so a value changed on one page becomes the source of truth for the other. There is no live two-way UI bridge, though — a change made on one page shows up on the other page the next time that page loads (or you refresh it). Use Automation for a focused workflow view, or Settings for a complete configuration overview.

Resetting Defaults

Each category has a "Reset defaults" button that resets all editable settings in that category to their built-in defaults. This only affects the current category, not the entire system.

Individual settings can also be reset on their own — each editable row has a per-row reset that returns just that one setting to its default, without touching the rest of the category.

Saving Changes

Edit values in any category.
Click "Save changes" to persist.
Changes to live-editable settings take effect immediately.
Changes to restart-required settings are saved but flagged for restart.