Sse Odds Drop

Business+ tier SSE endpoint that filters the broadcast stream to line-MOVES only. Customer configures a threshold (in American-odds cents) and we push an event the moment a tracked side crosses it.

Each event has shape: data: {"type":"odds_drop","event_id":"...","bookmaker":"...", "side":"h2h_home","prev":-110,"new":-120,"delta":-10, "direction":"toward_favorite","timestamp":1747...}\n\n

Single-sport subscription: GET /v1/odds-drop/baseball_mlb?apiKey=...

Multi-sport subscription (one connection, many sport_keys): GET /v1/odds-drop/all?apiKey=... GET /v1/odds-drop/multi?apiKey=...&sports=baseball_mlb,basketball_nba

The wildcard 'all' value subscribes to every sport_key with broadcast activity in the last 5 minutes (~100-200 sport keys at peak). Drops include a sport_key field so you can route them downstream.

get/v1/odds-drop/{sport_key}

Request

  • Base URL: https://parlay-api.com
  • URL: https://parlay-api.com/v1/odds-drop/{sport_key}
  • Auth: none declared

Path parameters

sport_keystring required

Query parameters

apiKeystring nullable

API key. Prefer the X-API-Key header, which keeps the key out of URLs and logs; browser EventSource cannot set headers, so this stays supported.

thresholdinteger

Minimum American-odds delta to trigger an event. Default 10 (a -110 becoming -120, or +100 becoming +110).

event_idstring nullable

Optional: filter to one game's event_id

bookmakersstring nullable

Comma-separated books

Comma-separated books Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.

marketsstring nullable

Comma-separated market keys

Comma-separated market keys Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.

sportsstring nullable

Comma-separated sport_keys for multi-sport subscription. Overrides path sport_key. Use 'all' as a sentinel to subscribe to every sport_key with recent activity (last 5 min).

directionstring

both | toward_favorite | toward_dog. Filter by which way the line moved.

heartbeat_sinteger

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.