Smart Money Wallet Tracker

Automatically discover and monitor whale wallets across Ethereum, Base, Arbitrum, BSC, and Solana. Find wallets that buy tokens before they pump, track their current positions, and get structured market insights — no API key required.

---

What It Does

Most whale trackers require you to already know which wallets to watch. This Actor goes further:

1. Discover — Automatically finds wallets that bought top-gaining tokens before they pumped. Ranks them by "hit rate" using a persistent scoring database.
2. Monitor — Scans tracked wallets for large transactions, aggregates token flow, and detects coordinated buying signals.
3. Insights — Outputs structured signals: which tokens smart money is accumulating, how many wallets are piling in simultaneously, and net inflow/outflow by token.

---

Modes

Mode	What it does
discover	Fetches top 24h gainers, finds early buyers for each, scores wallets by prediction accuracy, saves to persistent KV Store
monitor	Scans wallets (yours + auto-discovered) for large transactions, outputs insights
both	Runs discover then monitor in sequence

Recommended schedule:

• Daily: mode: "discover" — refresh smart money rankings
• Hourly: mode: "monitor" — get fresh transaction data and signals

---

Input

Field	Type	Default	Description
mode	string	"monitor"	discover, monitor, or both
wallets	string[]	[]	Wallet addresses to monitor. If empty in monitor mode, uses auto-discovered wallets
chains	string[]	["ethereum"]	ethereum, bsc, base, arbitrum, solana
minTxValueUsd	number	10000	Only report transactions above this USD value
lookbackHours	number	24	How far back to scan (max 168 = 7 days)
maxDiscoveredWallets	number	20	How many top-scored auto-discovered wallets to include in monitor mode
etherscanApiKey	string	""	Optional Etherscan key for higher rate limits
telegramBotToken	string	""	Optional — send whale alerts to Telegram
telegramChatId	string	""	Telegram chat ID for alerts

Example: Fully automated (no wallet list needed)

{
  "mode": "both",
  "chains": ["ethereum"],
  "minTxValueUsd": 50000,
  "lookbackHours": 24,
  "maxDiscoveredWallets": 20
}

Example: Monitor specific wallets

{
  "mode": "monitor",
  "wallets": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503"
  ],
  "chains": ["ethereum", "base"],
  "minTxValueUsd": 100000
}

---

Output

All records include a _type field for easy filtering.

tx — Individual whale transaction

{
  "_type": "tx",
  "chain": "ethereum",
  "tx_hash": "0x280371...",
  "timestamp": "2026-04-05T10:00:00+00:00",
  "wallet": "0xd8da6b...96045",
  "direction": "in",
  "token_symbol": "USDC",
  "amount": 5000000,
  "usd_value": 5000000
}

wallet_summary — Per-wallet aggregate

{
  "_type": "wallet_summary",
  "wallet": "0xd8da6b...96045",
  "is_discovered": true,
  "sm_score": 4.16,
  "tx_count": 14,
  "total_inflow_usd": 847200,
  "total_outflow_usd": 312400,
  "current_holdings": [
    {"symbol": "USDC", "amount": 4200000}
  ]
}

insight_token_flow — Which tokens money is flowing into/out of

{
  "_type": "insight_token_flow",
  "symbol": "ARB",
  "inflow_usd": 2400000,
  "outflow_usd": 150000,
  "net_usd": 2250000,
  "wallets_in": 6,
  "wallets_out": 1
}

insight_signal — Coordinated buying signal

{
  "_type": "insight_signal",
  "signal_type": "coordinated_buy",
  "symbol": "PEPE",
  "wallet_count": 5,
  "inflow_usd": 800000,
  "strength": "strong"
}

smart_money_rank — Discovered wallet rankings (discover mode)

{
  "_type": "smart_money_rank",
  "rank": 1,
  "address": "0xabc...123",
  "hits": 7,
  "score": 13.62,
  "hit_rate": 0.87,
  "tokens_hit": ["PEPE", "WIF", "BONK", "DOGE"]
}

---

Filtering Output via API

# Get only coordination signals
curl "https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=YOUR_TOKEN" \
  | jq '[.[] | select(._type == "insight_signal")]'

# Get token flow sorted by net inflow
curl "https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=YOUR_TOKEN" \
  | jq '[.[] | select(._type == "insight_token_flow")] | sort_by(-.net_usd)'

# Get top smart money wallets
curl "https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=YOUR_TOKEN" \
  | jq '[.[] | select(._type == "smart_money_rank")] | sort_by(.rank)'

---

Supported Chains

Chain	Data Source	Notes
Ethereum	BlockScout ETH	Free, no key needed
Base	BlockScout Base	Free, no key needed
Arbitrum	BlockScout Arbitrum	Free, no key needed
BSC	BlockScout BSC	Free, no key needed
Solana	Solscan Public	SPL token transfers

---

Pricing

Pay-Per-Event (PPE):

• $0.02 per wallet scanned
• No charge for discover-only runs
• Apify platform usage included

Example: Monitoring 20 auto-discovered wallets on Ethereum hourly = $0.40/hour = ~$9.60/day

---

API Integration

# Trigger a run
curl -X POST "https://api.apify.com/v2/acts/gochujang~smart-money-tracker/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "both", "minTxValueUsd": 50000}'

# Poll for completion then fetch results
RUN_ID="..."
curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=YOUR_TOKEN"

---

How the Discovery Works

1. Fetches the top 20 tokens by 24h price gain (>20%) from CoinGecko
2. For each token, scans Ethereum transfer history 72 hours before the pump
3. Identifies wallets that made repeated purchases (not DEX routers or burn addresses)
4. Scores each wallet: score = hits × log(1 + hits) — rewards consistency
5. Results persist in a named Apify KV Store across runs, so the ranking improves over time

Running discover daily for a week gives you a high-confidence smart money list with proven prediction history.