Understand the response

Available for: Free API · Concierge API · Enterprise API. Fields and datasets can be omitted when not part of your API tier's data coverage.

The API uses structured identifiers, grouped odds, and explicit status fields. Read those fields directly and preserve their relationships in your integration.

The public response envelope

Odds and many discovery operations return:

{
  "data": {},
  "success": true,
  "messages": []
}

data is the operation-specific payload: an object, list, or dictionary according to the endpoint schema. Check success before reading it. messages carries explanatory messages when an operation cannot complete. pagination appears only for operations that supply pagination; do not assume every list is paginated.

Bet-slip generation and status are an exception: their responses are direct objects with status, details, and requestId. Middleware and validation errors may also use a different body shape. The error guide explains how to handle that distinction.

Selection identity

A market line can have alternate points. Keep the selected points with its identity; the same market-line ID does not make all alternate selections interchangeable. Preserve a returned deep link for the exact points you display.

Odds dictionaries group by league, period, pregame/live phase, market group, side, and source. Composite dictionary keys are grouping keys. Structured IDs and fields are the contract to use when comparing or joining records.

Side index

These stable numeric values describe conventional sides:

Use the group's bet type and sideName to understand the selection. Do not label every 0 as “away” when reading an over/under market, or assume every market has a draw side.

Event status

These are event/group statuses. A live event does not imply that every sportsbook line is currently available.

Market-line status

Also inspect disabled and the presence of the required price/link fields. Do not show a disabled or unavailable line as an actionable bet merely because you still have its old URL. Source status fields have their own enum; use the source schema rather than applying this market-line table to them.

Prices and optional fields

price is American odds. points can be absent for a selection without a points line. openerPrice and openerPoints, when present, describe the first captured line. alternateLines describes other available points/prices; use each alternate's own fields.

Source-specific price, format, and liquidity fields can vary across providers. Use sourceFormat and the reference schema when interpreting sourcePrice. Do not turn an omitted price into zero or assume that omitted liquidity means no liquidity.

Null fields can be omitted from JSON. Fields outside your API tier's datasets may be absent, and partner/source metadata can be absent when no mapping exists. Clients should tolerate missing optional fields and additional fields while still checking required contract values.

Timestamps and ordering

data.lastUpdated in an odds response is Unix time in milliseconds, based on the newest included line modification. Convert it with new Date(value) in JavaScript, or divide by 1000 before passing it to Python's timestamp conversion. A value of 0 does not provide a useful observed update time.

modifiedOn identifies an individual record's modification time where provided. sequenceNumber and freshnessExpiresAt provide additional line context. The response timestamp does not mean every line changed at once; a delayed response can contain many unchanged selections.

When consuming live updates, apply the streaming ordering and recovery rules. Do not compare SSE event IDs as if they were interchangeable with a market line's sequence number.

Deep links are selection data

Use the deep link belonging to the displayed selection or alternate. Free odds links are generic Gambly URLs until you add your partner code. Price-only live updates can omit links; retain the existing link for the unchanged selection instead of clearing it whenever a delta lacks deepLink.

When a new selection or different points appears, obtain the correct current link rather than attaching a URL from a different line. See tracked deep links and odds.