Authentication#

Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

Web Search#

Search the web for one or more queries in parallel via the Serper API.

bash

nansen web search "bitcoin price"
nansen web search "solana ecosystem news" --num-results 5
nansen web search --query "ethereum ETF" --query "bitcoin ETF" --num-results 3

Positional args and --query flags can be combined — all become queries.

FlagValuesDefaultPurpose--querystring—Query string (repeatable for multiple queries)--num-results1–2010Results per query--prettyflagoffHuman-readable JSON

Returns results[] — one entry per query, each with organic[] (title, link, snippet, date) and optional knowledge_graph.

Note: Some domains are excluded from results (paywalled/unfetchable sites like bloomberg.com, twitter.com). Use nansen web fetch to retrieve content from specific URLs.