> ## 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 Overview

> Query subjects and their associated markets

# 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](/api-reference/sports-legacy/overview) rather than as subjects on the market.

For more details, see the [Sports Data](/data-guide/sports-data) page.

## Endpoints

| Method | Endpoint                           | Description                       |
| ------ | ---------------------------------- | --------------------------------- |
| `GET`  | `/v1/subjects`                     | Get 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}/markets`        | Get markets for a subject         |
| `GET`  | `/v1/subjects/slug/{slug}/markets` | Get markets for a subject by slug |