THtherundown
V2 Markets

Get market price changes since a given ID

Changed on

Returns market line price changes (new, updated, closed) since the specified last_id. Use for efficient polling.

Bootstrap flow: On known zero-delay access, call GET /api/v2/sports/{sportID}/events/{date} with the snapshot scope you need. Use its positive whole-integer meta.delta_last_id only when that response explicitly reports X-Data-Delay-Seconds: 0, then pass it as last_id. If the header is positive, absent, or invalid, keep using scoped snapshots; do not substitute 0.

Staleness guard: Cursors older than 30 minutes are rejected with HTTP 400. After a cursor error, take at most one fresh scoped snapshot and resume only when it meets the same zero-delay and valid-cursor conditions. Do not loop bootstrap requests.

Core live markets: Event snapshots expand market_ids=1,2,3 to include in-play IDs. This delta endpoint filters IDs literally, so poll 1,2,3,41,42,43 to receive full-game core updates before and during play. Returned rows retain their actual market IDs.

get/api/v2/markets/delta

Request

  • Base URL
    https://therundown.io
  • Auth
    API key in header X-TheRundown-Key

Query parameters

last_idinteger required

Return changes with ID greater than this value. On known zero-delay access, obtain a positive whole-integer initial cursor from meta.delta_last_id in a scoped v2 events snapshot that explicitly reports X-Data-Delay-Seconds: 0. Cursors older than 30 minutes are rejected; do not use 0 as a fallback.

sport_idinteger

Filter by sport ID

affiliate_idsstring

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), BookMaker (7), BetCRIS (9), Pinnacle (3), Polymarket US (31), Circa Sports (32), Bet105 (33), and Heritage Sports (34). Availability varies by sport and market. On V2 event endpoints (/api/v2/sports/{sportID}/events/{date}, /api/v2/events/{eventID}, and their openers/closing siblings), affiliate_ids=0 is a scores-only sentinel: the response keeps events, scores, and status and omits markets and price objects. Other endpoints that share this parameter treat affiliate_ids as a sportsbook filter only.

market_idsstring

Literal comma-separated market-ID filter. To poll full-game core updates before and during play, include 1,2,3,41,42,43; event snapshots expand 1,2,3 to include the in-play IDs.

event_idstring

Filter by event ID

limitinteger

Response

Market deltas

Changes

  • 8d16611813bfRevision changes
    • breaking

      response property meta/delta_last_id list-of-types was widened by adding types integer to media type application/json of response 200

    • warning

      for the query request parameter last_id, the min was set to 1.00