🍺
/Documentation

Configuration

Settings & Risk

Last updated March 1, 2026

The Settings tab controls how and when the Runner executes your strategy. Hornpub also provides several built-in layers of risk control at both the block and project level.

Project Settings

SettingDescription
SymbolsThe trading pairs the strategy runs on. Each symbol runs independently every tick. Add multiple symbols to trade a basket.
IntervalHow frequently (in seconds) the Runner executes your strategy. Default: 300s (5 minutes). Lower = more frequent = more compute.
Trade HoursUTC time window during which trades are allowed. Outside this window, the Runner skips execution. Leave blank to trade 24/7. Supports overnight windows (e.g. 22:00–06:00 UTC).
Disable WeekendsWhen enabled, the Runner skips all ticks on Saturday and Sunday (UTC). Useful for strategies that rely on traditional market patterns.
Max Trades Per DayMaximum number of BUY orders per symbol per UTC day. Sell orders do not count toward this limit. Set to 0 to disable.
Advanced LoggingWhen enabled, the Runner logs a detailed snapshot before every strategy run including mark price, position state, entry price, and unrealized PnL.

Risk Controls

Hornpub has several built-in layers of risk control. Understanding them helps you design safer strategies.

At the Block Level

  • Take Profit / Stop Loss blocks: Per-trade percentage-based exits. Always use both.
  • NOT In Position guard: Prevents stacking multiple buy orders into the same position (unless you intend to average in).
  • Cooldown Bars: Enforces a minimum pause between entries to prevent over-trading.
  • Trend Direction / Volatility Regime filters: Gate entries to favorable market conditions.

At the Project Level

  • Max Trades Per Day: Hard cap on daily entries per symbol.
  • Trade Hours: Restrict trading to specific UTC windows.
  • Disable Weekends: Avoid low-liquidity weekend markets.

Position Sizing

The BUY block takes a fixed USD amount. For position sizing based on a percentage of available capital, you need to know your starting capital and manage the USD amount manually using a Math block. There is no dynamic portfolio-value lookup in the current block set.

⚠️
Risk reminder: All trading is paper (simulated). PnL figures are hypothetical. Past performance in backtests does not guarantee future results.