TradePortfolio
DocsTrader Leaderboard
Docs

Trader Leaderboard

Dev

GET /hip4-analytics/leaderboard

Redis-backed HIP-4 trader rankings by participant trading volume or realized PnL. Rank every HIP-4 deployer together or scope results to Outcome.xyz or Skew Markets.

Authentication

Requires Dev tier or higher. Free tier does not have access (returns 403).

Parameters

Query parameters

NameTypeRequiredDescription
rangestring–4h, 1d, 7d, 30d, or all. Defaults to all. Legacy period remains supported as a compatibility alias.
sort_bystring–volume or pnl. Defaults to volume.
limitinteger–Number of rows. Defaults to 100; values above 500 are clamped to 500.
venuestring–Stored HIP-4 venue: out for Outcome.xyz or skew for Skew Markets. Omit for all deployers.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip4-analytics/leaderboard?range=30d&sort_by=pnl&limit=25&venue=skew"

Example response

json
{
  "success": true,
  "cache_ready": true,
  "range": "30d",
  "period": "1m",
  "sort_by": "pnl",
  "venue": "skew",
  "data": [
    {
      "rank": 1,
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "volume": 184250.5,
      "fees_paid": 92.13,
      "trade_count": 418,
      "outcomes_traded": 12,
      "outcome_sides_traded": 21,
      "last_active_ms": 1788206400000,
      "realized_pnl": 4120.75
    }
  ],
  "total_traders": 84,
  "computed_at": "2026-09-01T00:05:00+00:00",
  "computed_through_ms": 1788221100000,
  "volume_scope": "participant_notional",
  "pnl_scope": "hyperliquid_closed_pnl"
}

Errors

  • 400 — Invalid venue, sort_by, or limit value.
  • 403 — Free tier does not have access. Upgrade to Dev.
  • 503 — The requested leaderboard cache is being prepared. Retry shortly.

For authentication errors (401) and rate limit responses (429), see Errors.

Related