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 (e.g., “Will candidate X win the election?”).
- 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 (e.g., “NFL MVP 2025”).
Subjects Endpoint
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | int32 | Maximum number of subjects to return |
offset | int32 | Number of subjects to skip for pagination |
Get Subject by ID
Response Fields
Each subject object includes:| Field | Type | Description |
|---|---|---|
id | integer | Subject ID |
name | string | Subject name |
displayName | string | Display name for rendering |
description | string | Subject description |
subjectType | string | Type of subject (see below) |
image | string | Subject image URL |
color | string | Primary color (hex) |
darkColor | string | Dark mode color (hex) |
Subject Types
| Type | Description |
|---|---|
nominee | A nominee in a non-sports event (e.g., political candidate, award nominee) |
player | An individual athlete (e.g., MVP candidate) |
team | A team entity used in futures markets |
candidate | A candidate in an election or competition |
Relationship to Markets
Each market can have an optionalsubjectId field that references a subject. When present, the subject provides the display metadata (name, image, colors) for that market. You can use the subject’s image and color fields to render market cards and lists with consistent branding.