Netflows

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 (24h, 7d, 30d)

• Sortable results by volume metrics

• Includes both DEX trades and CEX transfers

Authorizations

ApiKeyAuth

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

Responses

200

Smart money netflow data

application/json

400

Bad Request

application/json

401

Unauthorized

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

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

{
  "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": [
    {
      "field": "chain",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "token_address": "text",
      "token_symbol": "text",
      "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
  }
}