List Polymarket events
List Polymarket events by volume, date, tag or title, with each event's markets.
Headers
Get your API keyAPI key (`sfk_...`)
Which items to list: `open` (default), `closed` (ended or resolved) or `all`. `open` is Polymarket's own flag and can outlast the end date.
one of: open, closed, all
Only events with this tag: a tag id or slug.
min 1 chars · max 120 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$
Words to find in event titles. Titles are English, so search in English.
min 1 chars · max 200 chars
Sort field. Default: `volume`.
one of: volume, volume24h, liquidity, startDate, endDate, createdAt, closedTime
Sort from smallest to largest. Default: false (largest first).
Only events Polymarket features (true) or only those it does not (false).
Only events in this series.
pattern: ^\d{1,10}$
Only events with at least this much volume (US dollars).
≥ 0 · ≤ 1000000000000000
Only events with at most this much volume (US dollars).
≥ 0 · ≤ 1000000000000000
Only events with at least this much liquidity.
≥ 0 · ≤ 1000000000000000
Only events starting on or after this date.
Only events starting on or before this date.
Only events ending on or after this date.
Only events ending on or before this date.
Translate titles and market questions into this language. Descriptions stay in English.
one of: es, fr, de, ja, zh, ko, ru, hi, th, tr, vi, pt, it, pl, id, bn, uk, zh-hant, tl
Events per page, 1–25. Default: 20. Each event carries all of its markets and the busiest hold hundreds, so a page stays small. Use `cursor` for the next page.
≥ 1 · ≤ 25
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`found` on success.
one of: found, not_found
Events in the requested order, each with its markets.
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.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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/events?status=open&limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket events.