# odds-api

> Sports betting odds API for bookmaker coverage, events, live odds, OpenAPI docs, SDKs, and agent integrations.

## Canonical URLs

- Website: https://odds-api.net
- Documentation: https://odds-api.net/docs
- OpenAPI: https://odds-api.net/openapi.json
- API base URL: https://api.odds-api.net/v1
- Public GitHub: https://github.com/odds-api/odds-api

## Main Endpoints

- `GET /v1/bookmakers` - supported bookmakers, country coverage, and feed availability.
- `GET /v1/events` - upcoming fixtures with league, team, start-time, and status metadata.
- `GET /v1/odds` - bookmaker odds for moneyline, spreads, totals, and related markets.

## Agent Notes

- Use `ODDS_API_KEY` for authenticated API calls.
- Use `ODDS_API_BASE_URL=https://api.odds-api.net/v1` for SDKs and examples.
- Prefer the OpenAPI document for exact schemas and parameter contracts.
- Public package names are `@odds-api/client`, `@odds-api/mcp`, and `odds-api-client`.

## Support

- Contact: support@odds-api.net