NAnansen
Token God Mode

Get "Token God Mode" (TGM) flows data

Analyze aggregated token flows by holder category over time. Shows hourly snapshots of balances, inflows, and outflows for specific holder groups: smart money, public figures, whales, and exchanges.

Note: the DEX/CEX breakdown fields (total_inflows_dex, total_outflows_dex, total_inflows_cex, total_outflows_cex) are only populated when label=exchange and are null for all other labels; a warnings entry is included in the response in that case. For net flow per holder segment (e.g. smart money), use the Flow Intelligence endpoint (POST /api/v1/tgm/flow-intelligence).

post/api/v1/tgm/flows

Request

Request body

chain'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'hyperevm' | 'hyperliquid' | 'injective' | 'iotaevm' | 'linea' | 'mantle' | 'mantra' | 'monad' | 'near' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'starknet' | 'sui' | 'ton' | 'tron' required

Chains supported for the TGM flows endpoint.

token_addressstring required

Token address

label'whale' | 'public_figure' | 'smart_money' | 'top_100_holders' | 'exchange'

TGM flow label types.

Response

TGM flows data

warningsstring[]

Optional warnings about the query results. For example, when the DEX/CEX flow fields are null because a non-exchange label was requested.

Changes

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