Polymarket

List Polymarket perps tickers

List Polymarket perps prices, open interest and funding.

GET/v1/polymarket/perps/tickers
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
instrumentIdstringquery

Only this instrument. Default: all.

pattern: ^\d{1,6}$

Response fields
19

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when `instrumentId` matches no instrument.

one of: found, not_found

Tickers.

datatickers[]instrumentId
integer

Instrument id.

datatickers[]symbol
string

Trading symbol.

datatickers[]indexPrice
numbernullable

Price of the underlying index.

datatickers[]markPrice
numbernullable

Mark price used for margin.

datatickers[]lastPrice
numbernullable

Price of the last trade.

datatickers[]midPrice
numbernullable

Halfway between best bid and best ask.

datatickers[]openInterest

Open interest in contracts. A number, or an exact decimal string when the value has more digits than a number can hold.

datatickers[]longAccounts
integernullable

Accounts holding long positions.

datatickers[]shortAccounts
integernullable

Accounts holding short positions.

datatickers[]fundingRate
numbernullable

Funding rate for the current interval.

datatickers[]nextFundingAt
stringnullable

When funding is next paid (ISO-8601, UTC).

datatickers[]updatedAt
stringnullable

Time of this ticker snapshot (ISO-8601, UTC).

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/perps/tickers?instrumentId=1" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket perps tickers.