Subjects API
The Subjects API provides access to subject entities that are attached to markets. Subjects represent the people, teams, or entities that a market is about.When Are Subjects Used?
Subjects are attached to markets in two cases:- Non-sports markets — political candidates, nominees, public figures, and other entities featured in event-driven markets.
- Non-championship futures markets for sports — such as MVP awards, season win totals, and other futures that aren’t tied to a specific game or championship outcome.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/subjects | Get all subjects |
GET | /v1/subjects/{id} | Get subject by ID |
Subject Fields
| Field | Type | Description |
|---|---|---|
id | integer | Subject ID |
name | string | Subject name |
displayName | string | Display name |
description | string | Subject description |
subjectType | string | Type: nominee, player, team, or candidate |
image | string | Subject image URL |
color | string | Subject color |
darkColor | string | Subject dark mode color |
Pagination
| Parameter | Type | Description |
|---|---|---|
limit | integer | Maximum results per page |
offset | integer | Number of results to skip |