GET /v1/sports/{sport_key}/odds/movements

Returns detected home/draw/away price movements from historical snapshots. Paid tiers only — 403 on Free and Hobby. Same gate as the history endpoint above, which the schema used to state while this one was silent on it. The tiers are not named here on purpose: the 403 body below renders the live gate through plans_disp(), and a second hand-typed copy is exactly what went stale when `starter` was retired. An unknown `sport_key` returns 404 and costs nothing.

Request

curl 'https://api.puntersedge.online/v1/sports/afl/odds/movements' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 5 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

[
  {
    "event_id": "4b84fde7-7054-40db-a37f-ae05c9705549",
    "sport_key": "nrl",
    "bookmaker": "tab",
    "market_type": "h2h",
    "home_team": "Souths",
    "away_team": "Newcastle",
    "commence_time": "2026-09-09T02:05:00Z",
    "from_recorded_at": "2026-09-06T22:13:09Z",
    "to_recorded_at": "2026-09-07T00:43:24Z",
    "changes": {
      "home_price": {
        "from": 1.42,
        "to": 1.4,
        "delta": -0.02
      },
      "away_price": {
        "from": 2.9,
        "to": 3.0,
        "delta": 0.1
      }
    }
  }
]

Guides that use this endpoint

• Track betting line movement in Python

Related endpoints

• GET /v1/sports — List available sports
• GET /v1/sports/{sport_key}/closing-lines — Closing price and line per bookmaker, with the consensus
• GET /v1/sports/{sport_key}/odds — Get odds by sport
• GET /v1/sports/{sport_key}/odds/history — Historical odds snapshots