GET /v1/movers/changes

freerealtimetier: freecache 60sEngine A — Probability API

Free polling probe for /v1/movers/delta: returns changed_count, next_cursor, and as_of only — no rows. Poll hourly for $0 and call the paid delta only when changed_count > 0.

Parameters

NameInTypeRequiredNotes
sincequerystringnoOpaque cursor from a previous next_cursor; omit once to bootstrap a cursor at now

Example

curl "https://x402-factory.com/v1/movers/changes"

Bootstrap call: zero changes plus a cursor at now.

Example response

{
  "data": {
    "changed_count": 0,
    "next_cursor": "djF8MjAyNi0wNy0xOFQxMjowMDowMC4wMDBafA",
    "as_of": "2026-07-18T12:00:00.000Z"
  },
  "meta": {
    "endpoint": "/v1/movers/changes",
    "version": "1.0.0",
    "generated_at": "2026-09-13T09:52:16.290Z",
    "freshness": "realtime",
    "sources": [
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/probability.movers.changes",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "changed_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "next_cursor": {
      "type": "string"
    },
    "as_of": {
      "type": "string"
    }
  },
  "required": [
    "changed_count",
    "next_cursor",
    "as_of"
  ],
  "additionalProperties": false
}

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

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.