Get Polymarket event
Get a Polymarket event with all its markets, prices and resolution rules.
Headers
Get your API keyAPI key (`sfk_...`)
Event id (digits) or slug, as in polymarket.com/event/{slug}.
min 1 chars · max 300 chars · pattern: ^[A-Za-z0-9_]+(?:-[A-Za-z0-9_]+)*$
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
Extras to add, comma separated: `insights` (the written market context) and `annotations` (dated explanations of price moves). Each is one extra lookup and can be absent, in which case it is null.
any of: insights, annotations (comma-separated)
Endpoint-specific response payload.
`not_found` when no event has this id or slug.
one of: found, not_found
An event with its full 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 with full detail.
Market id.
Market slug.
The question the market asks.
Full resolution rules.
Condition id (0x and 64 hex digits). Null for a market without an order book.
Id of the event the market belongs to.
Slug of the event the market belongs to.
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 market.
Label inside a multi-market event, for example a candidate name.
Image URL.
Icon URL.
The outcomes, in order, 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.
Name of the outcome that won, once the market has closed with a clear winner.
Price of the last trade.
Highest buy price on the book.
Lowest sell price on the book.
Gap between best ask and best bid.
Change of the leading outcome price over several windows.
Price change over the last hour (probability points).
Price change over the last 24 hours.
Price change over the last 7 days.
Price change over the last 30 days.
Price change over the last 365 days.
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 order book liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
When the market opens (ISO-8601, UTC).
Scheduled end (ISO-8601, UTC).
When the market closed (ISO-8601, UTC).
When the market was created (ISO-8601, UTC).
When the market was last changed (ISO-8601, UTC).
How and where the market resolves.
Where the outcome is decided, as written in the rules.
Oracle state: `proposed`, `disputed`, `resolved` and so on. Null before any proposal.
Address of the resolver contract.
Whether the market is part of a winner-takes-all group whose prices sum to about 100 percent.
Id of the winner-takes-all group.
Smallest order size in shares.
Smallest price step.
Trading fees on a market.
Whether trading fees apply.
Fee family, for example `politics_fees`.
Base fee for makers, in basis points.
Base fee for takers, in basis points.
Share of fees paid back to makers, in basis points.
How trading fees are worked out on a market.
Fee rate applied to the notional of a trade.
Exponent of the fee curve.
Whether only takers pay the fee.
Share of the fee returned to makers.
Settings of a short-lived up-or-down market on a crypto or commodity price.
Configuration id, for example `xau-15m`.
Asset the market tracks, for example `btc` or `xau`.
Length of each window, for example `15m`.
Whether the settlement price is a time-weighted average.
Seconds the average looks back.
Whether the order book accepts orders.
Whether a user rather than Polymarket created it.
Kind of sports market, for example `moneyline`. Null for other markets.
Spread or total line for a sports market.
Kickoff of the game a sports market covers (ISO-8601, UTC).
Liquidity rewards offered on a market.
Liquidity rewards paid per day, in US dollars.
Smallest order size that earns rewards, in shares.
Widest spread from the midpoint that earns rewards.
The market context text. Null unless requested with `include=insights`, or when the event has none.
A written summary of the news and context behind the event's prices. Machine written; dates inside it may be old.
When the text was written (ISO-8601, UTC).
Dated price-move explanations. Null unless requested with `include=annotations`, or when unavailable.
When the price moved (ISO-8601, UTC).
Headline of the explanation.
What happened and why the price moved.
The outcome whose price moved.
Price before the move (0 to 1).
Price after the move (0 to 1).
Size of the move.
News articles cited for the move.
Publisher name.
Link to the article.
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/democratic-presidential-nominee-2028" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket event.