> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/polymarket/us-events-idorslug>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/polymarket/us-events-idorslug.mdx>

---

# Polymarket US Event API

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

`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.

## Request

- **Endpoint:** `GET /v1/polymarket/us/events/{idOrSlug}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by id or slug
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/polymarket/us/events/idorslug/get)
- **Platform page:** [/platforms/polymarket](https://www.socialfetch.dev/platforms/polymarket)

## 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.