---
title: "Get market participants"
method: GET
path: "/api/v2/markets/participants"
tags: ["V2 Markets"]
---

# Get market participants

`GET /api/v2/markets/participants`

## Request

- Base URL: `https://therundown.io`
- URL: `https://therundown.io/api/v2/markets/participants`
- Auth: API key in header `X-TheRundown-Key`

Lists teams, players, or result sides for the requested event and markets. Use `participant_id` from this response, rather than `id`, to filter a participant-specific chart. Market `3` totals use `TYPE_RESULT` Over and Under participants, while markets `1` and `2` use `TYPE_TEAM` participants. For example, discover totals with `GET /api/v2/markets/participants?event_id=733a06aa4f4f2a3af7872c3667a60f22&market_ids=3&participant_type=TYPE_RESULT`, then request each discovered side from `GET /api/v2/events/{eventID}/markets/{marketID}/history`.

## Query parameters

- `market_ids` string
- `event_id` string, required
- `participant_ids` string
- `participant_type` 'TYPE_TEAM' | 'TYPE_PLAYER' | 'TYPE_RESULT'

## Response `200`

Market participants

- MarketParticipantsResponse
  - `participants` MarketParticipant[]
    - `id` integer
    - `market_event_id` integer
    - `participant_id` integer
    - `participant_type` 'TYPE_TEAM' | 'TYPE_PLAYER' | 'TYPE_RESULT'
    - `participant_name` string
    - `updated_at` string, date-time

## Changes

- **2026-09-10** `75e26606912e`: 2 breaking, 2 info
  - the `query` request parameter `event_id` became required
  - for the `query` request parameter `market_ids`, default value `1,2,3` was added
  - added the new optional `query` request parameter `participant_ids`
  - added the new optional `query` request parameter `participant_type`

[Operation history](https://skmtc.dev/therundown/apis/therundown-sports-api/changes/api/v2/markets/participants/get.md)

---

[API](https://skmtc.dev/therundown/apis/therundown-sports-api.md) - [All operations](https://skmtc.dev/therundown/apis/therundown-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/therundown/apis/therundown-sports-api/revisions/b1735c57a340?raw)