List Polymarket perps candles
List Polymarket perps candles for one instrument.
Headers
Get your API keyAPI key (`sfk_...`)
Perps instrument id from the instruments list.
pattern: ^\d{1,6}$
Candle length. Default: `1h`.
one of: 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d, 1w
Start of the range, unix seconds. Default: 48 hours before `to`.
≥ 1 · ≤ 4102444800
End of the range, unix seconds. Default: now.
≥ 1 · ≤ 4102444800
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`found` on success. An id that matches no instrument returns an empty list.
one of: found, not_found
The instrument asked for.
Candle length returned.
Oldest first.
Start of the candle (ISO-8601, UTC).
Opening price.
Highest price.
Lowest price.
Closing price.
Volume in contracts. A number, or an exact decimal string when the value has more digits than a number can hold.
Number of trades.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/perps/instruments/1/klines?interval=1h" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket perps candles.