Nansen is an on-chain analytics API — smart money flows, wallet profiling and PnL, token holder and flow analytics, Nansen Score rankings, perpetual and prediction market data, and token screening across multiple chains. Your agent can call any of its 72 endpoints per request, with no Nansen account and no API key — the endpoint answers 402, the agent pays USDC from the user's Circle Agent Wallet, and the rows come back in the same run. SELAT never holds keys or funds. Nansen is the deep-surface case: one merchant and a 750x price spread between its cheapest and most expensive call.
What Nansen does
Nansen turns raw chain activity into labelled intelligence: which wallets are moving, what they hold, what they made or lost, and how flow looks around a given token. The surface is genuinely long-tail — each product area is its own set of separately priced calls, not one omnibus query.
- Smart money — netflow, holdings, DEX trades, perp trades, DCAs.
- Wallet profiler — current and historical balances, transactions, counterparties, related wallets, PnL and PnL summary.
- Token God Mode (TGM) — flows, flow intelligence, holders, transfers, DEX trades, OHLCV, PnL leaderboard.
- Perps — contract screener, trading leaderboard, Hyperliquid perp PnL summary.
- Prediction markets — market and event screeners, categories, OHLCV, PnL by market, top holders.
- Screening and scoring — token screener, Nansen Score top tokens, chain growth rankings.
- Research agent — Nansen's own research agent in "fast" and "expert" modes.
Full API reference: nansen.ai.
What it costs
Nansen lists 72 endpoints in the catalog, 65 of them priced. A representative spread:
| Endpoint | What it returns | Price | Rail |
|---|---|---|---|
POST /api/v1/profiler/address/pnl | Address PnL | $0.01 | all 4 rails |
POST /api/v1/perp-screener | Perpetual contract screening | $0.01 | all 4 rails |
POST /api/v1/prediction-market/market-screener | Prediction market screener | $0.01 | all 4 rails |
POST /api/v1/smart-money/netflow | Smart money netflow | $0.05 | all 4 rails |
POST /api/v1/tgm/holders | Token God Mode holders | $0.05 | all 4 rails |
POST /api/v1beta1/tgm/historical-pnl-leaderboard | Historical TGM PnL leaderboard (beta) | $0.25 | x402 · exact · Solana, Base, X Layer |
POST /api/v1/agent/fast | Nansen Research Agent, fast mode | $2.00 | x402 · exact · Solana, Base, X Layer |
POST /api/v1/agent/expert | Nansen Research Agent, expert mode | $7.50 | x402 · exact · Solana |
Catalog prices run from $0.01 to $7.50 per call. Most of the profiler, TGM, perp and prediction-market endpoints sit at $0.01 or $0.05; the top of the range is 750x the floor, and it belongs to two endpoints.
Where Nansen is payable
Nansen is payable on Solana, Base, X Layer, and Tempo; the agent does not pick.
Install SELAT in your agent
SELAT installs once per agent runtime — no per-service setup, no API key. Quickest path (Claude Code):
claude plugin marketplace add SELAT-AI/selat-plugins
claude plugin install selat@selat-plugins
Using Codex, Cursor, Gemini CLI, OpenClaw, Hermes, or a plain terminal? Follow the canonical, always-current install guide: Install SELAT →.
Pay Nansen from your agent
selat search is free: hosted discovery returns ranked, live-priced candidates and does not spend. selat run spends — it discovers, quotes, and pays USDC from the user's Circle Agent Wallet. selat run --dry-run quotes without paying. SELAT never holds keys or funds.
selat search "smart money netflow for a token on Base" # free — ranked, live-priced
selat run "smart money netflow for a token on Base" --dry-run # quotes without paying
selat run "smart money netflow for a token on Base" # spends: discover → quote → pay USDC
Fund path: init → fund → run. Fund Circle Gateway, then pay USDC from the user's Circle Agent Wallet.
See the SELAT CLI / docs for init → fund → run.
When to use Nansen vs alternatives
- Use Nansen when the question is about who, or spans products. Labelled wallets, smart money positioning, counterparties and related addresses, plus token flows, perps and prediction markets in one run against one merchant.
FAQ
Do I need a Nansen API key to use Nansen from an agent?
No. Your agent pays per call from the user's Circle Agent Wallet and gets the response back — there is no Nansen account to create and no key to store or rotate. SELAT never holds keys or funds.
How much does one Nansen API call cost?
It depends on the endpoint. Catalog prices run from $0.01 to $7.50; most of the profiler, TGM, perp and prediction-market endpoints sit at $0.01 or $0.05, and the top of the range is the Nansen Research Agent — $2.00 in fast mode, $7.50 in expert mode.
Which chain does Nansen settle on?
Nansen is payable on Solana, Base, X Layer, and Tempo; the agent does not pick.
Can one agent run combine Nansen smart money data with a wallet profiler lookup?
Yes. Each endpoint is priced and paid on its own, so a single skill can chain smart-money/netflow into profiler/address/pnl and settle both from the same Circle Agent Wallet under the same caps.
Does Nansen cover perps and prediction markets, or just tokens and wallets?
Both. There is perp screening, a perp trading leaderboard, and Hyperliquid perp PnL summary, plus prediction-market screeners, categories, OHLCV, PnL by market, and top holders.
Can I cap what my agent spends on Nansen in one run?
Yes. You set a per-call ceiling and a session budget, and you can freeze the wallet. With a $0.01–$7.50 spread on this merchant, the per-call ceiling is the control worth setting first — a quote above it does not get paid. selat run --dry-run quotes without paying.
How do I call Nansen from my agent?
Install the SELAT plugin in Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, or Hermes, then ask the on-chain question you actually have — the agent finds the matching Nansen endpoint in the catalog and selat run pays for the call in the same session. You write the intent; the agent does not pick the chain.