v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB

Token God Mode

Get historical "Token God Mode" (TGM) top holders (Beta)

Beta — subject to breaking changes.

Top token holders at a historical as_of_date with temporally-correct labels. Labels are resolved from label history tables to avoid forward-looking bias.

Key differences from /tgm/holders:

Accepts an explicit as_of_date (Date) instead of returning current state
Labels resolved at as_of_date, not from current-state dictionaries
value_usd priced at the historical median price for as_of_date
The filters.include_sm_labels field only sub-restricts the smart_money bucket; to switch buckets use the top-level label_type field
No dust-filter default — set filters at the caller side if needed

Performance: Can be slow for high-volume tokens (USDC, native ETH, etc.).

post/api/v1beta1/tgm/historical-top-holders

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

as_of_datestring required

Historical date (YYYY-MM-DD) to compute holder balances at.

label_type'all_holders' | 'whale' | 'public_figure' | 'exchange' | 'smart_money'

Holder label-type filter for the historical top holders endpoint.

apply_blacklist_filterboolean

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

Response

Historical TGM top holders data