Polymarket

List Polymarket perps instruments

List Polymarket's perpetual futures instruments with leverage limits.

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

API key (`sfk_...`)

Parameters
1
categorystringquery

Only instruments of this kind.

one of: index, commodity, crypto, equity, pre_ipo

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

`found` on success.

one of: found, not_found

Instruments.

datainstruments[]id
integer

Instrument id.

datainstruments[]symbol
string

Trading symbol, for example `SP500-USD`.

datainstruments[]displaySymbol
stringnullable

Symbol as Polymarket displays it.

datainstruments[]category
stringnullable

`index`, `commodity`, `crypto`, `equity` or `pre_ipo`.

datainstruments[]baseAsset
stringnullable

Asset the contract tracks.

datainstruments[]quoteAsset
stringnullable

Currency the contract is priced in.

datainstruments[]fundingInterval
stringnullable

How often funding is paid, for example `1h`.

datainstruments[]maxLeverage
integernullable

Highest leverage offered.

datainstruments[]minNotional

Smallest order value in dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datainstruments[]closeOnly
booleannullable

Whether only closing orders are accepted.

datainstruments[]isolatedOnly
booleannullable

Whether only isolated margin is allowed.

datainstruments[]priceDecimals
integernullable

Decimals in prices.

datainstruments[]quantityDecimals
integernullable

Decimals in quantities.

Leverage limits by position size.

datainstruments[]riskTiers[]fromNotional

Position value from which the tier applies, dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datainstruments[]riskTiers[]maxLeverage
integernullable

Highest leverage in the tier.

datainstruments[]logoLight
stringnullable

Logo URL for light backgrounds.

datainstruments[]logoDark
stringnullable

Logo URL for dark backgrounds.

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/instruments?category=index" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket perps instruments.