{"ok":true,"host":"api.nansen.ai","status":"ready","manifest":{"positioning":"Nansen's API serves agents and applications that need on-chain intelligence beyond raw blockchain data — specifically, data enriched with wallet labels (smart money, institutions, known entities). It is oriented toward research, due diligence, and signal generation workflows rather than trade execution. Its primary differentiator is the labeled-wallet layer applied across token holders, DEX trades, perpetual trades, and fund flows. It covers multiple chains and asset classes including fungible tokens and prediction markets.","host_overview":"api.nansen.ai provides on-chain blockchain analytics via a REST API, covering smart-money wallet tracking, token holder analysis, fund flow tracing, DEX and perpetual trade monitoring, and prediction market data. It draws on Nansen's labeled wallet database to surface activity from identified high-signal traders and entities. All endpoints return historical or snapshot data — there is no real-time streaming or order book access.","routing_guidance":"Use api.nansen.ai when an agent requires on-chain analytics enriched with wallet labels — specifically smart-money tracking, holder quality assessment, fund flow tracing, or prediction market intelligence. It is the right choice for due diligence on tokens, wallet profiling, and detecting high-signal trader activity across DEX spot and perpetual markets. Do not use it for real-time price feeds, OHLCV candles, or order book data — use a dedicated market data provider (e.g., CoinGecko, Binance, or a DEX quote API) instead. Do not use it for trade execution or swap routing — use a DEX aggregator API instead. It does not support real-time streaming or websocket feeds; all endpoints return snapshots or paginated historical records. CEX activity and off-chain data are outside its scope entirely.","capability_clusters":[{"skill_names":["search-nansen-tokens-and-entities","fetch-tgm-token-information","search-nansen-token-screener"],"cluster_name":"Token Discovery and Metadata","cluster_summary":"Resolve token identities, retrieve full token profiles, and screen tokens by on-chain metrics to build a foundational understanding of any asset before deeper analysis."},{"skill_names":["fetch-token-holders","fetch-who-bought-sold"],"cluster_name":"Token Holder Analysis","cluster_summary":"Identify who holds a token, at what concentration, and with what inflow/outflow history, including filtering by smart-money or institutional labels."},{"skill_names":["fetch-smart-money-holdings","fetch-smart-money-dex-trades","fetch-smart-money-perp-trades"],"cluster_name":"Smart Money Activity","cluster_summary":"Track what labeled high-signal wallets are holding, buying, and trading across spot DEX and perpetual markets on supported chains."},{"skill_names":["fetch-tgm-transfers","fetch-nansen-flowmap","fetch-nansen-flow-intelligence"],"cluster_name":"Fund Flow and Transfer Tracing","cluster_summary":"Trace on-chain capital movement for wallets, tokens, and protocols — including raw transfer records, aggregated flow maps, and multi-chain flow intelligence for risk and counterparty analysis."},{"skill_names":["fetch-address-current-balance"],"cluster_name":"Wallet Portfolio Snapshot","cluster_summary":"Retrieve the current token holdings and USD valuations for a specific wallet address on a supported chain."},{"skill_names":["fetch-prediction-market-categories","fetch-prediction-market-trades","fetch-prediction-market-trades-by-address","fetch-prediction-market-top-holders"],"cluster_name":"Prediction Market Intelligence","cluster_summary":"Explore prediction market categories, retrieve trade history for specific markets or wallets, and identify top position holders for concentration and sentiment analysis."}],"cross_skill_workflows":[{"steps":[{"skill_name":"search-nansen-tokens-and-entities","description":"Resolve the token name or symbol to a verified contract address and chain."},{"skill_name":"fetch-tgm-token-information","description":"Retrieve full token metadata, market cap, FDV, trading volume, and spot activity for the resolved contract."},{"skill_name":"fetch-token-holders","description":"Identify top holders, filter for smart-money or institutional labels, and assess ownership concentration."},{"skill_name":"fetch-smart-money-holdings","description":"Check whether the token appears in smart-money wallet holdings and review 24h balance changes and sector tags."},{"skill_name":"fetch-who-bought-sold","description":"Identify which wallets bought or sold the token recently to assess directional conviction from labeled participants."}],"when_to_use":"Use when an agent needs to build a comprehensive profile of a token — from identity resolution through holder quality and smart-money interest.","workflow_name":"Token Due Diligence Pipeline"},{"steps":[{"skill_name":"fetch-smart-money-dex-trades","description":"Pull recent DEX trades by smart-money wallets on the target chain to identify tokens being accumulated or distributed."},{"skill_name":"fetch-smart-money-perp-trades","description":"Cross-reference with perpetual trade activity from the same labeled wallets to detect directional conviction or hedging behavior."},{"skill_name":"fetch-smart-money-holdings","description":"Confirm current holdings to distinguish short-term trades from sustained positions."}],"when_to_use":"Use when an agent needs to surface tokens or positions that smart-money wallets are actively trading across both spot and derivatives markets.","workflow_name":"Smart Money Signal Aggregation"},{"steps":[{"skill_name":"fetch-address-current-balance","description":"Snapshot the wallet's current token holdings and USD values to establish its present state."},{"skill_name":"fetch-tgm-transfers","description":"Retrieve historical transfer records for the address to map inbound and outbound token movements."},{"skill_name":"fetch-nansen-flow-intelligence","description":"Apply multi-chain flow intelligence to identify counterparties, detect risk signals, and trace fund sources and sinks."}],"when_to_use":"Use when an agent needs to trace the origin or destination of funds for a specific wallet address, such as for risk assessment or counterparty identification.","workflow_name":"Wallet Fund Flow Investigation"},{"steps":[{"skill_name":"search-nansen-token-screener","description":"Screen and rank tokens across chains using smart money activity, holder counts, or volume filters."},{"skill_name":"fetch-token-holders","description":"For top-ranked tokens, retrieve paginated holder lists filtered by label type or ownership threshold."},{"skill_name":"fetch-who-bought-sold","description":"Identify recent buyers and sellers of the shortlisted tokens to assess momentum and wallet quality."}],"when_to_use":"Use when an agent needs to rank tokens by on-chain criteria and then investigate the holder base of top candidates.","workflow_name":"Token Screening to Holder Drill-Down"},{"steps":[{"skill_name":"fetch-prediction-market-categories","description":"Survey available categories to identify markets with high volume, open interest, or trader activity."},{"skill_name":"fetch-prediction-market-trades","description":"Retrieve trade history for a specific market ID identified in the category overview."},{"skill_name":"fetch-prediction-market-top-holders","description":"Identify the largest position holders in the market to assess concentration and potential price impact."}],"when_to_use":"Use when an agent needs to evaluate a prediction market category, find active markets, and assess participant concentration.","workflow_name":"Prediction Market Research"}]},"model":"claude-sonnet-4-6","version_no":10,"generated_at":"2026-05-29T18:19:54.827Z","provenance":"ai_authored_unreviewed","ai_authored":true,"merchant_reviewed":false,"merchant_edited":false,"merchant_reviewed_at":null,"merchant_edited_at":null,"skill_md_url":"https://x402gle.com/servers/api.nansen.ai/SKILL.md","skills_url":"https://x402gle.com/servers/api.nansen.ai/skills.json"}