GET /v1/board/politics-us

$0.03realtimetier: datacache 60sEngine A — Probability API

One-call board of the most active US politics prediction markets: top markets by volume with blended live probabilities, resolution dates, and per-market slugs for drill-down. The bulk read for agents tracking the state of US politics at a glance.

Parameters

Example

curl "https://x402-factory.com/v1/board/politics-us?limit=10"

Example response

{
  "data": {
    "category": "politics-us",
    "markets": [
      {
        "slug": "republican-wins-presidency-2028",
        "question": "Will the Republican candidate win the 2028 US presidential election?",
        "probability": 0.5049,
        "volume_24h_usd": 1227140.61,
        "resolution_date": "2028-11-07"
      },
      {
        "slug": "republicans-hold-house-midterms-2026-11",
        "question": "Will Republicans hold the House in the 2026 midterms?",
        "probability": 0.5818,
        "volume_24h_usd": 426031.65,
        "resolution_date": "2026-11-04"
      },
      {
        "slug": "democrats-win-senate-midterms-2026-11",
        "question": "Will Democrats win Senate control in the 2026 midterms?",
        "probability": 0.2976,
        "volume_24h_usd": 285766.57,
        "resolution_date": "2026-11-04"
      },
      {
        "slug": "venezuela-opposition-wins-election-2026-12",
        "question": "Will the opposition candidate win Venezuela's December election?",
        "probability": 0.4304,
        "volume_24h_usd": 222946.41,
        "resolution_date": "2026-12-06"
      },
      {
        "slug": "us-government-shutdown-2026-10",
        "question": "Will the US government shut down on October 1?",
        "probability": 0.2747,
        "volume_24h_usd": 139147.66,
        "resolution_date": "2026-10-01"
      },
      {
        "slug": "nyc-mayor-incumbent-wins-2026-11",
        "question": "Will the incumbent win the NYC mayoral election?",
        "probability": 0.6494,
        "volume_24h_usd": 101572.4,
        "resolution_date": "2026-11-03"
      },
      {
        "slug": "government-shutdown-october-2026",
        "question": "Will there be a US government shutdown at the October 2026 funding deadline?",
        "probability": 0.2573,
        "volume_24h_usd": 94727.5,
        "resolution_date": "2026-10-01"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/board/politics-us",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.758Z",
    "freshness": "realtime",
    "sources": [
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/probability.board.politics-us",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "markets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "question": {
            "type": "string"
          },
          "probability": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "volume_24h_usd": {
            "type": "number"
          },
          "resolution_date": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "question",
          "probability",
          "volume_24h_usd",
          "resolution_date"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "category",
    "markets"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.03 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors