Smart Money Token Flows

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

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

marketenum<string>

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

Available options:spotperp

Example: spot

time_rangeenum<string>

Window to aggregate flows over

Available options:3d7d30d90d

Example: 30d

directionenum<string>

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

Available options:inflowoutflow

Example: inflow

chainenum<string>

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

Available options:solanaethereumbasebscarbitrumrobinhoodhyperevmmonadarcpolygonavalancheoptimismworldchaininkxlayercronoscelounichainberachainkatanaflareroninlineaplasmamantleabstractzksyncsonicgnosisgravityhemiplumezorascrollsoneiummegaethmantaetherlinkmodefusecitreafraxtaltaikobobsophonxdcmetisseirootstockkaiazircuitzetachainliskconfluxmorphapechainbitlayercorestorystabletempo

Example: solana

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Smart Money Token Flows

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/smart-money/token/flows?market=spot&time_range=30d&direction=inflow&chain=solana&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseSmartMoneyTokenFlow.json",
  "data": [
    {
      "buy_usd": 123,
      "category": "<string>",
      "direction": "<string>",
      "first_buy_at": 123,
      "kols": [],
      "launched_at": 123,
      "long_usd": 123,
      "market": "<string>",
      "n_buyers": 123,
      "n_long": 123,
      "n_net_buyers": 123,
      "n_net_sellers": 123,
      "n_positions": 123,
      "n_short": 123,
      "net_usd": 123,
      "pnl_usd": 123,
      "price_change_since_first_buy": 123,
      "rank": 123,
      "sell_usd": 123,
      "short_usd": 123,
      "time_range": "<string>",
      "token": {
        "address": "<string>",
        "chain": "<string>",
        "is_stock": true,
        "name": "<string>",
        "symbol": "<string>"
      },
      "token_age_days": 123,
      "top_buyer_share": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}