Crypto Wallet Analytics API - Nansen Smart Money, Token Flows

Export Nansen on-chain analytics (Smart Money flows, token holders and trades, wallet balances, PnL and labels) into an Apify dataset with your own Nansen API key.

This actor wraps the official Nansen API. It turns a list of token contract addresses, wallet addresses or entity names into clean, deduplicated rows you can download as JSON, CSV or Excel, schedule hourly or daily, or feed into trading research, risk monitoring, compliance checks, dashboards, spreadsheets and AI agents. Bring your own API key.

What it does

• Smart Money net flows, holdings and DEX trades: which tokens Nansen's curated set of top performing wallets is buying, selling and holding, across Ethereum, Solana, Base, BNB Chain, Arbitrum and more.
• Token screener: trending tokens by volume, buy and sell volume, net flow, liquidity, market cap, FDV, token age and trader counts, over 5 minutes to 30 days, filtered by trader type and Smart Money label.
• Token God Mode analytics for one token: token information and spot metrics, flow intelligence by cohort (Smart Money, whales, exchanges, public figures, top PnL traders, fresh wallets), inflow and outflow buckets over time, top buyers and sellers, DEX trades, top transfers, top holders and OHLCV price candles.
• Wallet profiler: current and historical token balances, transactions, counterparties, related wallets (funders, deployers, linked addresses), PnL summary with win rate, PnL per token, and Nansen's entity and behaviour labels, for one wallet or a whole Nansen entity such as an exchange or fund.
• Address labels everywhere: holders, traders, counterparties and transfer parties carry their Nansen label where one exists.
• Pagination handled for you: every page is read until the endpoint says it is the last one or the row cap is reached.
• Pay only for results: empty answers are recorded as a free row that says why, never charged.

Input

Field	Used by	What it does
mode	all	One of 20 modes: tokenScreener, tokenInformation, tokenFlowIntelligence, tokenFlows, tokenWhoBoughtSold, tokenDexTrades, tokenTransfers, tokenHolders, tokenOhlcv, walletBalances, walletHistoricalBalances, walletTransactions, walletCounterparties, walletRelatedWallets, walletPnlSummary, walletPnl, walletLabels, smartMoneyNetflow, smartMoneyHoldings, smartMoneyDexTrades
tokenAddresses	token modes	Contract addresses on the chosen chain, one request each
walletAddresses	wallet modes	Wallet addresses, one request each
entityNames	balances, historical balances, counterparties, PnL	Nansen entity names such as Binance
chain	token and wallet modes	The chain the token or wallet lives on; all works for most wallet modes
chains	screener and Smart Money modes	One or more chains (screener: up to 5)
screenerTimeframe, tokenTimeframe, candleInterval	screener; token information and flow intelligence; candles	The window or candle resolution
dateFrom, dateTo, lookbackDays	flows, buyers and sellers, trades, transfers, candles, wallet history, transactions, counterparties, PnL	Date window, one year at most; default the last 7 days
flowLabel, holderType, aggregateByEntity, tradeSide, counterpartySource, counterpartyGroupBy, onlySmartMoney, hideSpamTokens	the endpoint named in each field	Documented endpoint options
smartMoneyLabels, includeStablecoins, includeNativeTokens	screener, holders, trades, counterparties, Smart Money	Label and token-type filters
sortField, sortDirection	most list modes	Sort by a documented column such as value_usd or netflow
extraFilters	most list modes	Any other documented Nansen filter, for example {"value_usd": {"min": 10000}}
maxResults	all	Row cap per run, default 200; it also sets the page size
apiKey	all	Your Nansen API key (secret)

Only the inputs the chosen endpoint documents are sent. Anything else is left off with a warning, because the Nansen API answers an unknown filter with an empty result rather than an error.

Example: top Smart Money holders of USDC on Ethereum, biggest first.

{
    "mode": "tokenHolders",
    "chain": "ethereum",
    "tokenAddresses": ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],
    "holderType": "smart_money",
    "sortField": "value_usd",
    "maxResults": 100,
    "apiKey": "YOUR_NANSEN_API_KEY"
}

How to get an API key

Sign in at app.nansen.ai/api and create an API key. The Free plan includes 100 trial credits and then 10 a day; Pro includes 2,000 a month and credits can be bought on top. Each request spends credits on your key: 1 for most token and wallet endpoints, 5 for holders, counterparties and the Smart Money endpoints, and 100 for wallet labels (0 when a wallet has none). Failed requests are not billed by Nansen.

Example output

