Santiment Node

The Santiment node brings Santiment's ↗ social and on-chain data into your workflows: whether sentiment on an asset is positive or negative, which narratives are spiking across Reddit, X and Telegram, how the chain underneath is behaving, and where an asset sits in its cycle. Like the Nansen and CoinGlass nodes, it's a single node with a two-level select — pick a category, then a lens — and the parameter fields change to match.

Where It Fits

NickAI carries three market-intelligence providers, and they answer different questions. Reaching for the wrong one is the most common mistake:

• CoinGlass answers what the market is doing — aggregate derivatives, funding, open interest, liquidations. No identity.
• Nansen answers who is doing it — labelled wallets, smart money, holders.
• Santiment answers what the market is saying, and how the chain is behaving underneath — social, narrative, on-chain vitality.

How It Works

1. Category — the data family: Social, Narrative, On-chain, Valuation, Development, or Signals.
2. Lens — the specific dataset within that category. Only the lenses for the chosen category are shown.
3. Parameters — re-render based on the lens. Per-asset lenses show an Asset field; Word Context shows a Word field; the narrative lenses show neither, because they're market-wide.

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

Categories & Lenses

Configuration

History window

Most Santiment metrics are served on a 2-year rolling window on NickAI's plan. The node checks the requested lookback against that window before sending the request, so an over-wide range is a fixable validation error rather than a wasted call. Dev Activity is the exception — it has unlimited history and isn't held to the 2-year limit.

If a request is clamped anyway (for example a config built dynamically), the output says so at {santiment.meta.historyClamped}.

Data freshness

Two lenses are not live, and it matters:

• Anomaly Feed returns sparse events, not a timeseries. It always looks back at least 90 days, and returning few or no rows genuinely means nothing fired.
• Major Topics is published every ~3 days, about a week in arrears. It tells you what a period was about — never what's happening now. Use Trending Stories for that.

Billing & Credits

The node runs on NickAI's Santiment access at a flat 5 credits a call, whichever lens you pick. There's no bring-your-own-key path.

Workflow Examples

Sentiment Regime Gate

Only act when the crowd has turned — use sentiment as a filter on another signal.

Narrative Radar

Catch a story before it's priced in. The narrative lenses need no asset, so this runs market-wide.

Each story carries a bullishRatio, a bearishRatio and the tokens it mentions, so the LLM has the lean and the tickers without any custom glue.

Multi-Source Consensus

The three providers answer different questions, so reading them together is stronger than any one alone.

Output

Every lens returns the same envelope. Metric lenses fill series and latest; narrative lenses fill rows. Never both.

Example Output

{
  "source": "santiment",
  "category": "social",
  "lens": "sentiment",
  "query": { "asset": "BTC", "slug": "bitcoin", "interval": "1d", "days": 30 },
  "summary": "bitcoin sentiment is net negative (balance -10.81, rising). Positive 58.79 vs negative 69.60.",
  "latest": {
    "sentiment_balance_total": -10.81,
    "sentiment_positive_total": 58.79,
    "sentiment_negative_total": 69.6
  },
  "series": {
    "sentiment_balance_total": [
      { "datetime": "2026-09-11T00:00:00Z", "value": -14.2 },
      { "datetime": "2026-09-12T00:00:00Z", "value": -10.81 }
    ]
  },
  "rows": [],
  "meta": {
    "asOf": "2026-09-13T10:31:00.000Z",
    "asOfData": "2026-09-12T00:00:00Z",
    "metricsRequested": 4,
    "metricsReturned": 4,
    "rateLimitCost": 4,
    "attribution": "Powered by Santiment"
  },
  "missing": []
}

Next Steps

• LLM Node — Feed {santiment.summary} into an LLM for analysis and recommendations.
• Function Node — Parse series or rows with custom JavaScript.
• Conditional Node — Route on a sentiment balance, dominance or whale threshold.
• Nansen Node — Add wallet-level identity to the social picture.
• CoinGlass Node — Add derivatives positioning for consensus.