Migration Guide — V1 to V2 API

Overview of changes

• Combined /odds and /events endpoints — everything is on /v2/events; there is no /v2/odds.
• Deeplinks on events — links.bookmakers and links.betslip.
• Bookmaker prices persist when unavailable — every byBookmaker entry carries available; filter on it.
• Unique playerIDs — PLAYER_NAME_NUMBER_LEAGUE (PATRICK_MAHOMES_1_NFL), the same across teams.
• Many more request options on the events endpoint.

Upgrade guide

Swap the base URL

- https://api.sportsgameodds.com/v1/...
+ https://api.sockodds.com/v2/...

Point v1/events and v1/odds at the combined v2/events

- /v1/events...
- /v1/odds...
+ /v2/events...

Odds field renames

• odds → fairOdds
• spread → fairSpread
• overUnder → fairOverUnder
• isFallbackOdds → removed (no placeholder even-money prices)

Status field renames

• hasMarketOdds / hasAnyOdds → oddsPresent
• anyOddsAvailable / marketOddsAvailable → oddsAvailable
• nextUpdateAt → removed (use info.lastUpdatedAt)

Add includeAltLines if you need alt lines

Alt lines are off by default in v2.

Filter unavailable byBookmaker odds

+ Event.odds.<oddID>.byBookmaker.<bookmakerID>.available

Player name paths

• Player.firstName → Player.names.firstName on /players (event players keep the flat fields)

New features & non-breaking changes

• The API key can be a query param (?apiKey=).
• New params on /v2/events: type, oddsPresent, includeOpposingOdds (alias includeOpposingOddIDs), includeAltLines, bookmakerID, teamID, playerID, live, started, ended, cancelled, finalized, includeOpenCloseOdds (accepted; no snapshots yet).
• marketName on every market; decimal on every bookmaker entry.
• Default/max limits: /events 10/100; /teams and /players 50/250.