ODDS.LAND Sportsbook API Docs

Set up with an AI agent

Paste this into your coding agent. It will read the live contract, ask for the key safely, and build only the integration your project needs.

Agent instruction

Integrate ODDS.LAND into this project.

1. Read https://api.odds.land/llms.txt and https://api.odds.land/openapi.json before writing code.
2. Ask me for ODDS_LAND_API_TOKEN if it is not already configured. Store it in an environment variable and never expose it in source code, logs, browser URLs, or errors.
3. Send it as Authorization: Bearer ODDS_LAND_API_TOKEN.
4. Call GET /v1/features and GET /v1/coverage?detail=summary first. Use quoteableOnly=true for event and market discovery, then use only endpoints and fields defined by OpenAPI.
5. Preserve response envelopes, selection references, policyVersion, pricingVersion, ETag, X-Request-ID, and rate-limit headers.
6. Keep the integration minimal. Do not recreate odds, margin, SGM compatibility, market rules, cashout, or settlement logic in this project.

llms.txt OpenAPI JSON

Operations

Public health, readiness, and service metadata.

GET /healthz

Process health

Public process health check. Use this for lightweight uptime probes.

GET /readyz

Readiness

Public readiness check for source and published-state health.

GET /openapi.json

OpenAPI document

Public OpenAPI JSON document for this service.

GET /llms.txt

AI agent guide

Concise machine-readable setup guide with links to the API contract and documentation.

GET /v1/healthz

Process health

GET /v1/readyz

Readiness

GET /v1/openapi.json

OpenAPI document

GET /v1/source

Source status

Returns configured source health, coverage, and operational metadata.

Product

Sportsbook catalog, events, market depth, tabs, live state, and odds history.

GET /v1/product/sports

List sports

Returns available sports with event counts, live counts, quoteable market counts, and display metadata.

GET /v1/product/lobby

Sportsbook lobby

Returns grouped sportsbook lobby sections for home, live, trending, starting-soon, all-events, and outrights views.

GET /v1/product/events

List events

Returns filtered sportsbook events with canonical ids, display metadata, score/live state, limits, and main market data.

GET /v1/product/events/{id}

Event details

Returns one canonical event with display metadata, status, score/live state, limits, and navigation metadata.

GET /v1/product/events/{id}/markets

Event market depth

Returns one page of market depth for an event, including status, outcomes, prices, and settlement references.

GET /v1/product/events/{id}/market-tabs

Event market tabs

Returns the available market tab structure for an event.

GET /v1/product/events/{id}/tabs/{tab}

Event market depth by tab

Returns market depth for one event tab, such as main, goals, players, corners, cards, combos, periods, or same_game_multi.

GET /v1/product/events/{id}/live

Event live state

Returns fast live state for an event, including score, clock, period, statistics, incidents, lineups, and player stats when available.

GET /v1/product/events/{id}/odds-history

Event odds history

Returns recent odds-history points for an event.

GET /v1/product/events/{id}/settlement-pack

Event settlement pack

Returns settlement evidence for an event, including final-score scope, period score support, incidents, statistics, source evidence, and review signals.

Contract

Feature discovery and published product coverage for client capability checks.

GET /v1/features

Feature compatibility

Returns supported quote and settlement capabilities. Same-game multi compatibility is exact: clients must use only published same_game_multi outcomes for a supported event.

GET /v1/coverage

Published coverage

Returns the current published event and market coverage, same-game multi candidate counts, and source SLA state. This route never fetches providers.

Quotes

Bet validation, quote, SGM, and cashout checks. These routes do not write bets.

POST /v1/bets/validate

Validate bet slip

Checks whether a bet slip is currently accepted, rejected, suspended, stale, or changed. This route does not reserve funds or write a bet.

POST /v1/bets/quote

Quote bet slip

Returns a quote id, accepted legs, total odds, potential return, risk limits, live hold metadata, and quote expiry for a single or multi bet. This route does not write a bet.

POST /v1/bets/sgm/quote

Quote same-game multi

Returns a modeled same-game multi quote for supported components on the same event.

POST /v1/bets/cashout-quote

Quote cashout

Returns a cashout quote for a previously accepted slip shape. This route does not mutate balances or bet records.

Settlement

Settlement evidence and settlement preview helpers. These routes do not mutate wallets.

GET /v1/results

Final results

Returns retained, source-reported final results from published live observations. A reported final is evidence, not an instruction to mutate a customer ledger.

GET /v1/results/{id}

Final result

Returns one retained result with compact score/statistics evidence and the input required for settlement evaluation when the published event link is available.

POST /v1/bets/settle

Settle bet legs

Evaluates settlement for supplied bet legs against current evidence. The API returns won, lost, void, pending, or unsupported decisions but does not mutate your ledger.

POST /v1/bets/settlement-preview

Preview settlement

Runs the same settlement evidence path in preview mode for audits and operator review. This route does not mutate your ledger.

Account

Authenticated API identity, policy, and usage.

GET /v1/account

/v1/account

GET /v1/account/policy

/v1/account/policy

PUT /v1/account/policy

/v1/account/policy

GET /v1/account/usage

/v1/account/usage

Assets

Public static flags, team logos, and category artwork used by sportsbook clients.

GET /assets/flags

List flag assets

GET /assets/flags/{file}

Read flag asset

GET /assets/categories

List category assets

GET /assets/categories/{file}

Read category asset

GET /assets/teams

List team assets

GET /assets/teams/{file}

Read team asset