GET /v1/calendar

$0.01hourlytier: utilitycache 3600sEngine A — Probability API

Active markets resolving inside the horizon, sorted by resolution date with the current blended probability. An agent's event calendar: what settles soon and where it stands.

Parameters

Example

curl "https://x402-factory.com/v1/calendar?days=30"

Example response

{
  "data": {
    "events": [
      {
        "slug": "european-team-wins-world-cup-2026-07",
        "question": "Will a European team win the 2026 World Cup final?",
        "resolution_date": "2026-07-19",
        "current_p": 0.5463,
        "category": "sports"
      },
      {
        "slug": "highest-temperature-chicago-jul-20-2026-88-89",
        "question": "Highest temperature in Chicago on Jul 20, 2026? — 88° to 89°",
        "resolution_date": "2026-07-20",
        "current_p": 0.2803,
        "category": "weather"
      },
      {
        "slug": "chicago-high-temp-above-100f-2026-07-22",
        "question": "Will the high temperature in Chicago on July 22 be above 100°F?",
        "resolution_date": "2026-07-22",
        "current_p": 0.1349,
        "category": "weather"
      },
      {
        "slug": "seattle-rain-2026-07-23",
        "question": "Will it rain in Seattle on July 23?",
        "resolution_date": "2026-07-23",
        "current_p": 0.344,
        "category": "weather"
      },
      {
        "slug": "nyc-high-temp-above-95f-2026-07-24",
        "question": "Will the high temperature in New York City on July 24 be above 95°F?",
        "resolution_date": "2026-07-24",
        "current_p": 0.329,
        "category": "weather"
      },
      {
        "slug": "los-angeles-rain-2026-07-25",
        "question": "Will it rain in Los Angeles on July 25?",
        "resolution_date": "2026-07-25",
        "current_p": 0.0855,
        "category": "weather"
      },
      {
        "slug": "phoenix-high-temp-above-115f-2026-07-26",
        "question": "Will the high temperature in Phoenix on July 26 be above 115°F?",
        "resolution_date": "2026-07-26",
        "current_p": 0.2882,
        "category": "weather"
      },
      {
        "slug": "french-rider-wins-tour-2026-07",
        "question": "Will a French rider win the 2026 Tour de France?",
        "resolution_date": "2026-07-26",
        "current_p": 0.092,
        "category": "sports"
      },
      {
        "slug": "gdp-q2-2026-positive",
        "question": "Will the Q2 2026 US GDP advance print show positive growth?",
        "resolution_date": "2026-07-30",
        "current_p": 0.7073,
        "category": "economics"
      },
      {
        "slug": "houston-high-temp-above-100f-2026-08-02",
        "question": "Will the high temperature in Houston on August 2 be above 100°F?",
        "resolution_date": "2026-08-02",
        "current_p": 0.5881,
        "category": "weather"
      },
      {
        "slug": "opec-production-cut-2026-08",
        "question": "Will OPEC+ announce a production cut at its August 2026 meeting?",
        "resolution_date": "2026-08-03",
        "current_p": 0.2443,
        "category": "economics"
      },
      {
        "slug": "bitcoin-etf-inflows-5b-2026-08",
        "question": "Will spot Bitcoin ETF net inflows exceed $5B in July?",
        "resolution_date": "2026-08-05",
        "current_p": 0.528,
        "category": "crypto"
      },
      {
        "slug": "us-cpi-above-3pct-2026-08",
        "question": "Will July CPI year-over-year come in above 3.0%?",
        "resolution_date": "2026-08-12",
        "current_p": 0.442,
        "category": "economics"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/calendar",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.760Z",
    "freshness": "hourly",
    "sources": [
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/probability.calendar",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "question": {
            "type": "string"
          },
          "resolution_date": {
            "type": "string"
          },
          "current_p": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "question",
          "resolution_date",
          "current_p",
          "category"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "events"
  ],
  "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.01 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