⚠ INTERNAL — Operator UX mock · Design preview of V2 development path · demo-wired ≠ production-live · back to dev guide
Polygon · pUSD 10
📓 Developer Guide 📋 Reason Codes 📈 Shadow Mode
JD John Doe · Admin

ExchangeStatusMonitor

exec.exchangestatusmonitor
Execution planned Spec started frozen

ExchangeStatusMonitor treats Polymarket itself as a degradable dependency.

What it does

ExchangeStatusMonitor treats Polymarket itself as a degradable dependency. It polls CLOB V2 endpoint health, watches for reject-rate spikes, and parses public maintenance signals. When degradation is confirmed, it emits ObservationReports that trigger pause or de-risk actions across the exec layer.

Pipeline placement

runs after: Continuous background process; does not depend on order flow ExchangeStatusMonitor runs before: All exec bots that submit orders

Applies to: All active trading while Polymarket CLOB V2 is the execution venue

Why it matters

If this failsConsequence
Exchange degradation not detectedOrders continue to be submitted to a degraded CLOB, accumulating 429 errors, failed acks, and stale fills.
Maintenance window missedOrders submitted during a scheduled maintenance window are rejected without useful error context, causing unnecessary retries.
Resume too early after incidentResuming order submission before the CLOB has fully recovered causes a second wave of errors and potentially double-fills on retry.

Inputs

Polymarket inputs

InputSourceRequiredUse
CLOB V2 health/ping endpointclob_publicrequiredDetect CLOB REST endpoint availability and error rates.
Polymarket public status pageinternal HTTP polleroptionalParse maintenance-window announcements and incident notices.

Internal inputs

InputSourceRequiredUse
Reject-rate metrics from OrderLifecycleManagerexec.orderlifecyclemanagerrequiredDetect reject-rate spikes (429 or 503 responses) as an exchange degradation signal.

Authority

What this bot is permitted to do

Reshape

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

CodeSeverityMeaningAction
EXCHANGE_STATUS_HEALTHYINFOExchange is healthy; quarantine completed; order submission permitted.Clear pause state; resume normal operations.
EXCHANGE_STATUS_PAUSEWARNExchange is degraded or in maintenance; order submission paused.Emit ObservationReport; exec bots suspend new order submissions.
EXCHANGE_STATUS_FLATTENHARD_REJECTExchange outage confirmed; all open orders should be cancelled.Emit ObservationReport; trigger mass cancel.
EXCHANGE_STATUS_RESUMINGINFOExchange has recovered; quarantine period started.Start resume_quarantine_min timer; do not resume submissions yet.

Used by

Reverse index — strategies that currently reference exec.exchangestatusmonitor. If you change this bot's authority or reason codes, these strategies must re-pass shadow.

StrategyStateActivity
US Elect — book-builderdemo-wiredlast triggered 32m ago
NBA H2H — moneyline market-makedemo-wiredlast triggered 39m ago

Showing 2 of 2 · 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 →
Polytraders Operator UX Mock · INTERNAL · demo-wired ≠ production-live · the plan · reason codes · shadow-mode pipeline
⚙ Page Configuration
Current page settings
Loading configuration…