Get Polymarket US market
Get one market on the Polymarket US exchange, with its order book on request.
Headers
Get your API keyAPI key (`sfk_...`)
US exchange market id (digits) or slug.
min 1 chars · max 200 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$
`book` adds the order book (one more lookup).
any of: book (comma-separated)
Endpoint-specific response payload.
`not_found` when no market has this id or slug.
one of: found, not_found
A market on the Polymarket US exchange.
Market id.
Market slug.
The question the market asks.
Short title.
Resolution rules.
Category, for example `sports`.
Kind of market, for example `moneyline`.
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
The exchange's own state, for example `OPEN`.
Whether the market is active.
Whether the market has closed.
Image URL.
When the market opens (ISO-8601, UTC).
Scheduled end (ISO-8601, UTC).
Kickoff of the game the market covers (ISO-8601, UTC).
Smallest price step.
The sides.
Outcome name.
Price in dollars, 0 to 1.
Whether this is the side that pays out if the question is yes.
Team the outcome is about, for sports markets.
Highest buy price.
Lowest sell price.
The order book. Null unless requested with `include=book`.
Best (highest) first.
Price in dollars, 0 to 1.
Shares at this price.
Best (lowest) first.
Price in dollars, 0 to 1.
Shares at this price.
Price of the last trade.
Open interest in shares. A number, or an exact decimal string when the value has more digits than a number can hold.
Shares traded. A number, or an exact decimal string when the value has more digits than a number can hold.
Dollars traded. A number, or an exact decimal string when the value has more digits than a number can hold.
Highest price today.
Lowest price today.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/us/markets/425746?include=book" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket US market.