Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Ranks wallets by realized P&L, total P&L (realized + unrealized), gross profit, volume, or win count. All monetary values are in USD.

​
Request

GET /v3/leaderboard

​
Query parameters

ParameterTypeDefaultDescription
sortstringtotalSort by: total (total P&L), realized, profit, volume, wins
tagsstring—Filter by tag slugs (comma-separated)
limitinteger100Max 1000
offsetinteger0Pagination offset

​
Example

curl https://api.polynode.dev/v3/leaderboard?limit=2&sort=total

{
  "leaderboard": [
    {
      "rank": 1,
      "wallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
      "net_realized_pnl": 22053845.825455,
      "gross_profit": 22057977.181649,
      "gross_loss": -4131.356194,
      "unrealized_pnl": 0.000688755,
      "total_pnl": 22053845.826143753,
      "wins": 18,
      "losses": 4,
      "position_count": 22,
      "open_positions": 1,
      "total_volume": 43013258.515682
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 2,
  "elapsed_ms": 1028
}

​
Response fields

FieldTypeDescription
rankintegerPosition in the leaderboard
walletstringWallet address
net_realized_pnlnumberNet realized P&L (USD)
gross_profitnumberSum of winning positions (USD)
gross_lossnumberSum of losing positions (USD, negative)
unrealized_pnlnumberPaper P&L from open positions (USD)
total_pnlnumbernet_realized_pnl + unrealized_pnl (USD)
winsintegerWinning position count
lossesintegerLosing position count
position_countintegerTotal positions
open_positionsintegerCurrently held positions
total_volumenumberTotal volume traded (USD)