Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt

Use this file to discover all available pages before exploring further.

​
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 Sports Data page.

​
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