Social Fetch
Start for freeStart free
Polymarket hub

Polymarket US Event API

One US exchange event by id or slug, with its markets and live state.

GET /v1/polymarket/us/events/{idOrSlug}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/us/events/{idOrSlug} returns data.event for the Polymarket US exchange. The event has id, slug, title, description, category, status, active, closed, archived, live, period, image, seriesSlug, dates, tags, marketCount and markets[]. A live game sets live and period; a market row carries state, active, closed, outcomes[] with name, price, long and team, plus best bid and best ask.

An unknown id or slug returns lookupStatus: not_found with event: null. US event references are not the same ids as the main event market.

Polymarket US Event API FAQ

Can I use a main Polymarket event id here?

No. The US exchange has its own event ids and slugs. Use the US events list to find them. A main market id will not match a US event.

What does live mean?

A game is in play and period shows the current period. A live event can still have closed markets, so read each market's active and closed flags rather than assuming the whole event is tradeable.

What is the long flag on an outcome?

It marks the side that pays out if the question is yes. In a two-sided sports market, the other side is the complement. Use it together with team and price.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Polymarket endpoints