--- title: "Smart Money Token Flows" method: GET path: "/gateway/v1/smart-money/token/flows" tags: ["Smart Money"] --- # Smart Money Token Flows `GET /gateway/v1/smart-money/token/flows` ## Request - Base URL: `https://api.asksurf.ai` - URL: `https://api.asksurf.ai/gateway/v1/smart-money/token/flows` - Auth: HTTP bearer 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 ## Query parameters - `market` 'spot' | 'perp': spot (on-chain DEX buys/sells) or perp (perpetual futures longs/shorts) - `time_range` '3d' | '7d' | '30d' | '90d': Window to aggregate flows over - `direction` 'inflow' | 'outflow': inflow (net buying / net long) or outflow (net selling / net short) - `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) - `limit` integer: Results per page - `offset` integer: Pagination offset ## Response `200` OK - DataResponseSmartMoneyTokenFlow - `$schema` string, uri: A URL to the JSON Schema for this object. - `data` SmartMoneyTokenFlow[], nullable, required - `buy_usd` number, double: Spot: KOL buy amount in USD (2 significant figures) - `category` string: Token category: meme, defi, infrastructure, ai_agent, launchpad_platform, tokenized_stock_rwa, gaming_social_nft, prediction_market, other - `direction` string, required: inflow (net buying / net long) or outflow - `first_buy_at` integer: Spot: day of the first KOL buy (Unix seconds) - `kols` string[], nullable, required: Handles of KOLs that traded the token, most-followed first (up to 50), without per-KOL amounts - `launched_at` integer: Spot: day the token launched (Unix seconds) - `long_usd` number, double: Perp: long notional opened in USD (2 significant figures) - `market` string, required: spot or perp - `n_buyers` integer: Spot: KOLs that bought (at least $50) - `n_long` integer: Perp: KOLs that opened longs - `n_net_buyers` integer: Spot: KOLs with net buying - `n_net_sellers` integer: Spot: KOLs with net selling - `n_positions` integer: Perp: positions opened by KOLs in the window - `n_short` integer: Perp: KOLs that opened shorts - `net_usd` number, double, required: Net flow in USD (buy - sell, or long - short; 2 significant figures) - `pnl_usd` number, double: Perp: KOLs' PnL on the coin in the window (2 significant figures) - `price_change_since_first_buy` number, double: Spot: price change since the first KOL buy (1.9 = +190%) - `rank` integer, required: Rank within market, time_range and direction - `sell_usd` number, double: Spot: KOL sell amount in USD (2 significant figures) - `short_usd` number, double: Perp: short notional opened in USD (2 significant figures) - `time_range` string, required: Window the flow is computed over - `token` SmartMoneyToken, required - `address` string: Token contract address; absent for perps and unresolved tokens - `chain` string: Chain (canonical long-form, e.g. solana, ethereum, base, bsc; hyperliquid for perps) - `is_stock` boolean: Whether the token tracks an equity - `name` string: Token name - `symbol` string: Token symbol - `token_age_days` number, double: Spot: token age in days at the first KOL buy - `top_buyer_share` number, double: Spot: share of buying from the largest buyer (rounded to 0.1) - `meta` OffsetMeta, required - `cached` boolean, required: Whether this response was served from cache - `credits_used` integer, required: Credits deducted for this request - `empty_reason` string: Hint explaining why the data array is empty, when applicable - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven. - `limit` integer, required: Maximum number of items returned in this response - `offset` integer, required: Number of items skipped (pagination offset) - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown. - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere. ## Other responses - `default`: Error ## Changes - **2026-10-23** `cd899b4049b6`: 1 info - endpoint added [Operation history](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/changes/gateway/v1/smart-money/token/flows/get.md) --- [API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)