v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB

Token Screener

Get Historical Token Screener (Beta)

Beta — subject to breaking changes.

Historical token screener data anchored to to_date over a timeframe_days window.

Output columns match the production token screener API response shape exactly.

When trader_type='sm' (or the deprecated only_smart_money=True), volume/netflow/nof_traders fields reflect smart-money flows only; sm_label_filter / exclude_sm_labels_filter narrow that cohort by sub-label. When trader_type is whale or public_figure, those fields reflect the corresponding notable-label cohort instead; smart-money sub-label filters are not applicable in those modes. trader_type overrides only_smart_money when both are set.

Use exclude_sectors to drop tokens whose sector tags include any of the listed sectors (e.g. ["Stablecoin"]).

post/api/v1beta1/token-screener/historical

Request body

to_datestring date required

End date of the screener window

timeframe_daysinteger required

Number of days in the screener window

chainsTokenScreenerChain[] required

Chains to include (required, must be non-empty)

sectors_filterstring[]

Sector filter. Empty list includes all sectors.

exclude_sectorsstring[]

Sectors to exclude. Empty list excludes nothing.

only_smart_moneyboolean

Deprecated: use trader_type instead. When True, aggregate smart money flows only. Volume/netflow/nof_traders fields reflect SM flows. Ignored when trader_type is provided.

Trader type filter for token screener.

apply_blacklist_filterboolean

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

Response

Historical token screener data