Nansen Node

The Nansen node brings Nansen's ↗ on-chain intelligence into your workflows: what smart money is buying and selling, who holds and trades a token, a wallet's PnL and history, and prediction-market trader intel. Instead of one node per query, it's a single node with a two-level select — pick a category, then a lens — and the parameter fields change to match.

How It Works

Nansen exposes dozens of endpoints with different inputs — some take a token, some a wallet, some just a chain. Rather than flatten that into an unusable list, the node organizes it as category → lens → parameters:

1. Category — the product group: Smart Money, Token, Wallet, or Prediction Market.
2. Lens — the specific query within that category (e.g. Net Flows, Holders, PnL Summary). Only the lenses for the chosen category are shown.
3. Parameters — re-render based on the lens. Token lenses show a token field; wallet lenses show an address field; smart-money lenses show a chain selector. You never see irrelevant fields.

Every lens returns the same output envelope, so downstream nodes and the AI agent learn the shape once — see Output.

Categories & Lenses

Configuration

Tokens: search by symbol or paste an address

The Token field has a type-ahead. Start typing a symbol (e.g. WETH) and pick the token — the most relevant tokens by market cap come first, so you get the real asset rather than a same-ticker memecoin. You can also paste a contract address directly.

Billing & Credits

The node runs one of two ways, chosen by the API Credential field:

• NickAI Credits (default) — runs on NickAI's Nansen access. You're charged NickAI credits based on the Nansen credits the call actually consumed (most lenses are cheap; a few cost more). Powered by Nansen.
• Your own Nansen API key — runs on your Nansen subscription and credits. NickAI charges nothing for the node step; you pay Nansen directly. Connect a key in Credentials.

Workflow Examples

Smart-Money Alert

Watch what smart money is accumulating and get notified when it's worth a look.

The Nansen node's natural-language {nansen.summary} gives the LLM signal instead of a raw table — e.g. "Smart money net flows on ethereum: 20 tokens. Biggest 24h inflow ATH +$943.3K." The LLM interprets it and Telegram delivers the takeaway.

Multi-Source Consensus

Combine Nansen with other data sources for a higher-conviction signal — the real strength of the envelope is that the LLM can read several sources without custom glue.

Wallet Follower

Pull a wallet's PnL and route on it — useful for copy-trading or watchlists.

Output

Every lens returns the same envelope, so you reference the same paths regardless of which lens ran.

Example Output

{
  "source": "nansen",
  "category": "token",
  "lens": "holders",
  "query": { "chain": "ethereum", "token": "WETH" },
  "summary": "Top holders of WETH on ethereum: 20. Largest: MakerDAO: wETH Joiner $894.78M (22% supply).",
  "rows": [
    {
      "address": "0xf04a5cc80b1e94c69b48f5ee68a08cd2f09a7c3e",
      "address_label": "🤖 MakerDAO: wETH Joiner",
      "token_amount": 539451.19,
      "ownership_percentage": 0.2177,
      "value_usd": 894061017.85
    }
  ],
  "meta": {
    "creditsUsed": 5,
    "rowCount": 20,
    "asOf": "2026-06-24T19:53:00.000Z",
    "attribution": "Powered by Nansen"
  },
  "missing": []
}

The summary is the agent-friendly takeaway; rows holds the full records for Function nodes or conditionals to parse. Use a Function node to inspect a specific lens's row shape if you need particular fields.

Next Steps

• LLM Node — Feed {nansen.summary} into an LLM for analysis and recommendations.
• Function Node — Parse or aggregate the raw rows with custom JavaScript.
• Conditional Node — Route on PnL, flows, or holder thresholds.
• CoinGlass Node — Combine on-chain intel with derivatives data for consensus.
• Credentials — Connect your own Nansen API key.