Skip to main content
GET
Get market price changes since a given ID

Endpoint details

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. Cursor age: The endpoint does not reject a cursor for its age. An older last_id pages forward through the changes after it; keep polling while meta.has_more is true, continuing from each response’s meta.delta_last_id. A 400 means a missing or malformed parameter, so fix the request instead of re-bootstrapping. If you lose your cursor, 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.

Authorizations

X-TheRundown-Key
string
header
required

Recommended API key request header for new integrations

Query Parameters

odds_format
enum<string>
default:american

Odds representation for supported REST prices. Omit the parameter or use american to preserve the existing American format. Supported values are american, decimal, fractional, and probability (a 0..1 fraction). Fractional odds are reduced ratio strings. Decimal and probability values preserve the source number or numeric-string type. Nulls, nonnumeric sentinels, off-board values such as 0 and 0.0001, and numeric values with absolute value below 100 remain unchanged. Price-delta fields remain in American-point difference units. Empty, repeated, or unsupported values return HTTP 400. WebSocket messages are unchanged.

Available options:
american,
decimal,
fractional,
probability
last_id
integer<int64>
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. Older cursors are not rejected for age; keep polling while meta.has_more is true. Do not use 0 as a fallback.

Required range: x >= 1
sport_id
integer

Filter by sport ID. A non-integer value returns HTTP 400. With market_ids omitted, the sport also selects the default market set.

affiliate_ids
string

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_ids
string

Literal comma-separated market-ID filter, up to 12 IDs; more returns HTTP 400. Omit it for the default 1,2,3, or 1,2,3,563 for soccer leagues and NHL when sport_id is set; the default does not add in-play IDs. 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_id
string

Filter by event ID

limit
integer
default:1000

Maximum deltas per response. Values above 5000 are capped to 5000; values below 1 or non-numeric use 1000.

Required range: x <= 5000

Response

Market deltas

meta
object
deltas
object[]