List Polymarket perps leaderboard
List the Polymarket perps leaderboard by profit.
Headers
Get your API keyAPI key (`sfk_...`)
Time window. Default: `all`.
one of: day, week, month, all
Items per page, 1–100. Default: 100.
≥ 1 · ≤ 100
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.
one of: found, not_found
The window returned.
Accounts on the board in this window.
Rows from rank 1 down.
Position on the board, 1 is best.
Account address.
Profit in US dollars over the window. A number, or an exact decimal string when the value has more digits than a number can hold.
Traded notional in dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Account value in dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Return on investment as a fraction.
Instruments the account traded.
Ids of the account's most traded instruments.
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/leaderboard?window=week&limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket perps leaderboard.