# Nansen MCP for AI Agents AI Agent Connect > Nansen (Blockchain Analytics) gives your AI agent access to institutional-grade on-chain data. Track Smart Money movements, profile whale wallets, and monitor real-time token flows across multiple chains. Stop digging through complex dashboards and start getting direct answers about blockchain activity. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_LZcbT62Ntm9oE3fQciAEvwgYTYi3bkdkk8Ktr8Es/ai-agent-connect - **Tags:** smart-money, on-chain-analytics, wallet-profiling, crypto-trading, token-flows ## Description Connecting Nansen to your AI agent changes how you handle on-chain research. Instead of jumping between tabs and manually filtering through wallet addresses, you can just ask your agent to find the signal in the noise. It pulls high-quality data to help you see where sophisticated investors are moving their capital and how specific tokens are performing in real-time. Whether you're looking for whale behavior or trying to understand a new prediction market, the data comes back as a clear summary you can actually use. It's a massive time saver for anyone who needs to do deep due diligence without the manual headache. Because Vinkius hosts this Connector, you can plug it into your favorite client and start querying blockchain data immediately. You get to spend your time making decisions rather than hunting for data points. ## Tools ### agent_expert Use this for deep multi-step analysis and synthesis of complex data. It helps your agent handle complex queries. ### agent_fast Get low-latency streamed answers for quick research questions. It works well for fast fact-checking. ### perp_leaderboard See who the most profitable Hyperliquid traders are right now. This helps identify top-performing traders. ### points_address Look up a wallet's tier on the Nansen points leaderboard. It provides a quick status check for a specific address. ### prediction_categories See stats for different market categories like politics or crypto. This helps you see which sectors are most active. ### prediction_event_screener Browse groups of related prediction markets together. This makes it easier to find related events. ### prediction_market_screener Filter through all available prediction markets. Use this to find specific markets quickly. ### prediction_ohlcv Get 1-hour price history candles for prediction markets. It provides a clear view of price action over time. ### prediction_orderbook View the real-time bid and ask depth for a prediction market. This helps you see current market liquidity. ### prediction_pnl_by_address Find the total PnL for a trader in prediction markets. This is great for identifying consistent winners. ### prediction_pnl_by_market Check profitability rankings for a specific prediction market. It shows which bets are paying off best. ### prediction_position_detail See granular holder positions for a specific prediction market. This helps you see where the big bets are. ### prediction_top_holders Identify the largest conviction holders in prediction markets. Use this to see who is putting up the most capital. ### prediction_trades_by_address Look up every trade for a specific wallet in prediction markets. This lets you see a trader's full history. ### prediction_trades_by_market See the most recent trades for a specific prediction market. This gives you a look at live market activity. ### profiler_counterparties Identify the top addresses and entities a wallet interacts with. Use this to map out a whale's network. ### profiler_current_balance Check the current token balances for any address or entity. This provides a real-time snapshot of holdings. ### profiler_historical_balances See historical holding snapshots for a specific address. This helps you track how balances have changed over time. ### profiler_pnl_summary View the aggregate PnL and top profitable tokens for a wallet. This gives a high-level summary of a wallet's success. ### profiler_pnl Get detailed PnL for a specific address and token. This helps you see how a specific wallet is performing on a per-token basis. ### profiler_premium_labels Access all labels including Smart Money tags. Use this to identify the most sophisticated on-chain actors. ### profiler_related_wallets Find wallets related by on-chain behavior. This helps you find connected entities in a cluster. ### profiler_transactions See the most recent blockchain transactions for an address. This gives you a live feed of a wallet's activity. ### smart_money_dcas View DCA strategies on Jupiter for Solana tokens. This helps you see how smart money is entering positions. ### smart_money_dex_trades Monitor real-time DEX trading activity from the last 24 hours. This is great for seeing live whale moves. ### smart_money_historical_holdings View daily snapshots of smart money holdings. Use this to see how big money is accumulating or distributing. ### smart_money_holdings See aggregated token balances held by smart money. This shows you what the sophisticated players are holding. ### smart_money_netflow Track net capital flows for tokens in real-time. This helps you see if tokens are being bought or sold by whales. ### smart_money_perp_trades Monitor perpetual trading activity on Hyperliquid. This helps you track high-leverage smart money moves. ### tgm_dex_trades See individual DEX transactions for a specific token. This lets you see every single trade on a decentralized exchange. ### tgm_flow_intelligence View segmented flows for exchanges, whales, and smart money. This helps you see who is moving the most volume. ### tgm_flows Get hourly snapshots of inflows and outflows by category. This gives you a clear view of capital rotation. ### tgm_holders See top holders with balance change tracking. This helps you see who is accumulating a specific token. ### tgm_indicators Get risk and reward scores for a specific token. This provides a high-level summary of a token's current state. ### tgm_jup_dca View Jupiter DCA orders for tokens on Solana. This lets you see how smart money is building positions. ### tgm_token_information Get metadata, market metrics, and spot trading stats. This provides a comprehensive overview of any token. ### tgm_token_ohlcv View unified price and volume candles for multiple timeframes. This helps you analyze price action across different scales. ### tgm_transfers See the top token transfers for ERC-20 tokens. This helps you identify large movements of specific assets. ### tgm_who_bought_sold Get a summary of net buyers and sellers. This helps you see the overall sentiment for a specific token. ### token_screener Discover trending tokens across different chains. Use this to find new assets that are gaining traction. ### points_leaderboard View the full paginated Nansen points leaderboard. This gives you a broad view of the top ranked entities. ### portfolio_defi_holdings Track your DeFi positions across various protocols. Use this to see your total exposure in one view. ### prediction_address_summary Get a win rate and PnL summary for a specific prediction market wallet. It shows how a specific user is performing. ### search_general Search for tokens and entities by name, symbol, or contract address. This is your starting point for finding any on-chain data. ### tgm_pnl_leaderboard Rank traders by profit for a specific token. This helps you find the best-performing traders on a per-token basis. ### profiler_labels Get non-premium labels like ENS and behavioral tags. This helps you identify known entities. ### profiler_perp_positions View real-time Hyperliquid positions for a wallet. This is useful for tracking perp trading activity. ### profiler_perp_trades Look up the Hyperliquid trade history for a specific address. Use this to see a trader's specific perp moves. ## Prompt Examples **Prompt:** ``` Who are the biggest winners in the recent prediction markets? ``` **Response:** ``` Here are the top-performing traders in current prediction markets: | Trader | Market | PnL | Confidence | | :--- | :--- | :--- | :--- | | **0x71C...** | Election 2024 | **+$1.2M** | High | | **0x92A...** | Crypto Crash | **+$450k** | Medium | | **0x33B...** | Fed Rate Hike | **+$210k** | High | Would you like to see the full transaction history for the top winner? ``` **Prompt:** ``` Is there any smart money moving into PEPE? ``` **Response:** ``` I've analyzed the **Smart Money netflow** for PEPE over the last 24 hours. * **Net Flow:** +$12.4M (Inflow) * **Whale Activity:** 4 major entities moved capital into PEPE from exchanges. * **DEX Activity:** High volume detected on Uniswap. It looks like significant institutional-grade capital is entering the position. ``` **Prompt:** ``` Show me the profile for wallet 0x71C7656EC7ab88b098defB751B7401B5f6d8976F. ``` **Response:** ``` Here is the profile for that address: * **Labels:** Smart Money, Whale * **Current Balance:** 450.2 ETH, 1.2M USDC * **Aggregate PnL:** +$1.2M (Realized) * **Most Profitable Token:** SHIB * **Recent Activity:** Active in prediction markets and DeFi lending. Would you like to see their recent transactions? ``` ## Capabilities ### Track Smart Money netflow See where the biggest players are moving their money in real-time. ### Profile wallet behaviors Get a full history of an address's balances and behavioral labels. ### Analyze DEX trading Monitor live activity on decentralized exchanges and perpetual platforms. ### Monitor prediction markets Check win rates and PnL for various market categories like politics or crypto. ### Search for entities Quickly find tokens or contracts by name, symbol, or contract address. ## Use Cases ### Whale Tracking A researcher wants to know if a whale is dumping a token. They ask the agent to check `smart_money_netflow` and `tgm_flow_intelligence` for the last 24 hours. ### Prediction Market Research A trader wants to find the best prediction markets for an upcoming event. They use `prediction_event_screener` to find related markets and check `prediction_pnl_by_market` for winners. ### Portfolio Audit A user wants to see how a specific wallet is performing in DeFi. They ask the agent to use `portfolio_defi_holdings` and `profiler_pnl` to summarize their gains. ### Token Discovery A developer is looking for new tokens to track. They use `token_screener` to find trending assets and `tgm_token_information` to see the core market metrics. ## Benefits - Track Smart Money movements: Use `smart_money_netflow` to see exactly where big capital is moving without manual filtering. - Analyze whale behavior: Use `profiler_premium_labels` to identify and monitor the actions of institutional-grade entities. - Monitor trading performance: Use `profiler_pnl_summary` to get a quick look at the profitability of any specific wallet. - Explore prediction markets: Use `prediction_market_screener` to find and filter niche markets in seconds. - Get real-time DEX data: Use `smart_money_dex_trades` to see live trading activity across multiple decentralized exchanges. - Analyze price history: Use `tgm_token_ohlcv` to get unified candles for accurate trend analysis on any token. ## How It Works The bottom line is you get instant, conversational access to professional blockchain analytics. 1. Subscribe to the Nansen MCP on Vinkius. 2. Input your Nansen API Key into your AI client settings. 3. Ask your agent to pull on-chain data or summarize whale activity. ## Frequently Asked Questions **Can Nansen MCP track specific whale movements?** Yes, it allows your agent to identify whales using premium labels and track their net capital flows into specific tokens in real-time. **How do I use Nansen to see Smart Money netflow?** You can simply ask your agent to show the netflow for any token. It will pull the latest inflow and outflow data from Nansen's institutional feeds. **Can I see PnL for prediction markets?** Yes, you can view both individual trader PnL summaries and overall profitability rankings for specific prediction markets. **Does Nansen MCP work with any AI client?** It works with any MCP-compatible client, including Claude, Cursor, and Windsurf, as long as you have the Vinkius connection active. **How do I find tokens on different chains with Nansen?** You can use the general search tool to find tokens by name or symbol, and the agent will pull data across the chains Nansen supports. **Can I see real-time DEX trades for a specific token?** Yes, it can pull real-time DEX trading activity, allowing you to see live volume and whale trades on decentralized exchanges. **How can I track where Smart Money is moving capital?** Use the `smart_money_netflow` tool to see net capital flows (inflows vs outflows) for tokens, or `smart_money_holdings` to see aggregated balances held by these sophisticated entities. **Can I identify the behavior or identity of a specific wallet?** Yes, use `profiler_labels` or `profiler_premium_labels` to retrieve behavioral tags (like 'Smart Money', 'Heavy DEX User', or ENS names) associated with any blockchain address. **How do I analyze the performance of a specific address?** Use `profiler_pnl_summary` to get an aggregate view of profits and losses, or `profiler_pnl` for a detailed breakdown of performance for a specific address and token pair.