Skip to content

linnbenton/nansen-smart-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Nansen Smart Money Tracker 🚀

Turning on-chain data into actionable alpha signals.


🧠 Overview

In crypto, the best opportunities don’t start with hype — they start with smart money behavior.

Before a token trends:

  • wallets accumulate
  • volume builds
  • patterns emerge

Nansen Smart Money Tracker is built to detect these early signals by analyzing smart money activity, trading behavior, and token-level metrics.


🚀 What This Project Does

This tool transforms Nansen CLI data into interpretable alpha signals:

  • 🔍 Detects smart money participation
  • 📈 Identifies high-volume token activity
  • 👥 Analyzes buyer distribution
  • 💡 Generates reasoning-based insights
  • 🏆 Ranks tokens by confidence score

👉 The result: clear, explainable signals — not just raw data


🧩 Detection Engine

This project operates using a data-driven heuristic engine:

🔹 Smart Money Layer

Tracks how many smart wallets are interacting with a token.

🔹 Volume Layer

Evaluates total trading activity to detect strong market interest.

🔹 Participation Layer

Measures how many unique buyers are involved.

🔹 Behavior Layer

Uses average buy size to identify serious capital commitment.


🧠 From Data → Insight → Signal

Layer Description
Data Nansen CLI aggregated output
Metrics Volume, buyers, smart money
Insight Behavior interpretation
Signal Ranked opportunity with confidence

📊 Example Output

🔥 SMART MONEY SIGNAL DETECTION RESULTS

#1 FAF 🏆

Volume: 15000
Buyers: 5
Smart Wallets: 3
Confidence: 85% 🔥 STRONG

Reasons:
- Smart money actively buying
- High trading volume
- Strong buyer participation
- Large average buy size

🧪 How Signals Are Generated

Each token is evaluated using:

  • Smart money activity
  • Total trading volume
  • Buyer distribution
  • Average position size

These factors are combined into a confidence score (0–100%).


⚡ Why This Matters

Most tools show what happened.

This tool explains:

WHY it matters — and WHAT it could mean next

By focusing on behavior instead of just data, it helps surface early signals before they become obvious.


🏆 Key Differentiators

  • ✅ Behavior-based analysis (not just volume)
  • ✅ Explainable signals (reasoning included)
  • ✅ Confidence scoring system
  • ✅ Clean ranked output
  • ✅ Built specifically for Nansen-style data

▶️ Usage

Run with Nansen Dataset

npm start

Run with Custom Dataset

node src/index.js data/nansen-output.json

🛠 Tech Stack

  • Node.js
  • Nansen CLI
  • JavaScript (ES Modules)

🔮 Future Improvements

  • Real-time smart money tracking
  • Wallet-level intelligence (labeling & history)
  • Trend detection (multi-timeframe signals)
  • Web dashboard visualization
  • Alert system (Telegram / Discord)

📌 Case Study — Early Smart Money Signal

This example demonstrates how the system detects early-stage accumulation before broader market attention.

🧾 Input (Nansen Data)

{
  "token": "FAF",
  "totalVolume": 15000,
  "uniqueBuyers": 5,
  "smartMoneyInterest": 3,
  "avgBuySize": 3000
}

🔍 Detected Signal

#1 FAF 🏆

Volume: 15000
Buyers: 5
Smart Wallets: 3
Confidence: 85% 🔥 STRONG

Reasons:
- Smart money actively buying
- High trading volume
- Strong buyer participation
- Large average buy size

🧠 Interpretation

  • Multiple smart wallets entered early
  • Volume increased without hype
  • Buyers were distributed (not a single whale)
  • Average buy size indicates strong conviction

👉 This pattern suggests early accumulation before potential trend formation


💡 Insight

Smart money tends to accumulate quietly before narratives form.

This tool surfaces those moments — turning raw data into actionable insight.


🎬 Demo

Run the tracker with real Nansen CLI output:

npm start

🖥 Example CLI Output

🔥 SMART MONEY SIGNAL DETECTION RESULTS

#1 FAF 🏆

Volume: 15000
Buyers: 5
Smart Wallets: 3
Confidence: 85% 🔥 STRONG

Reasons:
- Smart money actively buying
- High trading volume
- Strong buyer participation
- Large average buy size

⚡ What This Demo Shows

  • Real-time signal generation from Nansen data
  • Ranking based on confidence score
  • Explainable reasoning behind each signal

⚠️ Disclaimer

This project is for research and educational purposes only.

It does NOT constitute financial advice. All signals are heuristic-based and should be used with proper risk management.


⭐ Support

If you find this useful:

  • ⭐ Star the repo
  • 🧠 Build on top of it
  • 🚀 Share your improvements

About

Smart money signal detector built with Nansen CLI concepts. Detects high-value transactions and identifies potential alpha signals.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors