Skip to content

Bob-QoQ/smart-money-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Smart Money Tracker

A CLI tool and AI skill that tracks where smart money is flowing on EVM chains. Goes beyond simple rankings by combining multi-timeframe acceleration analysis, smart money consensus scoring, and cross-dimensional signal resonance detection.

Companion to Token Safety Scanner — find opportunities here, verify safety there.


Quick Start

pip install requests

# Scan BSC (default)
python main.py --chain bsc

# Scan ETH with custom timeframes
python main.py --chain eth --timeframes 1h,4h,24h

# Show top 10 only
python main.py --chain bsc --top 10

# JSON output for downstream processing
python main.py --chain bsc --json

What Makes This Different

Binance already has smart money ranking skills. This tool adds three dimensions they don't have:

1. Acceleration Analysis

Pulls inflow data across 1h / 4h / 24h simultaneously and calculates whether smart money is flowing in faster or slower right now.

Token     1h       4h       24h      Trend
CAKE      $120K    $580K    $2.3M    ^ ACCEL   <- pace is increasing
XVS       $5K      $200K    $445K    v DECEL   <- pace is slowing

2. Consensus Scoring

Counts how many independent smart money wallets are buying the same token. A single whale buying $2M is weaker signal than 30 wallets each buying $67K.

Wallets Consensus
50+ VERY HIGH
30-49 HIGH
15-29 MEDIUM
5-14 LOW
<5 MINIMAL

3. Cross-Signal Resonance

Finds tokens appearing across multiple independent signal sources at once:

  • Smart Money inflow (Binance tracker)
  • Social Hype leaderboard
  • Trending tokens rank
  • Meme breakout score (BSC only)

A token in 3+ sources = strong multi-signal convergence worth attention.


Supported Chains

Flag Chain Chain ID
bsc BNB Smart Chain 56
eth Ethereum 1
base Base 8453
solana Solana CT_501

Architecture

smart-money-tracker/
├── adapters/
│   └── binance_web3.py      # All Binance Web3 API calls (free, no auth)
├── tracker/
│   ├── inflow_scanner.py    # Multi-timeframe inflow + acceleration
│   ├── consensus_analyzer.py # Consensus scoring from wallet count
│   └── cross_signal.py      # Cross-dimensional resonance detection
├── main.py                  # CLI entry point
├── SKILL.md                 # AI agent skill definition
└── tests/
    └── test_tracker.py

Data Sources

Source Auth Used For
Binance Web3 API None Smart money inflow, trending, social hype, meme rank

All free, no API keys required.


Running Tests

pip install pytest
python -m pytest tests/ -v

Workflow Integration

Smart Money Tracker          Token Safety Scanner
find what's being bought  →  verify it's safe to buy

Use both skills together for a complete "discover + verify" workflow.


Disclaimer

For informational purposes only. Not financial advice. Data sourced from third-party APIs and may be incomplete or delayed. Always do your own research (DYOR).


License

MIT

About

Multi-timeframe smart money tracker with acceleration analysis, consensus scoring & cross-signal resonance. Powered by Binance Web3 API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages