List Polymarket leaderboard
List Polymarket's leaderboard by profit or volume, by window and category.
Headers
Get your API keyAPI key (`sfk_...`)
Time window. Default: `all`.
one of: day, week, month, all
Only this category, for example `sports`, `crypto` or `politics`. An unknown category returns an empty list.
pattern: ^[a-z0-9][a-z0-9_-]{0,40}$
Rank by profit (`pnl`, default) or traded volume (`volume`).
one of: pnl, volume
Return this wallet's rank instead of the board: one row with `rankPnl` and `rankVolume`. A wallet that is not on the board for this window and category returns an empty list.
pattern: ^0x[0-9a-fA-F]{40}$
Items per page, 1–1000. Default: 100.
≥ 1 · ≤ 1000
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
Rows from rank 1 down.
Position on the board, 1 is best. On a wallet lookup it is the rank for the sortBy you asked for.
The wallet's rank by profit. Only on a wallet lookup; null on a board row.
The wallet's rank by traded volume. Only on a wallet lookup; null on a board row.
Wallet address.
Chosen username or auto-generated name.
Profile image URL.
Linked X (Twitter) handle.
Whether Polymarket verified the profile.
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 volume in US dollars. Polymarket reports 0 for a few rows whose volume is not known. A number, or an exact decimal string when the value has more digits than a number can hold.
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/leaderboard?window=week&limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket leaderboard.