Nansen
Wallet labels + smart money flows + analytics
Token
own a pieceOwn a piece of this MCP. Its operator can launch a token, and 10% of every paid call flows to whoever stakes it — the better the MCP does, the more value flows.
Operate this MCP? Claim it by signing in with the wallet it's paid to.
x402 endpoints
50- POST/api/v1/chains/chain-rank$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get chain growth rankings
2 parameters
- chain_typestringbody
- time_framenumberbody
- POST/api/v1/perp-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Perpetual Trading Leaderboard Data
2 parameters
- dateobjectbody
- filtersobjectbody
- POST/api/v1/perp-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Perpetual Contract Screening Data
3 parameters
- dateobjectbody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/prediction-market/address-summary$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Address Summary
1 parameter
- addressstringbody
- POST/api/v1/prediction-market/categories$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Categories
1 parameter
- paginationobjectbody
- POST/api/v1/prediction-market/event-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Event Screener
6 parameters
- end_date_afterstringbody
- end_date_beforestringbody
- order_byarraybody
- querystringbody
- statusstringbody
- tagsarraybody
- POST/api/v1/prediction-market/market-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Screener
6 parameters
- end_date_afterstringbody
- end_date_beforestringbody
- order_byarraybody
- querystringbody
- statusstringbody
- tagsarraybody
- POST/api/v1/prediction-market/ohlcv$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market OHLCV Candles
3 parameters
- dateobjectbody
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/orderbook$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Orderbook
1 parameter
- market_idstringbody
- POST/api/v1/prediction-market/pnl-by-address$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market PnL by Address
2 parameters
- addressstringbody
- order_byarraybody
- POST/api/v1/prediction-market/pnl-by-market$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market PnL by Market
2 parameters
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/position-detail$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market Position Detail
1 parameter
- market_idstringbody
- POST/api/v1/prediction-market/top-holders$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Prediction Market Top Holders
2 parameters
- market_idstringbody
- order_byarraybody
- POST/api/v1/prediction-market/trades-by-address$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Trades by Address
3 parameters
- addressstringbody
- dateobjectbody
- order_byarraybody
- POST/api/v1/prediction-market/trades-by-market$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Prediction Market Trades by Market
3 parameters
- dateobjectbody
- market_idstringbody
- order_byarraybody
- POST/api/v1/profiler/address/counterparties$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Address Counterparties Data
6 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- group_bystringbody
- paginationobjectbody
- source_inputstringbody
- POST/api/v1/profiler/address/current-balance$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Current Balance Data
4 parameters
- addressstringbody
- chainstringbody
- hide_spam_tokenbooleanbody
- paginationobjectbody
- POST/api/v1/profiler/address/historical-balances$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Historical Balances Data
4 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- paginationobjectbody
- POST/api/v1/profiler/address/pnl$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Retrieve address PnL data
4 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- paginationobjectbody
- POST/api/v1/profiler/address/pnl-summary$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address PnL Summary Data
3 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- POST/api/v1/profiler/address/related-wallets$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Related Wallets Data
2 parameters
- addressstringbody
- chainstringbody
- POST/api/v1/profiler/address/transactions$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Address Transactions Data
5 parameters
- addressstringbody
- chainstringbody
- dateobjectbody
- filtersobjectbody
- hide_spam_tokenbooleanbody
- POST/api/v1/profiler/perp-positions$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Perpetual Positions Data
3 parameters
- addressstringbody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/profiler/perp-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Perpetual Trade Data
4 parameters
- addressstringbody
- dateobjectbody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/smart-money/dcas$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money DCAs Data
1 parameter
- filtersobjectbody
- POST/api/v1/smart-money/dex-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money DEX Trades Data
2 parameters
- chainsarraybody
- filtersobjectbody
- POST/api/v1/smart-money/historical-holdings$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Smart Money Historical Holdings Data
3 parameters
- chainsarraybody
- date_rangeobjectbody
- filtersobjectbody
- POST/api/v1/smart-money/holdings$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Holdings Data
2 parameters
- chainsarraybody
- filtersobjectbody
- POST/api/v1/smart-money/netflow$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Netflow Data
3 parameters
- chainsarraybody
- filtersobjectbody
- order_byarraybody
- POST/api/v1/smart-money/perp-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Smart Money Perpetual Trades Data
2 parameters
- filtersobjectbody
- only_new_positionsbooleanbody
- POST/api/v1/tgm/dex-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) DEX trades data
5 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- only_smart_moneybooleanbody
- token_addressstringbody
- POST/api/v1/tgm/flow-intelligence$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) flow intelligence data
3 parameters
- chainstringbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/flows$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) flows data
5 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- labelstringbody
- token_addressstringbody
- POST/api/v1/tgm/holders$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) holders data
5 parameters
- aggregate_by_entitybooleanbody
- chainstringbody
- filtersobjectbody
- label_typestringbody
- token_addressstringbody
- POST/api/v1/tgm/indicators$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get Nansen Score Indicators
2 parameters
- chainstringbody
- token_addressstringbody
- POST/api/v1/tgm/jup-dca$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get TGM Jupiter DCA Data
2 parameters
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/perp-pnl-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) perp PnL leaderboard data
3 parameters
- dateobjectbody
- filtersobjectbody
- token_symbolstringbody
- POST/api/v1/tgm/perp-positions$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) perp positions data
3 parameters
- filtersobjectbody
- label_typestringbody
- token_symbolstringbody
- POST/api/v1/tgm/perp-trades$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) perp trades data
3 parameters
- dateobjectbody
- filtersobjectbody
- token_symbolstringbody
- POST/api/v1/tgm/pnl-leaderboard$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get "Token God Mode" (TGM) PnL leaderboard data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/position-intelligence$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) position intelligence data
1 parameter
- token_addressstringbody
- POST/api/v1/tgm/token-information$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) token information data
3 parameters
- chainstringbody
- timeframestringbody
- token_addressstringbody
- POST/api/v1/tgm/token-ohlcv$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Retrieve token OHLCV candle data
3 parameters
- chainstringbody
- timeframestringbody
- token_addressstringbody
- POST/api/v1/tgm/transfers$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) transfers data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/tgm/who-bought-sold$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get "Token God Mode" (TGM) who bought/sold data
4 parameters
- chainstringbody
- dateobjectbody
- filtersobjectbody
- token_addressstringbody
- POST/api/v1/transaction-with-token-transfer-lookup$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
Get Transaction with Token Transfer Lookup Data
3 parameters
- block_timestampstringbody
- chainstringbody
- transaction_hashstringbody
- POST/api/v1beta1/tgm/historical-dex-trades$0.05api.nansen.ai
at volume≈ $72.00/day @ 1 call/min·≈ $4,320/day @ 1 call/sec
Get historical "Token God Mode" (TGM) DEX trades (Beta)
4 parameters
- apply_blacklist_filterbooleanbody
- chainstringbody
- date_rangeobjectbody
- token_addressstringbody
- POST/api/v1/agent/expert$7.50api.nansen.ai
at volume≈ $10,800/day @ 1 call/min·≈ $648,000/day @ 1 call/sec
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.
- POST/api/v1/agent/fast$2.00api.nansen.ai
at volume≈ $2,880/day @ 1 call/min·≈ $172,800/day @ 1 call/sec
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.
- POST/api/v1/token-screener$0.01api.nansen.ai
at volume≈ $14.40/day @ 1 call/min·≈ $864/day @ 1 call/sec
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?**