NAnansen
Token God Mode

Get "Token God Mode" (TGM) perp positions data

Retrieve current perpetual positions for a specific token on Hyperliquid. Shows active positions with detailed metrics including entry price, mark price, leverage, PnL, and liquidation price.

Key Features:

  • Hyperliquid perpetual contracts only (no chain field needed)
  • Real-time position tracking with live PnL calculations
  • Leverage and margin information
  • Smart money filtering capabilities
  • Support for both Long and Short positions

What it helps to answer:

  1. What are the current perp positions for a specific token?
  2. Which addresses have the largest positions by value?
  3. What are the unrealized gains/losses on current positions?
  4. What leverage levels are traders using?
  5. Which smart money wallets are holding positions?
post/api/v1/tgm/perp-positions

Request

Request body

token_symbolstring required

Token symbol

label_type'smart_money' | 'all_traders' | 'whale' | 'public_figure'

TGM perp positions label types.

Response

TGM perp positions data

Changes

No recorded changes to this operation across all 1 revision of this API.