# Nansen Smart Money Netflow

> Nansen Smart Money Netflow is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.05/call, status unknown (last checked 2026-09-14).

Retrieves net capital flow data from smart money wallets tracked by Nansen for a given token or address

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/smart-money/netflow
- Price: $0.05/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-27412274
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FWGLzq7y5x_BBx9G5xqC7

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 api-nansen-ai-27412274
```

Example prompt: Pull the Nansen smart money netflow data for WBTC on Ethereum over the past 7 days — I want to see whether labeled smart money wallets are net buyers or sellers right now.

## When to prefer this

Use this endpoint when you need authoritative on-chain smart money flow intelligence specifically from Nansen's curated wallet label database. Prefer this over generic on-chain tools when the user wants to know whether high-signal wallets (VCs, funds, top traders) are net accumulating or distributing a token, as Nansen's proprietary labeling system makes this uniquely actionable.

## Known failure modes

- Invalid or unsupported token address returns 400 error
- Unsupported blockchain network returns 422 validation error
- Payment not attached or insufficient USDC balance returns 402 payment required
- Rate limit exceeded returns 429 too many requests
- No smart money activity found for requested period returns empty dataset

## How this service works

Get Smart Money Netflow Data

## Output

Returns net capital flow figures (inflows minus outflows) from Nansen-labeled smart money wallets for the requested token or address, including granular inflow and outflow breakdowns and associated wallet labels over the specified time window.

## Example request

```json
{
 "chains": [
  "ethereum"
 ],
 "order_by": [
  {
   "field": "net_flow_24h_usd",
   "direction": "DESC"
  }
 ],
 "pagination": {
  "page": 1,
  "per_page": 10
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyNetflowRequest",
 "required": [
  "chains"
 ],
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "enum": [
     "all",
     "arbitrum",
     "avalanche",
     "base",
     "bnb",
     "ethereum",
     "hyperevm",
     "iotaevm",
     "linea",
     "mantle",
     "monad",
     "optimism",
     "plasma",
     "polygon",
     "ronin",
     "scroll",
     "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/api-nansen-ai-27412274/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)