Polymarket

List Polymarket perps leaderboard

List the Polymarket perps leaderboard by profit.

GET/v1/polymarket/perps/leaderboard
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
windowstringquery

Time window. Default: `all`.

one of: day, week, month, all

limitintegerquery

Items per page, 1–100. Default: 100.

≥ 1 · ≤ 100

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.

min 1 chars · max 6000 chars

Response fields
21

Endpoint-specific response payload.

datalookupStatus
string

`found` on success.

one of: found, not_found

datawindow
string

The window returned.

datatotalAccounts
integernullable

Accounts on the board in this window.

Rows from rank 1 down.

dataentries[]rank
integer

Position on the board, 1 is best.

dataentries[]account
string

Account address.

dataentries[]pnl

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.

dataentries[]notional

Traded notional in dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

dataentries[]accountValue

Account value in dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

dataentries[]roi
numbernullable

Return on investment as a fraction.

dataentries[]instrumentsTraded
integernullable

Instruments the account traded.

Ids of the account's most traded instruments.

dataentries[]topInstrumentIds[]
integeroptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

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.