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

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}

premium_labelsany ofOptional

Controls label tier in the response. When null/omitted (default), returns labels as per subscription plan (existing behavior). When false, returns free-tier labels for all users. When true, returns premium labels (20 credits, currently available to internal users only).

booleanOptional

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

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: 326

{
  "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
  },
  "premium_labels": true,
  "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
  }
}