---
title: "Live or prematch markets for one sport"
method: GET
path: "/kit/v1/markets"
---

# Live or prematch markets for one sport

`GET /kit/v1/markets`

## Request

- Base URL: `https://pinnodds.com`
- URL: `https://pinnodds.com/kit/v1/markets`
- Auth: API key in header `x-api-key`

Full board for a sport. Sport ids: Soccer=1, Tennis=2, Basketball=3, Hockey=4, Football=5, Baseball=6, Rugby=7, MMA=8, Boxing=9, Other=10 (Volleyball+Handball combined), Esports=11, Golf=12, Cricket=13, Volleyball=14, Handball=15. Ids 14 and 15 are narrower views of 10 and overlap it — requesting 10, 14 and 15 returns those events twice.

## Query parameters

- `sport_id` integer, required
- `event_type` 'live' | 'prematch'
- `since` integer
- `include_specials` '1' | 'nested'

## Response `200`

Board envelope: sport_id, sport_name, last (cursor), events[]

- object

## Other responses

- `401`: Missing or invalid API key
- `429`: Plan rate limit hit; retry_after_ms in the body

---

[API](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api.md) · [All operations](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api/revisions/090bad848c9b?raw)