GET /v1/movers/sports-nba

$0.02realtimetier: datacache 60sEngine A — Probability API

The fastest way to see where news is landing in NBA basketball: active markets ranked by absolute probability change over your chosen window, with volume surge ratios. Same shape as /v1/movers, pre-filtered to NBA basketball markets.

Parameters

NameInTypeRequiredNotes
windowquerystringno (default: "24h") — one of "1h", "6h", "24h"
categoryquerystringno — one of "politics", "economics", "weather", "crypto", "sports", "science-tech", "entertainment"
min_liquidityquerynumbernoMinimum liquidity_score (0–1)
limitqueryintegerno (default: 20)

Example

curl "https://x402-factory.com/v1/movers/sports-nba?window=24h&limit=10"

Example response

{
  "data": {
    "movers": [
      {
        "slug": "thunder-win-nba-finals-2027",
        "question": "Will the Thunder win the 2027 NBA Finals?",
        "p_now": 0.199,
        "p_prev": 0.2012,
        "delta": -0.0022,
        "volume_surge_ratio": 1,
        "category": "sports"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/movers/sports-nba",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.962Z",
    "freshness": "realtime",
    "sources": [
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/probability.movers.sports-nba",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "movers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "question": {
            "type": "string"
          },
          "p_now": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "p_prev": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "delta": {
            "type": "number"
          },
          "volume_surge_ratio": {
            "type": "number"
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "question",
          "p_now",
          "p_prev",
          "delta",
          "volume_surge_ratio",
          "category"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "movers"
  ],
  "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.02 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.