Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Market Stats API

Open interest and taker volume for one market, next to the event total.

GET /v1/polymarket/markets/{conditionId}/stats

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/markets/{conditionId}/stats returns data.openInterest (the dollar value of all open positions), data.takerVolume (volume traded by takers in this market), data.eventId and data.eventTakerVolume (taker volume for the whole event). Money values are a number, or an exact decimal string when the figure has more digits than a number holds.

The route is keyed by condition id only. An unknown condition id returns lookupStatus: not_found.

Polymarket Market Stats API FAQ

What is the difference between market and event taker volume?

takerVolume counts fills in this market only. eventTakerVolume sums every market in the event, so it is always at least the market figure. Use the pair to see how much of an event's activity sits in one market.

Why is a value sometimes a string?

Money and size fields return a number when the value fits, and the exact decimal text when it has more digits than a number can hold. Parse both forms as a decimal, not as an integer.

Is open interest the same as liquidity?

No. Open interest is the value of positions currently open. Liquidity is the order book depth available to trade, and it lives on the market record. They answer different questions.

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.

Other Polymarket endpoints