v1
latestOpenAPI 3.1.02026-07-2359362475.0 KBGet "Token God Mode" (TGM) perp PnL leaderboard data
Rank traders by their profit/loss performance for a specific perpetual contract on Hyperliquid. Shows both realized profits (from completed trades) and unrealized profits (from current holdings), along with ROI percentages and trading patterns. This endpoint can be used to analyze the realized and unrealized profit for each trader who traded the input perpetual contract.
Key Features:
- Hyperliquid perpetual contracts only (no chain field needed)
- Realized and unrealized PnL tracking
- ROI calculations and trading patterns
- Position size and balance tracking
Request Format:
- token_symbol: Perpetual contract symbol (e.g., "BTC", "ETH", "SOL")
- date: Date range for analysis
- filters: Optional filters for trader addresses, PnL ranges, etc.
- pagination: Page and per_page parameters
Label Tier Control (premium_labels): When omitted or set to false (the default), the response contains free-tier labels and the request is billed at the standard credit cost for this endpoint. Passing premium_labels=true returns premium labels (Smart Money, Fund, and other advanced labels), is billed at 150 credits per call, and requires a paid plan.
Request body
Response
TGM Perp PnL leaderboard data