Get Polymarket series
Get one Polymarket series and, on request, its recent events.
Headers
Get your API keyAPI key (`sfk_...`)
Series id (digits) or slug.
min 1 chars · max 300 chars · pattern: ^[A-Za-z0-9_]+(?:-[A-Za-z0-9_]+)*$
Add the series' most recent events with their markets' headline numbers (one more lookup). Default: false.
Endpoint-specific response payload.
`not_found` when no series has this id or slug.
one of: found, not_found
A series of related events, such as a league season.
Series id.
Series slug.
Series title.
Kind of series, for example `single`.
How often a new event is added: `daily`, `weekly`, `monthly` and so on.
Series description.
Image URL.
Icon URL.
Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.
one of: open, closed, inactive
Whether the series is active.
Whether the series has ended.
Whether the series is archived.
Whether Polymarket features the series.
Traded volume of the series' events in US dollars. Polymarket reports the all-time and 24-hour figures for a series; the other windows are null.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 24 hours. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 7 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 30 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 365 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Number of comments on the series.
When the series starts (ISO-8601, UTC).
When the series was created (ISO-8601, UTC).
When the series was last changed (ISO-8601, UTC).
The series' events, newest end date first. Null unless requested with `includeEvents`.
Event id.
Event slug, as in polymarket.com/event/{slug}.
Link to the event on polymarket.com.
Event title.
Event description and resolution rules.
Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.
one of: open, closed, inactive
Whether Polymarket archived the event.
Whether Polymarket features the event.
Image URL.
Icon URL.
When the event starts (ISO-8601, UTC).
Scheduled end (ISO-8601, UTC).
When the event closed (ISO-8601, UTC).
When the event was created (ISO-8601, UTC).
When the event was last changed (ISO-8601, UTC).
Traded volume in US dollars over several windows.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 24 hours. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 7 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 30 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 365 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Value of all open positions in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Number of comments.
How close the leading outcomes are, 0 to 1.
Whether the markets form a winner-takes-all group whose prices sum to about 100 percent.
Whether a user rather than Polymarket created it.
Where the outcome is decided.
Extra details Polymarket attaches to some events.
For an up-or-down market: the price the outcome is measured against.
For an up-or-down market: the price it settled at.
Game id of a sports event.
League or competition.
Tier of the league.
Tournament or stage.
When the event was first scheduled to start (ISO-8601, UTC).
Number of markets in the event.
Topic tags.
Tag id.
Tag name, for example `Politics`.
Tag slug.
When the tag was created (ISO-8601, UTC).
When the tag was last changed (ISO-8601, UTC).
Series the event belongs to.
Series id.
Series slug.
Series title.
Game details on a sports event.
Game id.
League code, for example `lal`.
League name.
Current score, for example `1-0`.
Current period of the game.
Elapsed game time.
Whether the game is in play.
Whether the game has ended.
Kickoff (ISO-8601, UTC).
Week of the season.
The teams playing.
Team id.
Team name.
Short code.
Win-loss record.
Logo URL.
`home` or `away`.
The event's markets, headline numbers only.
Market id.
Market slug.
The question the market asks.
Condition id.
Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.
one of: open, closed, inactive
Label inside a multi-market event.
Outcomes with their current prices.
Outcome name, for example `Yes`.
Outcome token id, used for order books, prices and price history. A decimal string.
Current price as a probability between 0 and 1. Null when the market is not trading.
Price of the last trade.
Highest buy price on the book.
Lowest sell price on the book.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/series/nfl?includeEvents=true" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket series detail.