StrategySuitabilityGate
StrategySuitabilityGate screens every OrderIntent against the user's declared experience tier and capital envelope, blocking strategy types that excee
What it does
StrategySuitabilityGate screens every OrderIntent against the user's declared experience tier and capital envelope, blocking strategy types that exceed the user's configured risk profile. It prevents novice-tier users from executing advanced multi-leg or high-leverage strategies without explicit elevation.
Pipeline placement
Applies to: Every OrderIntent — validates that the strategy type matches the user's declared experience tier and capital envelope
Why it matters
| If this fails | Consequence |
|---|---|
| Unsupported strategy executed | A user configured for basic strategies executes a complex multi-outcome strategy they have not validated, leading to unexpected losses and support escalation. |
| Capital envelope exceeded | A strategy-level order exceeds the user's configured per-strategy capital cap, concentrating more exposure than intended. |
Inputs
Polymarket inputs
| Input | Source | Required | Use |
|---|---|---|---|
| Gamma market category and complexity flags | gamma | required | Determine whether the target market requires advanced knowledge (e.g. negRisk multi-outcome). |
| Market outcome count | gamma | required | Flag multi-outcome markets that require elevated experience tier. |
Internal inputs
| Input | Source | Required | Use |
|---|---|---|---|
| User experience tier and capital envelope config | internal | required | Compare against the strategy type of the incoming OrderIntent. |
| KillSwitch active flag | KillSwitch | required | If active, reject immediately. |
Authority
What this bot is permitted to do
State
Readiness
Planned
Status
planned
Class
Guardrail
Default mode
planned
Developer owner
Polytraders core — Risk pod
Capital impact
Direct
Reason codes emitted
| Code | Severity | Meaning | Action |
|---|---|---|---|
| KILL_SWITCH_ACTIVE | HARD_REJECT | Global kill switch active. | Immediate HARD_REJECT. |
| SUITABILITY_STRATEGY_CLASS_BLOCKED | HARD_REJECT | Strategy class not in user's allowed list. | Return HARD_REJECT; log strategy_class and user_tier. |
| SUITABILITY_CAPITAL_CAP_EXCEEDED | HARD_REJECT | Order size exceeds per-strategy capital cap. | Return HARD_REJECT; log size_usd and cap. |
| SUITABILITY_NEGRISK_BLOCKED | HARD_REJECT | NegRisk market requires elevated tier not held by user. | Return HARD_REJECT. |
| SUITABILITY_DATA_UNAVAILABLE | HARD_REJECT | User profile store unavailable; cannot evaluate suitability. | Return HARD_REJECT (fail-closed). |
Related bots in Risk Guardrail
Used by
Reverse index — strategies that currently reference risk.strategysuitabilitygate. If you change this bot's authority or reason codes, these strategies must re-pass shadow.
| Strategy | State | Activity |
|---|---|---|
| US Elect — book-builder | demo-wired | last triggered 13m ago |
| NBA H2H — moneyline market-make | demo-wired | last triggered 20m ago |
Showing 2 of 2 · demo-wired ≠ production-live
Why this matters
Risk Guardrail bots does NOT propose intents or sign orders; only permits or blocks. Understanding the authority boundary prevents misuse and makes promotion-gate reviews faster and more reliable. View raw spec JSON →