v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

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

Retrieve perpetual trade data for a specific token on Hyperliquid. Shows individual trades with detailed information including trader address, trade side (Long/Short), action type (Add/Reduce/Open/Close), order type (Market/Limit), and trade metrics.

Key Features:

  • Hyperliquid perpetual contracts only
  • Smart money filtering capabilities
  • Detailed trade breakdown with parsed action fields
  • Support for both Long and Short position trading
  • Market and Limit order types

Request Parameters:

  • token_symbol: Token symbol to fetch trades for (e.g., "BTC", "ETH")
  • date: Date range for the trades
  • filters: Additional filters for side, action, order_type, etc.
  • pagination: Page and per_page parameters
post/api/v1/tgm/perp-trades

Request body

token_symbolstring required

Token symbol

Response

TGM perp trades data