NewMarketWatcher
Poll the Gamma API at high frequency to detect newly listed markets as soon as they appear, parse their initial metadata, and emit ObservationReports
What it does
Poll the Gamma API at high frequency to detect newly listed markets as soon as they appear, parse their initial metadata, and emit ObservationReports so strategies can evaluate early liquidity opportunities before the book fills.
Pipeline placement
Applies to: Newly listed Polymarket markets not yet in the MarketScanner candidate list
Why it matters
| If this fails | Consequence |
|---|---|
| New markets discovered only on the next slow scan cycle | Early-entry advantage is lost; book may already be competitive by the time MarketScanner surfaces the market. |
| Unvalidated new market metadata forwarded to strategies | Markets with incomplete rules text or missing resolution dates may produce erroneous strategy decisions. |
Inputs
Polymarket inputs
| Input | Source | Required | Use |
|---|---|---|---|
| New condition_id metadata appearing on Gamma API | Gamma API | required | Primary source for detecting newly listed markets via ETag-gated polling. |
| Initial book state (or absence of book) | CLOB | required | Assess whether any resting liquidity exists at listing time. |
| Tick-size, neg-risk flag, and resolution metadata at listing | Gamma API | required | Pass initial metadata to strategies via ObservationReport. |
Internal inputs
| Input | Source | Required | Use |
|---|---|---|---|
| Known condition_id set (from MarketScanner) | disc.marketscanner | required | Detect genuinely new markets by diffing against the known set. |
| KillSwitch active flag | risk.kill_switch | required | Suppress emissions when KillSwitch is active. |
Authority
What this bot is permitted to do
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 |
|---|---|---|---|
| INCOMPLETE_MARKET_METADATA | WARN | New market is missing required rules text or resolution date; held in pending set. | Retry on next poll cycle; emit once metadata is complete. |
| NEW_MARKET_HOLDOFF | INFO | Market is within the min_listing_age_s hold-off window. | Hold in pending set; emit after hold-off expires. |
| KILL_SWITCH_ACTIVE | HARD_REJECT | KillSwitch is active; all emissions suppressed. | Update known set but emit no ObservationReports. |
| STALE_MARKET_DATA | HARD_REJECT | Gamma API unavailable; serving known set from cache only. | Halt new-market emissions; retry on next poll cycle. |
| PARAMETER_CHANGE_REQUIRES_APPROVAL | HARD_REJECT | poll_interval_s below locked hard minimum of 2s. | Reject config change. |
Related bots in Market Discovery
Used by
Reverse index — strategies that currently reference disc.newmarketwatcher. 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 33m ago |
| NBA props — line-shop | demo-wired | last triggered 40m ago |
| Crypto Q2 — basket rebalance | frozen | last triggered 47m ago |
Showing 3 of 3 · 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 →