Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Perps Instruments API

The perpetual futures contracts available, with position limits and risk tiers.

GET /v1/polymarket/perps/instruments

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/perps/instruments returns data.instruments. Each instrument has id, symbol, displaySymbol, category (index, commodity, crypto, equity or pre_ipo), baseAsset, quoteAsset, fundingInterval, maxLeverage, minNotional, closeOnly, isolatedOnly, priceDecimals, quantityDecimals, riskTiers and logo URLs.

Pass category to list one kind. Use the numeric id on the tickers, klines, book and trades routes. Perps are a separate product from the event markets under /v1/polymarket/events.

Polymarket Perps Instruments API FAQ

What is a risk tier?

A position limit by size. Each tier has a fromNotional value and a maxLeverage. Larger positions fall into later tiers with a lower maximum.

How do I get prices for an instrument?

Call GET /v1/polymarket/perps/tickers, optionally with instrumentId. For candles use the klines route, and for resting depth use the book route. All of them take the numeric instrument id from this list.

What does closeOnly mean?

The instrument accepts only orders that reduce an existing position. It does not mean the instrument is closed. Check the ticker if you need current trading state.

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