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 represent the people, teams, or entities that a market is about. They provide display metadata — names, images, and colors — for rendering market UIs.
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”).
For standard sports game markets (moneylines, spreads, totals), participants and teams are attached directly to the event rather than as subjects on the market. See Sports Data for team data.
Subjects Endpoint
GET https://gateway.polymarket.us/v1/subjects
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 Slug
GET https://gateway.polymarket.us/v1/subjects/slug/{slug}
Get Markets for a Subject
GET https://gateway.polymarket.us/v1/subjects/slug/{slug}/markets
Response Fields
Each subject object includes:
| Field | Type | Description |
|---|
slug | string | Subject slug (stable identifier used in URLs and references) |
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 optional subjectSlug 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.
