Sign in

v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

Get historical "Token God Mode" (TGM) who bought/sold (Beta)

Beta — subject to breaking changes.

Aggregated buy/sell volumes per trader for a specific token over a historical date range. Labels are resolved at the query end date using temporal label history tables to avoid forward-looking bias.

Key differences from /tgm/who-bought-sold:

  • Accepts an explicit date_range (no rolling default)
  • Labels resolved at date_to, not the current state
  • Response uses gross_token_volume / gross_volume_usd (bought + sold totals) and adds is_smart_money
  • min_trade_volume_usd filter is applied server-side (default 10 USD)
post/api/v1beta1/tgm/historical-who-bought-sold

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

buy_or_sell'BUY' | 'SELL'

TGM who bought/sold type.

Response

Historical TGM who-bought-sold data