Sign in

v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

Get historical "Token God Mode" (TGM) PnL leaderboard (Beta)

Beta — subject to breaking changes.

Per-trader PnL statistics for a specific token over a historical date range with temporally-correct labels resolved at date_to. Uses label history tables to avoid forward-looking bias.

Key differences from /tgm/pnl-leaderboard:

  • Accepts an explicit date_range with Date-only granularity
  • Labels resolved at date_to, not the current state
  • Supports page-based pagination via per_page and page
  • Filter parameters are applied server-side before pagination
post/api/v1beta1/tgm/historical-pnl-leaderboard

Request body

chain'base' | 'bnb' | 'ethereum' | 'solana' required

Chains supported for the TGM historical endpoints (pnl-leaderboard, who-bought-sold, top-holders, token-flow-summary).

token_addressstring required

Token contract address

apply_blacklist_filterboolean

When True, exclude blacklisted addresses from the results. Defaults to True.

Response

Historical TGM PnL leaderboard data