CLI for on-chain analytics

A minimal, lightweight CLI for discovering on-chain data and early wallet interactions for Ethereum tokens.

Features

• Token Analysis: Input token contract addresses to analyze early interactions
• Early Wallet Discovery: Find the first 50-100 unique wallets that interacted with a token
• Investment Analysis: Estimate investment amounts and identify likely buyers vs airdrop recipients
• Wallet Valuations: Compare initial fills against current holdings and USD value for early wallets
• Multiple Output Formats: Display results in tables, CSV, or JSON
• Smart Heuristics: Distinguish between genuine buyers and airdrop recipients
• Rate Limiting: Built-in API rate limiting to respect service limits
• Multi-API Support: Uses Alchemy for reliable on-chain data, with Etherscan V2 and CoinGecko fallbacks

Installation

Prerequisites

• Python 3.11 or higher
• uv package manager

Setup

1. Install dependencies:

uv sync

2. Set up your API key:

uv run eth-tracker setup

3. Edit the .env file with your API keys:
   • Required: Alchemy API key from https://www.alchemy.com/ (primary data source)
   • Required: Etherscan API key from https://etherscan.io/apis (V2 API for metadata)
   • Optional: CoinGecko API key for enhanced price data

Usage

Basic Usage

Track early wallets for a token by contract address:

uv run eth-tracker track "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"

Example: Track ENA (Ethena) token:

uv run eth-tracker track "0x57e114b691db790c35207b2e685d4a43181e6061"

Advanced Options

# Limit to top 25 early wallets
uv run eth-tracker track "0x57e114b691db790c35207b2e685d4a43181e6061" --max-wallets 25

# Exclude likely airdrop recipients
uv run eth-tracker track "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce" --exclude-airdrops

# Show only wallets holding at least $50k of the token today
uv run eth-tracker track "0x57e114b691db790c35207b2e685d4a43181e6061" --min-usd-value 50000

# Export to CSV
uv run eth-tracker track "0x57e114b691db790c35207b2e685d4a43181e6061" --format csv --output ena_early_wallets.csv

# Export to JSON
uv run eth-tracker track "0xa0b86a33e6441e3c6cdeaf9bf464c44c78a1f0e9" --format json --output analysis.json

CSV/JSON Export

For full copyable wallet addresses and transaction hashes, export to CSV or JSON:

uv run eth-tracker track "0x57e114b691db790c35207b2e685d4a43181e6061" --format csv --output wallets.csv

License

MIT License - free to use this for your own analysis and research.