Get several Polymarket markets
Get up to 100 Polymarket markets by condition id or token id.
Headers
Get your API keyAPI key (`sfk_...`)
Condition ids to look up. Repeat the parameter or separate ids with commas.
Outcome token ids to look up. Repeat the parameter or separate ids with commas.
Translate titles and market questions into this language. Descriptions stay in English.
one of: es, fr, de, ja, zh, ko, ru, hi, th, tr, vi, pt, it, pl, id, bn, uk, zh-hant, tl
Endpoint-specific response payload.
One entry per requested id, in request order.
Which kind of id was requested.
one of: conditionId, tokenId
The id as requested.
`not_found` when no market has this id.
one of: found, not_found
A yes/no (or multi-outcome) market with its prices and rules.
Market id.
Market slug.
The question the market asks.
Full resolution rules.
Condition id (0x and 64 hex digits). Null for a market without an order book.
Id of the event the market belongs to.
Slug of the event the market belongs to.
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
Whether Polymarket archived the market.
Label inside a multi-market event, for example a candidate name.
Image URL.
Icon URL.
The outcomes, in order, with their current prices.
Outcome name, for example `Yes`.
Outcome token id, used for order books, prices and price history. A decimal string.
Current price as a probability between 0 and 1. Null when the market is not trading.
Name of the outcome that won, once the market has closed with a clear winner.
Price of the last trade.
Highest buy price on the book.
Lowest sell price on the book.
Gap between best ask and best bid.
Change of the leading outcome price over several windows.
Price change over the last hour (probability points).
Price change over the last 24 hours.
Price change over the last 7 days.
Price change over the last 30 days.
Price change over the last 365 days.
Traded volume in US dollars over several windows.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 24 hours. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 7 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 30 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 365 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Current order book liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
When the market opens (ISO-8601, UTC).
Scheduled end (ISO-8601, UTC).
When the market closed (ISO-8601, UTC).
When the market was created (ISO-8601, UTC).
When the market was last changed (ISO-8601, UTC).
How and where the market resolves.
Where the outcome is decided, as written in the rules.
Oracle state: `proposed`, `disputed`, `resolved` and so on. Null before any proposal.
Address of the resolver contract.
Whether the market is part of a winner-takes-all group whose prices sum to about 100 percent.
Id of the winner-takes-all group.
Smallest order size in shares.
Smallest price step.
Trading fees on a market.
Whether trading fees apply.
Fee family, for example `politics_fees`.
Base fee for makers, in basis points.
Base fee for takers, in basis points.
Share of fees paid back to makers, in basis points.
How trading fees are worked out on a market.
Fee rate applied to the notional of a trade.
Exponent of the fee curve.
Whether only takers pay the fee.
Share of the fee returned to makers.
Settings of a short-lived up-or-down market on a crypto or commodity price.
Configuration id, for example `xau-15m`.
Asset the market tracks, for example `btc` or `xau`.
Length of each window, for example `15m`.
Whether the settlement price is a time-weighted average.
Seconds the average looks back.
Whether the order book accepts orders.
Whether a user rather than Polymarket created it.
Kind of sports market, for example `moneyline`. Null for other markets.
Spread or total line for a sports market.
Kickoff of the game a sports market covers (ISO-8601, UTC).
Liquidity rewards offered on a market.
Liquidity rewards paid per day, in US dollars.
Smallest order size that earns rewards, in shares.
Widest spread from the midpoint that earns rewards.
Counts across the batch.
Ids requested.
Ids that matched a market.
Ids that matched no market.
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/markets/batch?conditionIds=0x0f49db97f71c68b1e42a6d16e3de93d85dbf7d4148e3f018eb79e88554be9f75" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket markets batch.