List Polymarket markets
List Polymarket markets by volume, liquidity, tag or ids, with prices and rules.
Headers
Get your API keyAPI key (`sfk_...`)
Which markets to list: `open` (default) or `closed`. When you filter by `conditionIds` or `tokenIds` and omit this, open and closed markets are both searched.
one of: open, closed
Only markets with this tag id. Find ids with the tags list.
pattern: ^\d{1,10}$
Sort field. Default: `volume`.
one of: volume, volume24h, liquidity, startDate, endDate, createdAt, closedTime
Sort from smallest to largest. Default: false (largest first).
Only markets with at least this much volume (US dollars).
≥ 0 · ≤ 1000000000000000
Only markets with at most this much volume (US dollars).
≥ 0 · ≤ 1000000000000000
Only markets with at least this much liquidity.
≥ 0 · ≤ 1000000000000000
Only markets with at most this much liquidity.
≥ 0 · ≤ 1000000000000000
Only these markets, by condition id, up to 50. Repeat the parameter or separate ids with commas. For more ids use the batch endpoint.
Only the markets these outcome tokens belong to, up to 30. Repeat the parameter or separate ids with commas. For more ids use the batch endpoint.
Only sports markets of this kind, such as `moneyline`.
pattern: ^[a-z0-9_]{1,60}$
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
Items per page, 1–100. Default: 50.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`found` on success.
one of: found, not_found
Markets in order.
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.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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?status=open&limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket markets.