Nansen
Nansen API provides blockchain analytics data including wallet balances, transactions, smart money tracking, and perpetual trading intelligence.
Trust signal
4 of 4 pillars
coverage 100%
Pillars
Signals
Evidence tiers, not an endorsement · trust model v0.1.0 (provisional) · CDP-lane settlement only (D3) · Trust API coming soon
On-chain traction
ERC-8004 agent registry
Not found in the ERC-8004 agent registry. This is the default state — absence is not a negative signal.
Settlement volume
USDC settled on-chain · monthly
as of Jul 12, 2026
Endpoints(55)
Get chain growth rankings
Get Nansen Score Top Tokens
Get Perpetual Contract Screening Data
Get Prediction Market Address Summary
Get Prediction Market Categories
Get Prediction Market Event Screener
Get Prediction Market Screener
Get Prediction Market OHLCV Candles
Get Prediction Market Orderbook
Get Prediction Market PnL by Address
Get Prediction Market Trades by Address
Get Prediction Market Trades by Market
Get Address Current Balance Data
Get Address Historical Balances Data
Retrieve address PnL data
Get Address PnL Summary Data
Get Address Related Wallets Data
Get Address Transactions Data
Get Wallet DEX Trades
Get Perpetual Positions Data
Get Perpetual Trade Data
Get Smart Money Historical Holdings Data
Get "Token God Mode" (TGM) DEX trades data
Get "Token God Mode" (TGM) flow intelligence data
Get "Token God Mode" (TGM) flows data
Get "Token God Mode" (TGM) Jupiter DCA data
Get "Token God Mode" (TGM) perp trades data
Get "Token God Mode" (TGM) position intelligence data
Get "Token God Mode" (TGM) token information data
Retrieve token OHLCV candle data
Get "Token God Mode" (TGM) transfers data
Get "Token God Mode" (TGM) who bought/sold data
Discover and screen tokens across multiple blockchains with advanced filtering capabilities. This endpoint helps identify trending tokens, new launches, and smart money movements by combining metrics like volume, liquidity, market cap, and trading activity. **What it helps to answer:** 1. **Which tokens are experiencing significant smart money activity across different chains?** 2. **How do market metrics (price, volume, liquidity) correlate with holder behavior and smart money movements?** 3. **What tokens show strong fundamentals in terms of holder distribution and trading patterns?** 4. **Which emerging tokens are attracting fresh wallet inflows while maintaining healthy smart money participation?**
Get Transaction with Token Transfer Lookup Data
Get Perpetual Trading Leaderboard Data
Get Prediction Market PnL by Market
Get Prediction Market Position Detail
Get Prediction Market Top Holders
Get Address Counterparties Data
Get Smart Money DCAs Data
Get Smart Money DEX Trades Data
Get Smart Money Holdings Data
Get Smart Money Netflow Data
Get Smart Money Perpetual Trades Data
Get Smart Money PnL Leaderboard
Get "Token God Mode" (TGM) holders data
Get Nansen Score Indicators
Get "Token God Mode" (TGM) perp PnL leaderboard data
Get "Token God Mode" (TGM) perp positions data
Get "Token God Mode" (TGM) PnL leaderboard data
Get Historical (Time-Travel) Transaction Lookup Data (Beta)
Get historical "Token God Mode" (TGM) DEX trades (Beta)
Get Historical TGM Top Holders (Beta)
Ask the Nansen AI agent a research question and receive a streamed answer backed by on-chain data. The **fast** variant uses a lighter model optimised for low-latency responses. **What it helps to answer:** 1. **Which tokens are smart money accumulating right now?** 2. **What is the current narrative driving activity in DeFi?** 3. **Which wallets are connected to a specific address?** 4. **What is the on-chain story behind a recent price move?** **SSE event types:** The response is a text/event-stream with the following JSON event types: | type | payload | description | |---|---|---| | delta | {"type": "delta", "text": "…"} | Incremental text chunk of the agent's answer. | | tool_call | {"type": "tool_call", "name": "…"} | Emitted once per unique Nansen tool the agent invokes. | | finish | {"type": "finish", "conversation_id": "…", "tool_calls": [...]} | Final event. Contains the conversation_id for follow-up requests and the full list of tools used. | | error | {"type": "error", "error": "…", "status_code": …} | Emitted if the upstream agent service is unavailable or times out. | The stream terminates with a data: [DONE] sentinel. **Fast vs Expert:** Use /agent/fast for quick factual lookups and simple questions. Use /agent/expert when you need deeper multi-step analysis or synthesis across multiple data sources.
Ask the Nansen AI agent a research question and receive a streamed answer backed by on-chain data. The **expert** variant uses a more capable model for deeper, multi-step analysis. **What it helps to answer:** 1. **Which tokens are smart money accumulating right now?** 2. **What is the current narrative driving activity in DeFi?** 3. **Which wallets are connected to a specific address?** 4. **What is the on-chain story behind a recent price move?** **SSE event types:** The response is a text/event-stream with the following JSON event types: | type | payload | description | |---|---|---| | delta | {"type": "delta", "text": "…"} | Incremental text chunk of the agent's answer. | | tool_call | {"type": "tool_call", "name": "…"} | Emitted once per unique Nansen tool the agent invokes. | | finish | {"type": "finish", "conversation_id": "…", "tool_calls": [...]} | Final event. Contains the conversation_id for follow-up requests and the full list of tools used. | | error | {"type": "error", "error": "…", "status_code": …} | Emitted if the upstream agent service is unavailable or times out. | The stream terminates with a data: [DONE] sentinel. **Fast vs Expert:** Use /agent/fast for quick factual lookups and simple questions. Use /agent/expert when you need deeper multi-step analysis or synthesis across multiple data sources.