{
    "mode": "tokenHolders",
    "modeLabel": "Token holders",
    "recordType": "wallet",
    "identifier": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "found": true,
    "chain": "ethereum",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "tokenSymbol": null,
    "walletAddress": null,
    "entityName": null,
    "address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "addressLabel": "Binance 14",
    "timestamp": null,
    "valueUsd": 1250000000.5,
    "transactionHash": null,
    "note": null,
    "retrievedAt": "2026-10-10T12:00:00.000Z",
    "id": "0xa0b8...|3f1c2d9e8a7b6c5d4e3f",
    "token_amount": 1250000000.5,
    "total_outflow": 310000000,
    "total_inflow": 295000000,
    "balance_change_24h": -15000000,
    "balance_change_7d": 42000000,
    "balance_change_30d": 120000000,
    "ownership_percentage": 0.021
}

Every field Nansen returns is kept as is (snake_case), next to the common camelCase columns.

FAQ

What is the Nansen API?

The Nansen API is the developer interface to Nansen, an on-chain analytics platform that labels hundreds of millions of blockchain addresses and tracks Smart Money, the wallets with the strongest trading record. It serves token analytics (Token God Mode), wallet profiles (Profiler), Smart Money aggregates, Hyperliquid perps and prediction market data over JSON POST endpoints.

Do I need my own API key?

Yes. This actor is bring-your-own-key: it calls Nansen with your key, so the data, the credit cost and the licence terms are those of your own Nansen account. Without a key the run ends cleanly with a message saying so.

How do I see what Smart Money is buying right now?

Use smartMoneyNetflow with the chains you care about. Each row is a token with its Smart Money net flow over 1 hour, 24 hours, 7 days and 30 days, trader count, sector, age and market cap. Sort by net_flow_24h_usd to rank by the last day. smartMoneyDexTrades lists the individual swaps from the last 24 hours.

How do I find the top holders or buyers of a token?

Use tokenHolders with a token address and a holder type (all holders, Smart Money, whales, exchanges or public figures), or tokenWhoBoughtSold with buyers or sellers over a date window. Both carry the Nansen label of each address.

How do I profile a wallet?

Use walletBalances, walletTransactions, walletCounterparties, walletRelatedWallets, walletPnlSummary, walletPnl and walletLabels with one or more wallet addresses. Balances, counterparties and PnL also take a Nansen entity name such as Binance, which reads every wallet attributed to that entity.

Which chains are supported?

Ethereum, Solana, Base, BNB Chain, Arbitrum, Optimism, Polygon, Avalanche, Linea, Mantle, Sonic, Sei, Monad, HyperEVM, TRON, TON, Sui, NEAR, Bitcoin, Starknet and more, depending on the endpoint. A chain the chosen endpoint does not support ends the run with the list it does.

What do I pay?

Two separate things. Nansen charges credits on your own key per request. This actor charges per row it returns: 0.005 USD per token market record, trade, transfer or transaction, 0.01 USD per wallet record (holder, buyer, balance, counterparty, PnL), 0.015 USD per Smart Money record and 0.02 USD per wallet label. Empty answers and refusals are never charged.

What happens if my key is wrong or out of credits?

The run ends cleanly, not as a failure, with the provider's reason in the status message: a rejected key, an empty credit balance, or an endpoint or option your plan does not include. A bad address or date for one target is recorded as a free row and the run moves on to the next target.

Keyword map

Nansen API, Smart Money tracker data, crypto wallet analytics, on-chain wallet data, wallet PnL, wallet labels, token holders, whale tracking, token flows, exchange flows, DEX trades, token screener, blockchain analytics API, Ethereum and Solana wallet data, OHLCV.

Terms and data use

Data comes from your own Nansen account under Nansen's Terms of Service and its Data Redistribution Guidelines (docs.nansen.ai/guides/redistribution-guide). In short:

• Free to redistribute: wallet balances, historical balances, wallet PnL and PnL summary.
• Redistribute with attribution ("Powered by Nansen API" or a link to nansen.ai): token transfers, DEX trades, who bought or sold, flows, flow intelligence, token screener, wallet transactions, counterparties and related wallets.
• Restricted (Nansen approval plus significant modification): Smart Money net flows, and token holders filtered to Smart Money.
• Internal use only, never redistributed: wallet labels, Smart Money holdings and Smart Money DEX trades.

Attribution is not required for personal or internal use. The actor itself only moves your own data into your own Apify storage; anything you publish or resell from it is your responsibility under those terms. Nansen also asks that its data is not used to build competing products. This actor is not affiliated with or endorsed by Nansen.