> 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/pregame.md).

# List pregame odds

Returns only non-live games. Use this endpoint when your application never needs in-play odds.

```http
GET /pregame
```

Relative to the RockOdds base URL, this is equivalent to listing games with `live=false`, but makes the integration's intent explicit.

## Example request

```bash
curl --get \
  --url "https://rockodds.live/api/v2/pregame" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "sport=NFL" \
  --data-urlencode "market=spread" \
  --data-urlencode "market=ml"
```

## Query parameters

| Parameter | Type   | Required | Description                                                                  |
| --------- | ------ | -------- | ---------------------------------------------------------------------------- |
| `sport`   | string | No       | Filter by `NFL`, `NBA`, `NCAA`, `NHL`, `MLB`, or `SOCCER`.                   |
| `period`  | string | No       | Return games containing at least one market for the requested period.        |
| `market`  | string | No       | Include only the requested market type. Repeat it to include multiple types. |

The response uses the same [game data model](/rock-odds-docs/data-model.md) as `GET /games`.

## Empty responses

An empty response is valid outside a sport's schedule or when no upcoming lines are available:

```json
{
  "count": 0,
  "games": []
}
```

Do not treat an empty `games` array as an authentication or server error.

## Rate limit

This endpoint allows up to 200 requests per minute per API key.
