Polymarket

Get Polymarket market statistics

Get a Polymarket market's open interest and taker volume.

GET/v1/polymarket/markets/{conditionId}/stats
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
conditionIdstringrequiredpath

Condition id of the market: 0x followed by 64 hex digits.

pattern: ^0x[0-9a-fA-F]{64}$

Response fields
11

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no market has this condition id.

one of: found, not_found

dataconditionId
string

The condition id asked for.

dataopenInterest

Value of all open positions in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datatakerVolume

Volume traded by takers in this market, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

dataeventId
stringnullable

Id of the event the market belongs to.

dataeventTakerVolume

Taker volume of the whole event, across all its markets. A number, or an exact decimal string when the value has more digits than a number can hold.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/markets/0x0f49db97f71c68b1e42a6d16e3de93d85dbf7d4148e3f018eb79e88554be9f75/stats" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket market stats.