> **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-markets-idorslug>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/polymarket/us-markets-idorslug.mdx>

---

# Polymarket US Market API

One US exchange market, with an optional order book and trading stats.

`GET /v1/polymarket/us/markets/{idOrSlug}` returns `data.market` for the Polymarket US exchange. The market has `id`, `slug`, `question`, `title`, `description`, `category`, `marketType`, `status`, `state` (the exchange's own value such as `OPEN`), `active`, `closed`, `image`, dates, `tickSize`, `outcomes[]` with `name`, `price`, `long` and `team`, `bestBid` and `bestAsk`.

Pass `include=book` to add `data.book`, with `bids`, `asks`, `lastTradePrice`, `openInterest`, `volumeShares`, `volume`, `highPrice` and `lowPrice`. The book is one more lookup and is null without the include. An unknown id or slug returns `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/polymarket/us/markets/{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/markets/idorslug/get)
- **Platform page:** [/platforms/polymarket](https://www.socialfetch.dev/platforms/polymarket)

## FAQ

### How do I get the order book?

Pass include=book. The book carries bids and asks plus trading statistics such as open interest and daily high and low. Without the include, data.book is null and the market fields are still returned.

### What is the difference between status and state?

status is the shared open, closed or inactive value normalised across Social Fetch. state is the US exchange's own value such as OPEN. Read status for portable logic and state when you need the exchange's wording.

### Are prices probabilities or dollars?

Outcome prices are in dollars from 0 to 1, which reads the same as a probability. The book uses the same scale. Volume fields are dollars, and volumeShares is in shares.

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