v25

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB
Leaderboard

List trending wallets

Returns wallets ranked by Polymarket weekly/monthly P&L (Polymarket-only discovery), with opaque page-cursor pagination. trending_pnl_usd and the by-PNL row order come from Polymarket's canonical leaderboard (data-api.polymarket.com/v1/leaderboard?timePeriod=week|month&orderBy=PNL), not a locally summed realized-leaf total. Each row also carries window volume, distinct markets, grade, hot-streak tier, and a shape-only daily P&L sparkline derived from the Polymarket user-pnl cumulative curve (per-day deltas; not guaranteed to sum to trending_pnl_usd). The underlying read model is warmed into Redis; a cold read returns 503 (warming, retry-after), never a 500 or a fabricated ranking. Polymarket-only: the read model filters platform = 'polymarket'.

get/api/v1/leaderboard/trending

Query parameters

limitinteger

Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50.

cursorstring

Opaque pagination cursor from a previous response.

window'7d' | '30d'

Trailing window.

Response

Trending wallets list

object'list' required
has_moreboolean required
next_cursorstring nullable

Opaque cursor for the next page; absent on the last page.

totalinteger nullable

Total ranked rows when the read model exposes a count; may be absent.