EventCalendarMapper

disc.eventcalendarmapper

Market Discovery planned Spec started frozen

Map every Polymarket market to a known real-world calendar event (elections, sports fixtures, court dates, FOMC releases, earnings, debates) and emit

What it does

Map every Polymarket market to a known real-world calendar event (elections, sports fixtures, court dates, FOMC releases, earnings, debates) and emit a time-tagged ObservationReport so strategies can act on pre-event positioning logic.

Pipeline placement

runs after: MarketScanner scan cycle → EventCalendarMapper → runs before: Strategy OrderIntent generation

Applies to: All live Polymarket markets with a known resolution horizon

Why it matters

If this fails	Consequence
Markets not linked to calendar events	Strategies cannot distinguish between a stagnant market and one where a price-moving event is imminent, missing pre-event edge opportunities.
Stale calendar data	Rescheduled or cancelled events leave strategies positioned on a timeline that no longer exists.

Inputs

Polymarket inputs

Input	Source	Required	Use
Market resolution date, question text, and linked event identifiers	Gamma API	required	Primary source for matching markets to calendar events via resolution date and question NLP.
Market condition_id and neg-risk flag	Gamma API	required	Identify neg-risk bundles that share a common real-world event.

Internal inputs

Input	Source	Required	Use
KillSwitch active flag	risk.kill_switch	required	Suppress emissions when KillSwitch is active.

Authority

What this bot is permitted to do

Read-only Recommend

State

Readiness

Spec started

Status

planned

Class

Signal Service

Default mode

shadow_only

Developer owner

Polytraders core — Intelligence pod

Capital impact

Indirect

Reason codes emitted

Code	Severity	Meaning	Action
CALENDAR_MISMATCH	HARD_REJECT	No calendar event matched above the hard relevance floor; market not mapped.	Exclude from mapping output; log market_id and best attempt score.
LOW_RELEVANCE	WARN	Best calendar match is between warning and default threshold.	Include mapping with LOW_RELEVANCE warning annotation.
STALE_MARKET_DATA	HARD_REJECT	Gamma API unavailable; mapping cycle halted.	Halt cycle; retry on next interval.
KILL_SWITCH_ACTIVE	HARD_REJECT	KillSwitch is active; all emissions suppressed.	Return immediately; do not emit any ObservationReports.

Related bots in Market Discovery

disc.duplicatemarketdetector disc.marketqualityranker disc.marketscanner

Used by

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

Strategy	State	Activity
US Elections — sentiment fade	demo-wired	last triggered 44m ago
BTC weekly — close-aware quotes	demo-wired	last triggered 4m ago

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

Why this matters

Market Discovery bots does NOT propose or execute trades; only scores and ranks. 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