MarketResolutionWatcher

intel.market_resolution_watcher

Intelligence planned Spec ready frozen

Watches the on-chain resolution state of every active Polymarket market.

What it does

Watches the on-chain resolution state of every active Polymarket market. As a market approaches resolution, it emits typed warnings (T-24h, T-1h, finalising, resolved) so downstream bots can stop opening new positions and start unwinding. Pure observer — never blocks; the actual blocking is done by Risk's PreResolutionFreeze guardrail downstream.

Pipeline placement

runs after: — → MarketResolutionWatcher → runs before: risk.pre_resolution_freeze

Applies to: Continuous

Why it matters

If this fails	Consequence
Trading into resolution	Once a market is in its finalising window, prices can become extremely sticky and orders can sit unfilled until expiry; opening fresh exposure here is high regret.
Missing the unwind window	Without an explicit signal, strategies do not know when to switch from open-mode to unwind-mode.
Resolution-driven losses	Bots that hold a position through a resolution event with the wrong outcome lose 100% of that position; the unwind window must be respected.

Inputs

Polymarket inputs

Input	Source	Required	Use
Polymarket conditional resolution metadata	Polymarket REST + on-chain events	required	Source of truth for resolution time and status.
Per-market clock / now_ms	Runtime	required	Distance to scheduled resolution.

Internal inputs

Input	Source	Required	Use
Open positions per market	PortfolioGuard	optional	Decides whether to escalate the warning severity.

Authority

What this bot is permitted to do

Observe

State

Readiness

Spec ready

Status

planned

Class

Signal Service

Default mode

shadow

Developer owner

Intelligence pod

Capital impact

Indirect

Reason codes emitted

Code	Severity	Meaning	Action
INTEL_RESOLUTION_WARN	info	Intel Resolution Warn	See decision output and developer log for context.
INTEL_RESOLUTION_URGENT	info	Intel Resolution Urgent	See decision output and developer log for context.
INTEL_RESOLUTION_FREEZE	info	Intel Resolution Freeze	See decision output and developer log for context.
INTEL_RESOLUTION_RESOLVED	info	Intel Resolution Resolved	See decision output and developer log for context.

Related bots in Intelligence

intel.anomalydetector intel.contradictiondetector intel.crossmarketgraph

Used by

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

Strategy	State	Activity
AI Frontier — release-day taker	frozen	last triggered 14m ago
NBA props — line-shop	demo-wired	last triggered 21m ago

Showing 2 of 2 · demo-wired ≠ production-live

Why this matters

Intelligence bots does NOT propose, veto, sign, or execute any trade. 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