Sign in

v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

Get historical "Token God Mode" (TGM) token flow summary (Beta)

Beta — subject to breaking changes.

Aggregated token flow intelligence with temporally-correct segment labels. Same response shape as /tgm/flow-intelligence plus a token_symbol column.

Key differences from /tgm/flow-intelligence:

  • Accepts an explicit date_range (no rolling timeframe default)
  • Segment labels (Whale, Public Figure, Top PnL, Smart Trader) are resolved at date_to from history tables to avoid forward-looking bias
  • Segment columns are NULL when temporal label coverage does not yet include date_to (whale/public_figure/top_pnl/exchange coverage starts 2025-03-11; smart_trader is available from 2020+
post/api/v1beta1/tgm/historical-token-flow-summary

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 token flow summary

warningsstring[]

Optional warnings about the query results, e.g. when segment fields are NULL because temporal label data does not yet cover the requested date_to.