Polymarket

List Polymarket US events

List events on the separate Polymarket US exchange with their markets.

GET/v1/polymarket/us/events
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
statusstringquery

Which events to list: `open` (default) or `closed`.

one of: open, closed

limitintegerquery

Events per page, 1–100. Default: 20. Each event carries all its markets; pages shift as events open or close, so de-duplicate by `id`.

≥ 1 · ≤ 100

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.

min 1 chars · max 6000 chars

Response fields
55

Endpoint-specific response payload.

datalookupStatus
string

`found` on success.

one of: found, not_found

Events.

dataevents[]id
string

Event id.

dataevents[]slug
string

Event slug.

dataevents[]title
string

Event title.

dataevents[]description
stringnullable

Event description.

dataevents[]category
stringnullable

Category, for example `sports`.

dataevents[]status
string

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

dataevents[]active
boolean

Whether the event is active.

dataevents[]closed
boolean

Whether the event has closed.

dataevents[]archived
boolean

Whether the event is archived.

dataevents[]live
booleannullable

Whether a game is in play.

dataevents[]period
stringnullable

Current period of the game.

dataevents[]image
stringnullable

Image URL.

dataevents[]seriesSlug
stringnullable

Slug of the series the event belongs to.

dataevents[]startsAt
stringnullable

Start (ISO-8601, UTC).

dataevents[]endsAt
stringnullable

Scheduled end (ISO-8601, UTC).

dataevents[]updatedAt
stringnullable

When the event was last changed (ISO-8601, UTC).

Tags.

dataevents[]tags[]id
string

Tag id.

dataevents[]tags[]label
string

Tag name, for example `Politics`.

dataevents[]tags[]slug
string

Tag slug.

dataevents[]marketCount
integer

Markets in the event.

The event's markets.

dataevents[]markets[]id
string

Market id.

dataevents[]markets[]slug
string

Market slug.

dataevents[]markets[]question
string

The question the market asks.

dataevents[]markets[]title
stringnullable

Short title.

dataevents[]markets[]description
stringnullable

Resolution rules.

dataevents[]markets[]category
stringnullable

Category, for example `sports`.

dataevents[]markets[]marketType
stringnullable

Kind of market, for example `moneyline`.

dataevents[]markets[]status
string

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

dataevents[]markets[]state
stringnullable

The exchange's own state, for example `OPEN`.

dataevents[]markets[]active
boolean

Whether the market is active.

dataevents[]markets[]closed
boolean

Whether the market has closed.

dataevents[]markets[]image
stringnullable

Image URL.

dataevents[]markets[]startsAt
stringnullable

When the market opens (ISO-8601, UTC).

dataevents[]markets[]endsAt
stringnullable

Scheduled end (ISO-8601, UTC).

dataevents[]markets[]gameStartsAt
stringnullable

Kickoff of the game the market covers (ISO-8601, UTC).

dataevents[]markets[]tickSize
numbernullable

Smallest price step.

The sides.

dataevents[]markets[]outcomes[]name
string

Outcome name.

dataevents[]markets[]outcomes[]price
numbernullable

Price in dollars, 0 to 1.

dataevents[]markets[]outcomes[]long
booleannullable

Whether this is the side that pays out if the question is yes.

dataevents[]markets[]outcomes[]team
stringnullable

Team the outcome is about, for sports markets.

dataevents[]markets[]bestBid
numbernullable

Highest buy price.

dataevents[]markets[]bestAsk
numbernullable

Lowest sell price.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/us/events?status=open&limit=5" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket US events.