Netflows

Get aggregated token flow analysis for smart money wallets to see which tokens they're accumulating or distributing.

Common Scenarios

Usecase	Required Parameters	Optional Filters	Sorting Logic	Expected Output
Find what funds are buying on Solana	chains: ["Solana"]	include_smart_money_labels: ["Fund"]	[{"field":"net_flow_7d_usd", "direction":"DESC"}]	Returns top tokens by funds, sorted by 7D inflow
Top DeFi tokens that Smart Money are selling	chains: ["ethereum"]	token_sectors: ["DeFi"]	[{"field":"net_flow_7d_usd", "direction":"ASC"}]	Returns tokens with highest net outflow in DeFi sector

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Latency: results are computed over rolling windows (1h, 24h, 7d, 30d) that always end at request time. The most recent 24 hours are served from live CEX and DEX activity, so recent flows show up within minutes; hours beyond that come from an hourly batch job and lag up to about an hour behind the chain. This endpoint takes no custom date range and applies no response cache.

• History: coverage is a rolling 30 days — the underlying flows table retains only the trailing 30 days. There is no older history and no backfill mode, so this endpoint is not suited to long-range historical analysis.

Get Smart Money Netflow Data

post

Analyze net capital flows (inflows vs outflows) from smart traders and funds across different time periods. This endpoint helps identify which tokens are experiencing net accumulation or distribution by smart money.

What are Net Flows? Net flows represent the difference between smart money inflows and outflows for a token. This includes:

• DEX Trading Activity: Tokens bought vs sold on decentralized exchanges

• CEX Transfers: Tokens sent to or received from centralized exchanges

• Positive Net Flow: Smart money is accumulating (buying more than selling, or withdrawing from CEXs)

• Negative Net Flow: Smart money is distributing (selling more than buying, or depositing to CEXs)

Key Features:

• Aggregated net flow calculations across all smart money activity

• Multiple time period analysis (1h, 24h, 7d, 30d)

• Sortable results by volume metrics

• Includes both DEX trades and CEX transfers

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

filtersany ofOptional

Additional filters to apply. Only filters for columns that are being selected will be applied.

Example: {"exclude_smart_money_labels":["30D Smart Trader"],"include_native_tokens":false,"include_smart_money_labels":["Fund","Smart Trader"],"include_stablecoins":false}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "market_cap_usd", "direction": "DESC"}] - Sort by market cap descending
• [{"field": "net_flow_24h_usd", "direction": "ASC"}] - Sort by 24h flow ascending
• [{"field": "market_cap_usd", "direction": "DESC"}, {"field": "net_flow_24h_usd", "direction": "ASC"}] - Sort by market cap descending, then 24h flow ascending

Example: [{"direction":"DESC","field":"net_flow_24h_usd"}]

Responses

200

Smart money netflow data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/smart-money/netflow

HTTPcURLJavaScriptPython

POST /api/v1/smart-money/netflow HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 304

{
  "chains": [
    "ethereum",
    "solana"
  ],
  "filters": {
    "exclude_smart_money_labels": [
      "30D Smart Trader"
    ],
    "include_native_tokens": false,
    "include_smart_money_labels": [
      "Fund",
      "Smart Trader"
    ],
    "include_stablecoins": false
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "direction": "DESC",
      "field": "net_flow_24h_usd"
    }
  ]
}

{
  "data": [
    {
      "token_address": "text",
      "token_symbol": "text",
      "net_flow_1h_usd": 1,
      "net_flow_24h_usd": 1,
      "net_flow_7d_usd": 1,
      "net_flow_30d_usd": 1,
      "chain": "text",
      "token_sectors": [
        "text"
      ],
      "trader_count": 1,
      "token_age_days": 1,
      "market_cap_usd": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}