Skip to main content

​
Subjects API

The Subjects API provides access to subject information and their associated markets. Subjects represent the people, teams, or entities that a market is about, providing display metadata — names, images, and colors — for rendering market UIs.

​
When to Use Subjects vs Teams

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 sports futures — such as MVP awards, season win totals, and other futures that aren’t tied to a specific game (e.g., “NFL MVP 2025”).
For standard sports game markets (moneylines, spreads, totals), team data is attached directly to the event as participants via the Sports (Legacy) Teams endpoint rather than as subjects on the market. For more details, see the Subject Data and Sports Data pages.

​
Endpoints

MethodEndpointDescription
GET/v1/subjectsGet all subjects with filtering
GET/v1/subjects/{id}Get subject by ID
GET/v1/subjects/slug/{slug}Get subject by slug
GET/v1/subjects/{id}/marketsGet markets for a subject
GET/v1/subjects/slug/{slug}/marketsGet markets for a subject by slug