Board

Ranked entities with filters

Entities ranked by PnL. Unbought entities appear as handles with their unlock price (revealCents). No key: 20-row sample. With a key: up to 200 rows a call; each call spends limit rows of a 20,000/day allowance (403 when used up). mine=1 lists your unlocked addresses, free. Never charges.

get/v1/leaderboard

Request

  • Base URL: https://api.pmwallets.com
  • URL: https://api.pmwallets.com/v1/leaderboard
  • Auth: one of:
    • none
    • API key in header x-api-key

Query parameters

periodstring

Window id from GET /v1/periods (30d or 7d). Default 30d. Unknown → 400.

sort'realizedPnl' | 'roiOnBuys' | 'eligible' | 'winsLosses' | 'nFills' | 'conditions' | 'grossBuyUsdc' | 'unrealizedPnl' | 'winLo' | 'fillsPerDay' | 'lastFill'

Order column. Default realizedPnl; an unknown value falls back to realizedPnl.

dir'asc' | 'desc'

Sort direction. Anything other than asc means desc.

limitinteger

Rows to return, 1-200 (anonymous capped to 20). Out of range → 400. With a key this many rows are taken from the daily allowance, whether or not that many come back.

offsetinteger

Rows to skip, 0-100000 (anonymous forced to 0).

mine'1'

Set to 1 to list only the addresses you have unlocked (needs a key; 401 without). Spends no row allowance; minEligible defaults to 0.

minEligibleinteger

Floor on settled markets (wins + losses + breakevens). Default 5.

minWinsLossesinteger

Floor on markets won or lost (breakevens excluded). Absent = no floor; the website uses 10.

minPnlnumber

Floor on realised PnL, dollars. May be negative.

minRoinumber

Floor on ROI on buys (0.2 = 20%).

minWinLonumber

Floor on the Wilson 95% lower bound of the win rate.

maxWalletsnumber

Ceiling on addresses of the entity that traded in the window (1 = single address).

minFillsnumber

Floor on fills in the window.

minVolumenumber

Floor on dollars spent buying in the window (grossBuyUsdc).

status'active' | 'quiet' | 'dormant'

Last fill <24h (active), <7d (quiet), older (dormant).

style'maker' | 'taker' | 'two-sided'

By share of traded value made as maker: >=0.8 maker, <=0.2 taker, else two-sided.

category'crypto-updown' | 'crypto' | 'esports' | 'sports' | 'politics' | 'economy' | 'geopolitics' | 'science-tech' | 'culture' | 'other' | 'unknown'

Entities that traded this category in the window.

minCategorySharenumber

With category only (400 otherwise): at least this share (0, 1] of traded value in that category.

bandsinteger[]

Unlock price bands, any of them, comma-separated (0 = free … 5). Priced on the 30d window whatever period is.

Response

OK

periodIdstring
tier'anon' | 'free' | 'subscriber'

anon = no valid key; subscriber = an active push subscription or active plan.

sampledboolean

true for the anonymous 20-row sample.

filtersobject

The filters actually applied.

sort'realizedPnl' | 'roiOnBuys' | 'eligible' | 'winsLosses' | 'nFills' | 'conditions' | 'grossBuyUsdc' | 'unrealizedPnl' | 'winLo' | 'fillsPerDay' | 'lastFill'
dir'asc' | 'desc'
sortsstring[]
historyFromstring nullable

First UTC day of the ledger behind this window.

trackedinteger

Entities in the window (independent of filters). With mine=1: how many addresses you have unlocked.

Changes

No recorded changes to this operation across all 1 revision of this API.