Skip to main content
GET
cURL
Use this endpoint to find graded wallets before requesting their full profiles. A grade reflects a wallet’s settled profit and loss relative to other tracked wallets. For Polymarket’s weekly or monthly P&L ranking, use Trending wallets.

Parameters

Key response fields

Since October 27, 2026, the entry no longer sends pnl, realized_pnl, pnl_correction or volume. They covered every Polymarket market the wallet traded, and wallet figures cover sports and esports markets only. The OpenAPI document keeps them, marked deprecated and x-never-sent.

When the cursor expires

A 400 with error.reason cursor_expired means the ranking was rebuilt, or the filters or activity changed, since the cursor was issued. Discard the rows you have collected, request page 1 with no cursor, and page forward again from there. There is no wait: retrying the same cursor will not start working. A cursor sent with a different sort or dir than the page it came from returns 400 with error.param cursor. Send the same sort and dir on every page, or start again from page 1.

Refreshing rankings

Any page, in any order, can return 503 with error.reason read_model_warming and Retry-After: 30 (also in error.retry_at). That happens only when the precomputed rankings every page reads are missing or were last checked 180 seconds ago or more; they normally come back within seconds to a few minutes. Wait the number of seconds Retry-After names, then send the same request again, and keep that retry out of any backoff you share with other routes. A 503 with no error.reason is the rate-limiter outage, a separate cause.

Sorting by edge

sort=edge lists the wallets whose price_edge.status is ranked and that have no price_edge.hold first, highest price_edge.edge first. Every other wallet sorts as having no edge, so it comes last, or first with dir=asc. An edge is ranked once it covers at least 30 markets and those markets match the wallet’s record. too_few_markets means fewer than 30, and sample_mismatch means the markets do not describe the record. A hold of record_incomplete means the wallet’s stored record shows more profit than Polymarket reports, so some losing markets are likely missing. The leaderboard page ranks the same wallets by their edge pulled toward the sports and esports average. The API does not send that adjusted figure, so the two orders can differ.

Example

The 20 Basketball wallets with the highest sports and esports P&L that traded in the last 30 days:

What it does not return

  • A wallet graded C, D, or F. This list holds S, A, and B only.
  • A live ranking. The ranking is rebuilt every 12 hours, and meta.ranking_as_of says when the one you are reading was built.
  • A win rate scoped to the category you filtered by.
  • An order by the P&L of one category. With category, sort=pnl still orders by the wallet’s whole sports and esports P&L.
  • A result for a cursor from an older format, a malformed cursor, or one carrying a non-finite number. All of those are rejected.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the page has not changed, the server returns 304 Not Modified with no body. The ETag covers which ranking the rows came from, so a rebuilt ranking can never answer a false 304.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Scopes

read

Read markets, traders, large trades, positions, reports, search, the event stream and every MCP tool

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
If-None-Match
string

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Query Parameters

limit
integer
default:20

Maximum number of ranked traders to return. Out-of-range values are clamped to 1..100.

Required range: 1 <= x <= 100
cursor
string

Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the effective category/strategy filters, and on a sorted page to its sort, dir and activity, and it names the leaderboard generation it was read at. A cursor from another sort or dir is a 400 bad_request on cursor; one from another activity, category or strategy is cursor_expired. A cursor from an earlier generation continues after its boundary in the current ranking (since 2026-11-07, #33377); meta.continued_from_generation is set when the ranking moved under it. Legacy, malformed, non-finite, and unsupported-version cursors are rejected.

category
string

Filter by category: a sport or esports bucket, matched case-insensitively. League values fold into their sport (NBA and NCAAB into Basketball, NFL into Football). Sports and esports only (#27306): a category outside them returns 400 bad_request with param category and names the accepted buckets. The word sports, in any casing, matches every sport but Esports, the provider's catch-all Sports category (cycling, lacrosse) included: use esports for Esports alone, or omit category for both (#32657).

strategy
enum<string>

Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The ten archetype keys retired on 2026-10-01 (accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader) are still accepted and match no wallet. Style describes recorded behavior; grade measures performance.

Available options:
category_focused,
diversified,
high_activity,
mixed,
two_sided,
unclassified
sort
enum<string>
default:rank

Order of the list, the sort columns of the site's leaderboard (/skill-leaderboard). rank (default) is the board's own order, the rank the site and the trader profile show. grade orders by score. volume orders by sports and esports USD volume, the figure GET /api/v1/trader/{address} serves as stats.total_volume. predictions orders by markets_traded. pnl orders by in_scope.realized_pnl. win_rate orders by win_rate among wallets with at least 5 decided sports and esports markets; a wallet with fewer sorts as having none. edge orders by price_edge.edge among wallets whose price_edge.status is ranked and that carry no price_edge.hold; any other wallet sorts as having none. The site's Edge column ranks those same wallets by their edge pulled toward the sports and esports average, a figure the API does not send, so the two orders can differ. A wallet without the value sorts as the lowest, so last in the natural direction and first with the direction reversed. Ties fall to address ascending. With ?category= a sort still orders by these whole-record figures; the category only decides which wallets are listed. Since 2026-11-02 (#32237; edge, #32270).

Available options:
rank,
grade,
volume,
predictions,
pnl,
win_rate,
edge
dir
enum<string>

Direction of sort. Omitted, each sort reads in its natural direction: rank 1 first for rank (asc), largest first for every other sort (desc). The opposite value reverses the list. Since 2026-11-02 (#32237).

Available options:
asc,
desc
activity
enum<string>
default:all

Limit the list to wallets by recent trading, the site leaderboard's split. active: the wallet's last trade, as its current grade recorded it and aged to today, is 30 days old or less. inactive: older than 30 days, or no trade on record. all (default): every ranked wallet. Since 2026-11-02 (#32237).

Available options:
all,
active,
inactive

Response

Ranked trader list

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
meta
object
required
next_cursor
string
total
integer

Total matching rows when the read model exposes a count; the key is absent when it does not.

summary
object

The whole board's totals, the counts the 0xinsider leaderboard page shows (#32737), read with the ranking snapshot the page is served at. Sent on every page of a request with no category and no strategy, whatever its sort, dir and activity, which order or split the same wallets. Omitted on a category or strategy page, which lists a subset these totals do not describe, and while the ranking has no totals for the served generation.