# ODDS.LAND

> Paid sportsbook odds API for live and pre-match events, market depth, customer pricing, SGM, quote validation, cashout, results, and settlement.

Use the API at https://api.odds.land. Authenticate data requests with `Authorization: Bearer ODDS_LAND_API_TOKEN`. Ask the user for this key if it is unavailable. Keep it in an environment variable; never commit it, print it, or put it in a URL.

Start by calling `GET /v1/features` and `GET /v1/coverage?detail=summary`. Use `quoteableOnly=true` when discovering events or markets for betting. Preserve the response envelope, request IDs, ETags, rate-limit headers, selection references, pricing versions, and policy versions. Do not recreate pricing, SGM compatibility, market rules, or settlement decisions in client code.

## API contract

- [OpenAPI JSON](https://api.odds.land/openapi.json): Complete machine-readable request and response contract.
- [RapidAPI OpenAPI JSON](https://api.odds.land/openapi/rapidapi.json): Marketplace-safe commercial contract.
- [Human documentation](https://api.odds.land/docs): Quickstart, AI setup prompt, and endpoint reference.

## First requests

- [Features](https://api.odds.land/v1/features): Discover enabled product and tenant capabilities. Requires bearer authentication.
- [Coverage](https://api.odds.land/v1/coverage?detail=summary): Inspect compact current sports, market, freshness, and settlement coverage. Requires bearer authentication.
- [Sports](https://api.odds.land/v1/product/sports): Begin product discovery. Requires bearer authentication.

## Commercial

- [Pricing](https://api.odds.land/pricing): Paid-only usage pricing.
- [Beta terms](https://api.odds.land/beta-terms): Service and operator responsibilities.