# Nansen Smart Money Netflow

> Nansen Smart Money Netflow is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.05/call, status unknown (last checked 2026-10-11, last successful call 2026-08-25).

Analyzes net capital flows (inflows vs outflows) of smart money traders and funds across tokens and blockchains over multiple time periods.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/smart-money/netflow?utm_source=zero.xyz
- Price: $0.05/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-08-25
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 205
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-netflow-a8d8b40f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x-xb17q-JHFNbGb0jSwM0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-netflow-a8d8b40f -d '<json body>'
```

Example prompt: Show me which tokens on Ethereum and Solana are seeing the strongest net accumulation by smart money over the last 24 hours — I want to focus on DeFi tokens with a market cap above $10 million.

## When to prefer this

Use this endpoint when you need to identify smart money accumulation or distribution trends across tokens — especially for trading signal generation, portfolio research, or on-chain sentiment analysis. Prefer this over general token screeners when the key signal is smart money capital flow direction, not just price or volume.

## Known failure modes

- Invalid chain name returns validation error
- Token address not found returns empty data array
- Missing required 'chains' field returns 400 error
- Exceeding pagination limits returns error
- Payment not provided or insufficient returns 402 error
- Overly narrow filters return empty result set

## How this service works

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

## Output

A paginated list of tokens with their smart money net flow values in USD across 1h, 24h, 7d, and 30d windows, along with token metadata (symbol, chain, sectors, market cap, trader count, token age). Positive values indicate accumulation; negative values indicate distribution by smart money.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyNetflowRequest",
 "required": [
  "chains"
 ],
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "enum": [
     "all",
     "arbitrum",
     "arc",
     "avalanche",
     "base",
     "bnb",
     "ethereum",
     "hyperevm",
     "iotaevm",
     "linea",
     "mantle",
     "monad",
     "optimism",
     "plasma",
     "polygon",
     "robinhood",
     "sei",
     "solana",
     "sonic"
    ],
    "type": "string",
    "title": "SmartMoneyChain",
    "description": "Chains supported in smart money analysis."
   },
   "title": "Chains",
   "examples": [
    [
     "ethereum",
     "solana"
    ]
   ],
   "description": "Chains to include in the analysis (only smart money supported chains). Use 'all' to include all available chains."
  },
  "filters": {
   "anyOf": [
    {
     "type": "object",
     "title": "SmartMoneyNetflowFilters",
     "properties": {
      "token_sector": {
       "anyOf": [
        {
         "type": "array",
         "items": {
          "type": "string"
         }
        }
       ],
       "title": "Token Sector",
       "examples": [
        [
         "DeFi",
         "NFT",
         "Gaming"
        ]
       ],
       "description": "Token sector filter"
      },
      "trader_count": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Max",
           "examples": [
            50000,
            10000000,
            100
           ],
           "description": "Maximum value (inclusive)"
          },
          "min": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Min",
           "examples": [
            1000,
            1000000,
            -50,
            0
           ],
           "description": "Minimum value (inclusive)"
          }
         },
         "description": "Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"
        }
       ],
       "examples": [
        {
         "max": 100,
         "min": 1
        }
       ],
       "description": "Trader count range filter"
      },
      "token_address": {
       "anyOf": [
        {
         "type": "string"
        },
        {

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyNetflowResponse",
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "SmartMoneyNetflow",
    "required": [
     "token_address",
     "token_symbol",
     "net_flow_1h_usd",
     "net_flow_24h_usd",
     "net_flow_7d_usd",
     "net_flow_30d_usd",
     "chain",
     "token_sectors",
     "trader_count",
     "token_age_days"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain",
      "description": "Blockchain chain"
     },
     "token_symbol": {
      "type": "string",
      "title": "Token Symbol",
      "description": "Token symbol"
     },
     "trader_count": {
      "type": "integer",
      "title": "Trader Count",
      "description": "Number of Smart Money traders of token in the past 30 days."
     },
     "token_address": {
      "type": "string",
      "title": "Token Address",
      "description": "Token contract address"
     },
     "token_sectors": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "Token Sectors",
      "description": "Token sectors"
     },
     "market_cap_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Market Cap Usd",
      "description": "Market cap of token."
     },
     "token_age_days": {
      "type": "integer",
      "title": "Token Age Days",
      "description": "Number of days since token was deployed."
     },
     "net_flow_1h_usd": {
      "type": "number",
      "title": "Net Flow 1H Usd",
      "description": "Net flow bought/sold of token by Smart Money in the past 1 hour."
     },
     "net_flow_7d_usd": {
      "type": "number",
      "title": "Net Flow 7D Usd",
      "description": "Net flow bought/sold of token by Smart Money in the past 7 days."
     },
     "net_flow_24h_usd": {
      "type": "number",
      "title": "Net Flow 24H Usd",
      "description": "Net flow bought/sold of token by Smart Money in the past 24 hours."
     },
     "net_flow_30d_usd": {
      "type": "number",
      "title": "Net Flow 30D Usd",
      "description": "Net flow bought/sold of token by Smart Money in the past 30 days."
     }
    },
    "description": "Individual smart money netflow record.\n\nRepresents a single token's smart money netflow data."
   },
   "title": "Data",
   "description": "List of smart money netflow records"
  },
  "pagination": {
   "type": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-netflow-a8d8b40f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)