> For the complete documentation index, see [llms.txt](https://rock-odds.gitbook.io/rock-odds-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rock-odds.gitbook.io/rock-odds-docs/endpoints.md).

# Endpoints

RockOdds API endpoints use the following base URL:

```
https://rockodds.live/api/v2
```

## Endpoints

| Method | Path                               | Authentication | Purpose                                  |
| ------ | ---------------------------------- | -------------- | ---------------------------------------- |
| `GET`  | `/games`                           | Required       | List current games and odds              |
| `GET`  | `/pregame`                         | Required       | List non-live games and odds             |
| `GET`  | `/games/{game_id}`                 | Required       | Retrieve one game by ID                  |
| `GET`  | `/stream`                          | Required       | Receive a snapshot and real-time updates |
| `GET`  | `https://rockodds.live/api/health` | Not required   | Check API and data freshness health      |

## Response conventions

* Request and response bodies use JSON, except for the SSE stream.
* Odds and line values are strings. Do not parse them as integers.
* Timestamps use ISO 8601 and include a UTC offset.
* IDs are opaque strings. Store and compare them, but do not derive meaning from their format.
* New fields and market types may be added. Clients should ignore fields and market types they do not support.
* REST list responses omit locked lines. A single-game response and the initial SSE snapshot can include locked lines, so always check `locked`.

See [errors and limits](/rock-odds-docs/errors-and-limits.md) for HTTP error handling and retry guidance.
