# ClearMarket

Reference data layer for prediction markets. Cross-venue event linking, graded resolution clarity, named resolution sources, and catalysts across Kalshi and Polymarket. Open and free; built to be queried by agents.

## What this is

ClearMarket normalizes Kalshi and Polymarket markets into a single schema:
- events: canonical question, classified, cross-venue linked, with catalyst dates
- markets: one row per venue listing, with a Resolution Clarity Grade (A/B/C), named resolution source, and provenance
- the same event priced on both venues is one event_id with markets attached from each

~2,100 events / ~18,000 markets. Prices refresh hourly. Read-only.

## REST API (open, free, no key)

Base: https://api.clearmarket.fyi

- GET /v1/events?category=&platform=&grade=&q=&limit=&offset= : list and filter events
- GET /v1/events/{slug} : full event, all linked markets, grades, windowed catalysts
- GET /v1/markets/{market_id} : single market, price, resolution provenance
- GET /v1/markets/movers?min_mult=&limit= : day-over-day volume movers (volume-spike signal)
- GET /v1/catalysts/upcoming?days=N : scheduled catalysts across all events
- POST /v1/keys {"email":"..."} : optional free key, lifts the limit to 10,000/day

Open by default: full universe, no key, 1,000 requests/day per IP. CORS open.

## MCP server (agent-first)

Streamable HTTP at https://mcp.clearmarket.fyi. Open, read-only.

Tools:
- list_events : browse or search the universe (set q for free-text)
- get_event : full graded record for one event
- get_market : price and resolution provenance for one market
- list_upcoming_catalysts : scheduled catalysts in the next N days
- list_signals : browse the CM Signal wire (filter by event_id, category, venue, detection_path)
- get_signal : full wire bulletin by slug

Connect via mcp-remote (Claude Desktop / Cursor): npx -y mcp-remote https://mcp.clearmarket.fyi

## CM Signal (daily wire) — under /signals (its own namespace, not /v1/)

- https://clearmarket.fyi/signals/ : wire index (HTML + embedded JSON-LD DataCatalog)
- https://clearmarket.fyi/signals.json : full wire list, newest first
- https://clearmarket.fyi/signals/{slug}.json : single wire record
- https://clearmarket.fyi/signals/for-event/{event_id}.json : every wire for a given CM event
- https://clearmarket.fyi/signals/rss.xml : feed for indexers
- also via MCP: list_signals / get_signal (above)

## Example slugs

- kxgdpyear-26 : will GDP growth in 2026 exceed 2%
- kxinxy-26dec31h1600 : will the S&P 500 close above a level on Dec 31, 2026
- bitcoin-vs-gold-vs-sp-500-in-2026 : will Bitcoin outperform gold and the S&P in 2026

## Schema

JSON Schema files (draft 2020-12):
- https://raw.githubusercontent.com/JDSource/clearmarket/main/schema/events.schema.json
- https://raw.githubusercontent.com/JDSource/clearmarket/main/schema/markets.schema.json
- https://raw.githubusercontent.com/JDSource/clearmarket/main/schema/marks.schema.json
- https://raw.githubusercontent.com/JDSource/clearmarket/main/schema/resolution_log.schema.json

## Repository

https://github.com/JDSource/clearmarket

## Contact

hello@clearmarket.fyi