PriceBandValidator
PriceBandValidator is a fat-finger and decimal-shift catcher.
What it does
PriceBandValidator is a fat-finger and decimal-shift catcher. It rejects or warns on any order priced outside a sanity band relative to the current top-of-book mid, preventing obviously erroneous prices from reaching the CLOB V2 signing step.
Pipeline placement
Applies to: Every ExecutionPlan before order signing
Why it matters
| If this fails | Consequence |
|---|---|
| Fat-finger price not caught | An order priced at 0.06 instead of 0.60 submits at a tenfold mispricing, immediately filling against informed counterparties at a large loss. |
| Decimal shift not detected | A misconfigured strategy submitting pUSD amounts as probabilities (e.g. 45.0 instead of 0.45) creates orders orders of magnitude outside market range. |
| NegRisk sum-to-one constraint not checked | Orders across a negRisk market group that sum to above 1.0 in probability are fundamentally mis-priced and represent an arb against the strategy. |
Inputs
Polymarket inputs
| Input | Source | Required | Use |
|---|---|---|---|
| CLOB V2 top-of-book snapshot | clob_public | required | Compute current mid price for band validation. |
| Market negRisk flag | gamma | optional | Apply sum-to-one constraint for negRisk markets. |
Internal inputs
| Input | Source | Required | Use |
|---|---|---|---|
| ExecutionPlan from SmartRouter | exec.smart_router | required | Validate plan.price against current mid ± max_offset_from_mid_pct. |
Authority
What this bot is permitted to do
State
Readiness
Spec started
Status
planned
Class
Execution Utility
Default mode
shadow_only
Developer owner
Polytraders core — Execution pod
Capital impact
Direct
Reason codes emitted
| Code | Severity | Meaning | Action |
|---|---|---|---|
| PRICE_BAND_PASS | INFO | Order price within max_offset_from_mid_pct of current mid. | Forward ExecutionPlan to signing. |
| PRICE_BAND_WARN | WARN | Order price between warning and hard threshold; or shadow mode warn-only. | Annotate ExecutionPlan; proceed. |
| PRICE_BAND_BREACH | HARD_REJECT | Order price exceeds max_offset_from_mid_pct and action_on_breach=reject. | Discard ExecutionPlan; emit no order. |
| PRICE_BAND_RESHAPED | RESHAPE | Order price snapped to band edge; action_on_breach=reshape. | Update plan.price to band edge; forward to signing. |
| PRICE_BAND_NEGRISK_BREACH | HARD_REJECT | NegRisk market: sum of outcome leg prices > 1.0. | Discard ExecutionPlan. |
Related bots in Execution
Used by
Reverse index — strategies that currently reference exec.pricebandvalidator. If you change this bot's authority or reason codes, these strategies must re-pass shadow.
| Strategy | State | Activity |
|---|---|---|
| Crypto Q2 — basket rebalance | frozen | last triggered 23m ago |
Showing 1 of 1 · demo-wired ≠ production-live
Why this matters
Execution bots does NOT propose new positions; only routes and shapes approved intents. Understanding the authority boundary prevents misuse and makes promotion-gate reviews faster and more reliable. View raw spec JSON →