API + MCP

Open JSON over HTTPS, and a live MCP server for agents. ~2,100 events / ~18,000 markets across Kalshi and Polymarket, each with a Resolution Clarity Grade, named resolution source, and cross-venue links. No key required.

The same event priced on both venues is one event_id with markets attached from each. Prices refresh hourly. Catalyst dates (CPI, FOMC, jobs, earnings) are joined per event. Read-only.

ACCESS

Open by default. Full universe, no key, 1,000 requests/day per IP. A free key lifts you to 10,000/day:

curl -s -X POST https://api.clearmarket.fyi/v1/keys \
  -H 'content-type: application/json' \
  -d '{"email":"[email protected]"}'

Send it as Authorization: Bearer <key> or ?key=<key>. CORS open.

REST · THE WORKBENCH

Query and filter the universe directly. Every response is the canonical schema with derived fields added at serve time.

GET/v1/events?category=&platform=&grade=&q=&limit=&offset=

curl -s 'https://api.clearmarket.fyi/v1/events?category=economics&grade=A&limit=5' \
  | jq '.events[] | {slug, grade, question}'

GET/v1/events/{slug}

Full event: linked markets, grades, windowed catalysts.

curl -s https://api.clearmarket.fyi/v1/events/kxgdpyear-26 \
  | jq '{question, catalyst_dates, markets: (.markets | length)}'

GET/v1/markets/{market_id}

Single market: price, Resolution Clarity Grade, resolution provenance.

GET/v1/catalysts/upcoming?days=N

Scheduled catalysts across all events, cross-event view.

curl -s 'https://api.clearmarket.fyi/v1/catalysts/upcoming?days=14' | jq '.catalysts'

MCP · THE HANDSHAKE

The agent-first surface. Same data, spoken as tools an agent calls directly. No HTML to crawl, no REST to compose. Streamable HTTP at https://mcp.clearmarket.fyi. Open, read-only.

tools

list_eventsbrowse / search the universe (set q)

get_eventfull graded record for one event

get_marketprice + resolution provenance

list_upcoming_catalystsscheduled catalysts, next N days

list_signalsbrowse the CM Signal wire (filter by event, category, venue, type)

get_signalfull wire bulletin by slug

Claude Desktop / Cursor

Add to claude_desktop_config.json or ~/.cursor/mcp.json (bridges stdio to the remote server via mcp-remote):

{
  "mcpServers": {
    "clearmarket": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clearmarket.fyi"]
    }
  }
}

Verify (raw JSON-RPC)

curl -s -X POST https://mcp.clearmarket.fyi -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | jq '.result.tools[].name'

AGENT · THE MANIFEST

A plain-text surface engineered for LLM context windows. Zero markup, token-optimized, enumerates every endpoint and tool.

/llms.txt [density: high] [context: token-optimized]

SCHEMA

JSON Schema (draft 2020-12). API responses are the schema with derived fields added at serve time.

Repository: github.com/JDSource/clearmarket