# Pay Nansen from Your Agent — No API Key, One Install https://selat.ai/tutorials/pay-nansen-from-your-agent _Published Aug 21, 2026_ Tags: nansen api no api key, pay nansen with usdc, nansen x402, nansen agent, nansen api pricing per call, smart money api for agents, on-chain analytics api pay per call, nansen mpp tempo, wallet profiler api agent, nansen api x layer --- **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](https://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): ```bash 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 →](https://selat.ai/docs/selat-plugins)**. ## 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. ```bash 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](https://www.selat.ai/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. ## Related - [Pay Tavily from your agent](/tutorials/pay-tavily-from-your-agent) - [Pay Exa from your agent](/tutorials/pay-exa-from-your-agent) - [Capability tutorials](/tutorials) - [SELAT CLI / docs](https://www.selat.ai/docs)