GET /v1/resolution/{slug}

$0.01statictier: utilitycache 86400sEngine A — Probability API

Outcome, per-venue settlement, source link where available, and the blended probability 24h before resolution (calibration signal). Unresolved markets return 404 with a pointer to the live probability endpoint.

Parameters

NameInTypeRequiredNotes
slugpathstringyes

Example

curl "https://x402-factory.com/v1/resolution/fed-rate-cut-2026-06"

A settled market from the catalog.

Example response

{
  "data": {
    "outcome": "NO",
    "resolved_at": "2026-06-17T20:00:00Z",
    "per_venue": [
      {
        "venue": "kalshi",
        "outcome": "NO",
        "resolved_at": "2026-06-17T20:00:00Z"
      },
      {
        "venue": "polymarket",
        "outcome": "NO",
        "resolved_at": "2026-06-17T20:00:00Z"
      }
    ],
    "source_url": "https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm",
    "final_p_24h_before": 0.142
  },
  "meta": {
    "endpoint": "/v1/resolution/{slug}",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.966Z",
    "freshness": "static",
    "sources": [
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/probability.resolution",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "outcome": {
      "type": "string",
      "description": "\"YES\" | \"NO\" | numeric-as-string"
    },
    "resolved_at": {
      "type": "string"
    },
    "per_venue": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "venue": {
            "type": "string",
            "enum": [
              "kalshi",
              "polymarket"
            ]
          },
          "outcome": {
            "type": "string"
          },
          "resolved_at": {
            "type": "string"
          }
        },
        "required": [
          "venue",
          "outcome",
          "resolved_at"
        ],
        "additionalProperties": false
      }
    },
    "source_url": {
      "type": "string"
    },
    "final_p_24h_before": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "outcome",
    "resolved_at",
    "per_venue",
    "final_p_24h_before"
  ],
  "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

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.