Headers
Get your API keyAPI key (`sfk_...`)
Perps instrument id from the instruments list.
pattern: ^\d{1,6}$
Start of the range, unix seconds. Default: 24 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.
Newest first.
Trade id.
When the trade happened (ISO-8601, UTC).
`long` or `short`.
Price.
Contracts traded. A number, or an exact decimal string when the value has more digits than a number can hold.
Whether the trade was a settlement.
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/trades" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket perps trades.