Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Perps Leaderboard API

Top Perps accounts by profit, with ROI and trading activity.

GET /v1/polymarket/perps/leaderboard

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/perps/leaderboard returns data.entries, rows from rank 1 down. Each row has rank, account, pnl, notional, accountValue, roi (a fraction), instrumentsTraded and topInstrumentIds. data.window and data.totalAccounts describe the board, and data.page continues it.

window is day, week, month or all and defaults to all. limit is 1 to 100 and defaults to 100. The board stops at rank 1000 whatever the window. This is a separate board from the event market leaderboard.

Polymarket Perps Leaderboard API FAQ

How is roi expressed?

As a fraction, not a percent. A roi of 0.25 is 25 percent. pnl is in US dollars and notional is the dollars traded over the window.

Why is the board capped at 100?

The page size caps at 100. The board itself stops at rank 1000, so paging cannot go beyond that depth. Use the window to see a different slice.

What are topInstrumentIds?

The numeric ids of the instruments the account traded most in the window. Use them with the Perps instruments, tickers or klines routes.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Polymarket endpoints