Get the global perpetuals leaderboard, ranked by PnL, notional volume, current account value, or ROI across all instruments.

Windows are anchored to calendar UTC boundaries: day starts at 00:00 UTC today, week at Monday 00:00 UTC, month at the first of the month 00:00 UTC, and all at exchange launch.

PnL is realized PnL minus trading fees plus funding payments, consistent with the account PnL endpoint; unrealized PnL is excluded. Notional is the USD value of all fills in the window. Every entry carries both metrics; rank is the position under the requested sort_by.

ROI sorting uses the served, rounded window ROI in descending order, with ties broken by higher PnL, higher notional, then the older account. It uses the same eligible accounts as PnL and notional, with no additional minimum equity or volume requirement. The optional address row reports its rank under the same ordering, including ranks beyond the pageable top 1000.

PnL, notional, and account value are raw numeric strings from the engine. Account value is current equity (collateral value plus unrealized PnL). The background census advances by at most 8,192 accounts on each 60-second poller tick, so a full publication can span multiple ticks as the account population grows. For account-value sorting, timestamp is the earlier of the published census start and the historical window's computation time, so stale membership and PnL remain observable if a historical rebuild fails. When sorting by account value, the requested window still determines which accounts and historical PnL/notional metrics are included, while the ranking uses their current equity. Accounts whose equity cannot be computed are excluded from that ranking. When unrealized PnL is unavailable (for example, due to stale marks), the display field falls back to collateral value on PnL/notional entries and address lookups; it does not establish an equity rank. total counts accounts with published equity in that window. sort_by=account_value returns 503 while the first completed census is warming. PnL and notional rankings remain available during that warm-up. Clients are responsible for decimal and currency presentation formatting.

Rankings are recomputed periodically; timestamp is the computation time. Returns 25 entries by default and at most 100 per request; only the top 1000 ranks are pageable (offset + limit must not exceed 1000).

Provide address to additionally return that account's row regardless of rank. An address with no activity in the window returns zero metrics and no rank.

{
  "timestamp": 1767225600000,
  "total": 15234,
  "entries": [
    {
      "rank": 1,
      "account": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
      "pnl": "100.00",
      "notional": "10164976",
      "account_value": "9238345.12",
      "roi": "0.4527"
    }
  ],
  "account": {
    "rank": 1,
    "account": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "pnl": "100.00",
    "notional": "10164976",
    "account_value": "9238345.12",
    "roi": "0.4527"
  }
}