Guardrails Guide

~7 min – the risk fence that blocks bad executes, surfaces breaches across the desk, and alerts the team before damage compounds

Guardrails (`/team/guardrails`) define team-wide limits evaluated when you execute Set-ups and flag Executions as breached.

Where to Find It

• Sidebar → The Trading Floor → Guardrails
• Violation banners appear on Set-ups, Executions, Allocations

Configuration Sections

• Leverage limits, position size (USD)
• Exchange controls — Binance, Bybit, OKX, Hyperliquid, Deribit, dYdX; restricted symbols
• Daily loss limit + auto-freeze
• Enforcement — block on violation, auto-reduce on breach
• Drawdown limits (% and USD), unrealized loss per position
• Exposure — max open positions, total notional, per-symbol caps, whitelisted symbols
• Trading behavior — max trades/day/hour, allowed trading days
• Per-trade risk slider (0.5–5% of equity)
• Alerts — Telegram (test button), Discord, Slack, email; near-violation threshold
• Emergency Controls — Pause/Resume all trading (confirm dialog)
• Recent Violations — last 24h from `useGuardrailEvents`

Save Changes applies team-wide rules. Intended for owner/admin (`modify_guardrails`).

Quick Workflow

1. Select team → review active violation banner
2. Configure per-exchange and team-level limits
3. Set alert channels → send Test Telegram
4. Save → violations block Set-ups execute and mark Executions breached
5. Review Recent Violations after desk sessions

Quick Reality Checks

• Execute blocked everywhere? → Active breach or trading paused
• Pause button local only? → Confirm pause persisted via API in your environment
• Changes not saving? → Check admin role / RLS on backend

Next: Allocations Guide — per-trader capital and rebalance history.