Hunt Townh402
Catalog
CryptoPOSTlive

Token flow intelligence

Get net flow intelligence for a token by cohort (whales, smart traders, public figures, exchanges, fresh wallets).

$0.01
per call
Success
100%
p50 latency
1.30s
p95 latency
2.08s
Calls (30d)
2

Provider contract

Call path
/routes/nansen/crypto/token-flow-intelligence
Method
POST
Selected provider
nansendefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/token-flow-intelligence' \
  -H 'content-type: application/json' \
  -d '{"chain":"ethereum","token_address":"0x6982508145454ce325ddbe47a25d4ec3d2311933"}'
CLI
h402 call 'crypto/token-flow-intelligence' --provider 'nansen' --method POST --json '{"chain":"ethereum","token_address":"0x6982508145454ce325ddbe47a25d4ec3d2311933"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

chainstringrequired

Nansen chain slug for the token.

One of
token_addressstringrequired

Token contract address (chain-native for non-EVM chains).

e.g.
timeframestringoptional

Time window for the flow intelligence data.

One of
POST/routes/nansen/crypto/token-flow-intelligence
Request body
{
  "chain": "ethereum",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "public_figure_net_flow_usd": 0,
        "public_figure_avg_flow_usd": null,
        "public_figure_wallet_count": 0,
        "top_pnl_net_flow_usd": -3946.8327643305097,
        "top_pnl_avg_flow_usd": 4367.028028412784,
        "top_pnl_wallet_count": 3,
        "whale_net_flow_usd": 0,
        "whale_avg_flow_usd": null,
        "whale_wallet_count": 0,
        "smart_trader_net_flow_usd": 0,
        "smart_trader_avg_flow_usd": null,
        "smart_trader_wallet_count": 0,
        "exchange_net_flow_usd": 530579.923352926,
        "exchange_avg_flow_usd": 256240.33639804332,
        "exchange_wallet_count": 0,
        "fresh_wallets_net_flow_usd": 167971.38823939973,
        "fresh_wallets_avg_flow_usd": 165303.9584147568,
        "fresh_wallets_wallet_count": 0
      }
    ],
    "warnings": [
      "exchange_wallet_count is always 0 (not tracked), even when exchange net flow is non-zero.",
      "fresh_wallets_wallet_count is always 0 (not tracked), even when fresh-wallet net flow is non-zero."
    ]
  },
  "h402": {
    "routeId": "crypto/token-flow-intelligence",
    "provider": "nansen",
    "selectedCandidateId": "crypto/token-flow-intelligence/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansen
x402
100
Success
100%
p50
1.30s
Calls
2
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider