# Nansen (Blockchain Analytics) MCP > Nansen (Blockchain Analytics) provides deep on-chain insights right from your agent. Track sophisticated capital movements, profile any crypto wallet's history, and monitor real-time token flows across multiple blockchains. Use this MCP to see who holds the money and how it moves. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** smart-money, on-chain-analytics, wallet-profiling, crypto-trading, token-flows ## Description This MCP connects institutional blockchain data directly into your workflow, letting you analyze on-chain activity using natural language prompts. You don't need a dashboard full of tabs; you just ask your agent what you want to know about a wallet or token. You can identify where major capital is flowing by tracking sophisticated movements from large entities and calculating a wallet’s total profit and loss history. For example, you might trace all recent transactions for a specific address or see how much an entire portfolio holds across different protocols. Whether you're checking market metrics for a new asset or performing due diligence on a project, this MCP gives you the raw data to make informed decisions. Accessing these tools through Vinkius means you connect once and get immediate access to Nansen’s full catalog of analytics. ## Tools ### agent_expert Performs complex, multi-step analysis and synthesizes findings from raw on-chain data. ### agent_fast Provides quick answers to simple research questions with low latency for immediate insights. ### perp_leaderboard Lists the most profitable traders on the Hyperliquid perpetual exchange platform. ### points_address Looks up a wallet's ranking and tier status on the Nansen points leaderboard. ### points_leaderboard Retrieves paginated data for the overall Nansen points leaderboard. ### portfolio_defi_holdings Tracks and lists a wallet's current token positions across various DeFi protocols. ### prediction_address_summary Presents key metrics like win rate, total PnL, and age for an address in prediction markets. ### prediction_categories Shows summary statistics for market categories like Politics or Crypto. ### prediction_event_screener Allows browsing and filtering of groups of related prediction markets by event type. ### prediction_market_screener Provides a full list to browse and filter all available prediction markets. ### prediction_ohlcv Generates 1-hour price history candle data for specific prediction markets. ### prediction_orderbook Displays the real-time bid and ask depth (liquidity) for a given prediction market. ### prediction_pnl_by_address Calculates the total profit or loss generated by a single trader in prediction markets. ### prediction_pnl_by_market Ranks and shows profitability data for specific prediction markets. ### prediction_position_detail Shows granular details of token holdings held by various participants in prediction markets. ### prediction_top_holders Identifies the largest and most committed holders within a specific prediction market. ### prediction_trades_by_address Lists all recorded trades for one wallet specifically within the prediction markets ecosystem. ### prediction_trades_by_market Shows a feed of recent trading activity that occurred in a specific prediction market. ### profiler_counterparties Lists the top addresses or entities that an address has interacted with recently. ### profiler_current_balance Retrieves the most up-to-date token balances for any given wallet or entity. ### profiler_historical_balances Provides historical snapshots of an address's holdings over time. ### profiler_labels Retrieves non-premium, public labels attached to a wallet or entity (like ENS). ### profiler_perp_positions Shows the real-time open positions for a wallet on Hyperliquid. ### profiler_perp_trades Retrieves the complete trade history of a wallet on the Hyperliquid platform. ### profiler_pnl_summary Generates an overview of aggregate PnL and identifies the tokens that generated the most profit for an address. ### profiler_pnl Calculates detailed Profit/Loss figures for a specific wallet against a single token. ### profiler_premium_labels Accesses all premium labels, including those identifying 'Smart Money' movements and behavior. ### profiler_related_wallets Finds other wallet addresses that show behavioral patterns similar to a given address. ### profiler_transactions Gathers the most recent blockchain transactions associated with an address. ### search_general Searches for tokens, entities, or contract addresses using their name, symbol, or full contract address. ### smart_money_dcas Analyzes dollar-cost averaging (DCA) strategies used on the Jupiter platform on Solana. ### smart_money_dex_trades Tracks real-time decentralized exchange trading activity over the last 24 hours. ### smart_money_historical_holdings Provides daily snapshots of aggregated holdings specifically from smart money sources (Beta). ### smart_money_holdings Shows the collective token balances currently held by known smart money groups. ### smart_money_netflow Calculates net capital flows, comparing inflows to outflows for specific tokens. ### smart_money_perp_trades Tracks perpetual trading activity on Hyperliquid, specifically linked to smart money movements. ### tgm_dex_trades Lists individual decentralized exchange transactions for a specific token. ### tgm_flow_intelligence Segments and analyzes capital flows, distinguishing between exchanges, whales, and smart money movements. ### tgm_flows Provides hourly snapshots of total inflows versus outflows categorized by type. ### tgm_holders Identifies top token holders and tracks changes in their overall balance over time. ### tgm_indicators Calculates risk and reward scores for a given cryptocurrency asset. ### tgm_jup_dca Analyzes DCA orders placed on Jupiter for Solana-based tokens. ### tgm_pnl_leaderboard Ranks various traders by profit when dealing with a specific token. ### tgm_token_information Gathers metadata, market metrics, and spot trading statistics for any given token. ### tgm_token_ohlcv Generates unified price and volume candle data across multiple timeframes (1 minute to 1 month). ### tgm_transfers Lists the top token transfers that occurred for an ERC-20 standard asset. ### tgm_who_bought_sold Summarizes and quantifies the net buying or selling activity surrounding a specific token. ### token_screener Discovers cryptocurrency assets that are currently gaining traction across multiple chains. ## Prompt Examples **Prompt:** ``` Search for the token 'PEPE' and show me its details. ``` **Response:** ``` I've found the PEPE token. It is currently tracked across multiple exchanges. Would you like to see the Smart Money netflow for PEPE in the last 24 hours? ``` **Prompt:** ``` What are the current Smart Money holdings? ``` **Response:** ``` Fetching aggregated Smart Money balances... The top holdings currently include WETH, USDC, and LINK. I can provide a detailed breakdown of the balance for any of these tokens. ``` **Prompt:** ``` Show me the PnL summary for address 0x71C7656EC7ab88b098defB751B7401B5f6d8976F. ``` **Response:** ``` Analyzing PnL for the specified address... This wallet has an aggregate realized profit of $1.2M, with its most profitable trade being in SHIB. Would you like to see the full transaction history? ``` ## Capabilities ### Analyze wallet financial performance Calculate a crypto address's total profit or loss, tracking its entire investment history. ### Track institutional capital movements Monitor the net flow of funds and aggregated holdings from sophisticated market players. ### Profile any crypto address Retrieve a wallet's current token balances, historical snapshots, and behavioral labels. ### Search for tokens and entities Find specific cryptocurrencies or contract addresses by their name or symbol across the chain. ### Examine decentralized trading activity View real-time trade data from perpetual platforms or major decentralized exchanges. ## Use Cases ### Investigating whale accumulation patterns A researcher wants to know if large, sophisticated wallets are quietly building up a position. They use the MCP to analyze `smart_money_historical_holdings` and cross-reference it with `tgm_flow_intelligence` to confirm sustained buying pressure. ### Validating market hype or rumors A trader hears buzz about a token. They use the MCP's `search_general` tool first, then check `tgm_who_bought_sold` to see if real buyers are entering the market, confirming organic interest. ### Due diligence on a competitor’s strategy A developer needs to understand how a rival is positioning assets. They use `profiler_related_wallets` and `profiler_counterparties` to map out the network of addresses connected to that wallet. ### Evaluating prediction market viability A venture capitalist wants to know if a specific political outcome is backed by money. They use the MCP's `prediction_market_screener` and then check `prediction_orderbook` for real-time liquidity. ## Benefits - Go beyond surface-level data. Instead of just seeing a wallet's balance, you can use `profiler_pnl` to calculate its total profit or loss across all tokens, giving you a true financial picture. - Understand institutional interest by accessing premium labels via `profiler_premium_labels`. This shows you exactly what 'Smart Money' activity looks like and where the big players are moving their funds. - Stop guessing about market direction. Use tools like `smart_money_netflow` to calculate net capital flows, instantly showing if a token is experiencing more inflows or outflows. - Analyze complex trading strategies by running simulations on specific actions, such as using `smart_money_dcas` to evaluate dollar-cost averaging performance on Solana. - Drill down into the details of market activity. You can track every recent transaction for an address with `profiler_transactions`, or see the full trade history from a perpetual exchange using `profiler_perp_trades`. ## How It Works The bottom line is that you get deep, actionable insights into on-chain finance without leaving your chat window. 1. Subscribe to the Nansen MCP and input your required API key. 2. Instruct your AI client on the specific blockchain activity you want to track, like a wallet’s history or smart money flows. 3. Your agent executes the query and returns structured data, showing exactly what's happening with capital movements. ## Frequently Asked Questions **How do I find out if a wallet is 'Smart Money' using Nansen (Blockchain Analytics)?** You can check for institutional activity by accessing premium labels via `profiler_premium_labels`. This tool identifies wallets that exhibit behaviors consistent with sophisticated market players. **Does Nansen (Blockchain Analytics) track historical token movements?** Yes, you can retrieve past data using tools like `profiler_historical_balances` and by analyzing daily snapshots from `smart_money_historical_holdings`, giving you a timeline view. **Can I use Nansen (Blockchain Analytics) for prediction market analysis?** Absolutely. You can track profitability rankings with `prediction_pnl_by_market` or see the largest holders in any given market using `prediction_top_holders`. **How do I check if a token is trending with Nansen (Blockchain Analytics)?** Use the `token_screener` tool to discover tokens that are currently gaining traction across multiple chains, helping you filter out noise and find emerging assets. **Is Nansen (Blockchain Analytics) better than a standard portfolio tracker?** Yes. Standard trackers only show your holdings; this MCP shows the underlying financial relationships by tracking related wallets (`profiler_related_wallets`) and calculating detailed PnL.