ASasksurf
Smart Money

Smart Money Token Flows

Changed on

Ranks tokens by the net buying (inflow) or net selling (outflow) of the KOLs on the composite board.

  • market=spot: on-chain DEX buys and sells across Solana, Ethereum, Base, BSC, Arbitrum, Robinhood Chain and more; filter with chain.
  • market=perp: perpetual futures longs and shorts.

time_range is 3d, 7d, 30d or 90d. Rows include buyer / seller counts, buying concentration, token age and price change since the first KOL buy.

Privacy: responses never include wallet addresses or transaction identifiers. Per-KOL amounts are rounded to 2 significant figures, and per-token KOL lists carry names only.

Data refresh: daily

get/gateway/v1/smart-money/token/flows

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

market'spot' | 'perp'

spot (on-chain DEX buys/sells) or perp (perpetual futures longs/shorts)

Example:spot
time_range'3d' | '7d' | '30d' | '90d'

Window to aggregate flows over

Example:30d
direction'inflow' | 'outflow'

inflow (net buying / net long) or outflow (net selling / net short)

Example:inflow
chain'solana' | 'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'robinhood' | 'hyperevm' | 'monad' | 'arc' | 'polygon' | 'avalanche' | 'optimism' | 'worldchain' | 'ink' | 'xlayer' | 'cronos' | 'celo' | 'unichain' | 'berachain' | 'katana' | 'flare' | 'ronin' | 'linea' | 'plasma' | 'mantle' | 'abstract' | 'zksync' | 'sonic' | 'gnosis' | 'gravity' | 'hemi' | 'plume' | 'zora' | 'scroll' | 'soneium' | 'megaeth' | 'manta' | 'etherlink' | 'mode' | 'fuse' | 'citrea' | 'fraxtal' | 'taiko' | 'bob' | 'sophon' | 'xdc' | 'metis' | 'sei' | 'rootstock' | 'kaia' | 'zircuit' | 'zetachain' | 'lisk' | 'conflux' | 'morph' | 'apechain' | 'bitlayer' | 'core' | 'story' | 'stable' | 'tempo'

Spot only: restrict to one chain (canonical long-form names; covers every chain the Smart Money data has had so far)

Example:solana
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseSmartMoneyTokenFlow.json"
}

Changes