v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

Get "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.

post/api/v1/tgm/perp-pnl-leaderboard

Request body

token_symbolstring required

Perpetual contract symbol (e.g., BTC, ETH, SOL)

premium_labelsboolean

Controls label tier in the response. When null/omitted or false (the default), returns free-tier labels at the standard credit cost for this endpoint. When true, returns premium labels (Smart Money, Fund, and other advanced labels), is billed at 150 credits per call, and requires a paid plan.

Response

TGM Perp PnL leaderboard data