Polymarket

Get Polymarket US event

Get one event on the Polymarket US exchange with its markets.

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

API key (`sfk_...`)

Parameters
1
idOrSlugstringrequiredpath

US exchange event id (digits) or slug.

min 1 chars · max 200 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$

Response fields
52

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no event has this id or slug.

one of: found, not_found

An event on the Polymarket US exchange.

dataeventid
string

Event id.

dataeventslug
string

Event slug.

dataeventtitle
string

Event title.

dataeventdescription
stringnullable

Event description.

dataeventcategory
stringnullable

Category, for example `sports`.

dataeventstatus
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

dataeventactive
boolean

Whether the event is active.

dataeventclosed
boolean

Whether the event has closed.

dataeventarchived
boolean

Whether the event is archived.

dataeventlive
booleannullable

Whether a game is in play.

dataeventperiod
stringnullable

Current period of the game.

dataeventimage
stringnullable

Image URL.

dataeventseriesSlug
stringnullable

Slug of the series the event belongs to.

dataeventstartsAt
stringnullable

Start (ISO-8601, UTC).

dataeventendsAt
stringnullable

Scheduled end (ISO-8601, UTC).

dataeventupdatedAt
stringnullable

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

Tags.

dataeventtags[]id
string

Tag id.

dataeventtags[]label
string

Tag name, for example `Politics`.

dataeventtags[]slug
string

Tag slug.

dataeventmarketCount
integer

Markets in the event.

The event's markets.

dataeventmarkets[]id
string

Market id.

dataeventmarkets[]slug
string

Market slug.

dataeventmarkets[]question
string

The question the market asks.

dataeventmarkets[]title
stringnullable

Short title.

dataeventmarkets[]description
stringnullable

Resolution rules.

dataeventmarkets[]category
stringnullable

Category, for example `sports`.

dataeventmarkets[]marketType
stringnullable

Kind of market, for example `moneyline`.

dataeventmarkets[]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

dataeventmarkets[]state
stringnullable

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

dataeventmarkets[]active
boolean

Whether the market is active.

dataeventmarkets[]closed
boolean

Whether the market has closed.

dataeventmarkets[]image
stringnullable

Image URL.

dataeventmarkets[]startsAt
stringnullable

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

dataeventmarkets[]endsAt
stringnullable

Scheduled end (ISO-8601, UTC).

dataeventmarkets[]gameStartsAt
stringnullable

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

dataeventmarkets[]tickSize
numbernullable

Smallest price step.

The sides.

dataeventmarkets[]outcomes[]name
string

Outcome name.

dataeventmarkets[]outcomes[]price
numbernullable

Price in dollars, 0 to 1.

dataeventmarkets[]outcomes[]long
booleannullable

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

dataeventmarkets[]outcomes[]team
stringnullable

Team the outcome is about, for sports markets.

dataeventmarkets[]bestBid
numbernullable

Highest buy price.

dataeventmarkets[]bestAsk
numbernullable

Lowest sell price.

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/81089" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket US event.