🐋 Whale Wallet Tracker

Track high-value whale wallet movements across Ethereum, BNB Chain, and Solana with exchange-aware alerts built for analysts, traders, and automation workflows.

This Actor scans bundled whale registries or your own wallet list, enriches transfers with USD pricing, tags exchange flows, and ranks alerts by severity so you can focus on the movements that actually matter.

Unlike basic wallet trackers, this Actor does more than list transactions. It estimates transfer size in USD, calculates percentage of wallet holdings moved, detects exchange deposits and withdrawals, and highlights the difference between a routine transfer and a potential market-moving event.

---

✨ Key Features

• 🐋 Whale-first monitoring: Track large wallets from a bundled registry or bring your own custom wallet list.
• 🌐 Multi-chain coverage: Monitor activity across Ethereum, BNB Chain, and Solana in one run.
• 🏦 Exchange flow detection: Match transfers against known exchange wallets and deposit clusters, including fuzzy prefix matching.
• 🚨 Severity scoring: Rank alerts as critical, high, medium, or low using configurable USD and holdings-based thresholds.
• 💵 USD valuation: Enrich transfers with CoinGecko pricing for native assets and supported tokens.
• 📊 Holdings context: Calculate pct_of_holdings to show how meaningful a transfer is relative to the wallet's size.
• 🔁 Exchange-to-exchange awareness: Detect flows moving between exchange-controlled wallets.
• 🧾 Clean JSON output: Structured dataset records designed for APIs, dashboards, alerts, and downstream automation.

---

⛓️ Supported Chains

Chain	Native Asset	Balance + Transfer Source
Ethereum	ETH	Etherscan
BNB Chain	BNB	BscScan
Solana	SOL	Solscan

The Actor supports:

• Native token balances and transfers
• ERC-20 / BEP-20 token balances and transfers for tracked contracts
• SPL token transfer tracking on Solana
• Custom wallets and bundled whale registries per chain

---

📊 Sample Output

Each alert is returned as a structured record in the dataset:

{
  "wallet_address": "0x1111111111111111111111111111111111111111",
  "wallet_label": "Sample Whale",
  "chain": "ethereum",
  "token": "ETH",
  "amount": 1850.75,
  "usd_value": 5922400.0,
  "direction": "outflow",
  "destination": {
    "address": "0x9999999999999999999999999999999999999999",
    "label": "Binance Hot Wallet",
    "is_exchange": true,
    "exchange_name": "binance",
    "flow_type": "deposit"
  },
  "alert_severity": "critical",
  "tx_hash": "0xabc123def456",
  "block_number": 19765432,
  "timestamp": 1707004800,
  "metadata": {
    "pct_of_holdings": 12.48,
    "wallet_total_usd": 47450000.0,
    "source_is_exchange": false,
    "source_exchange_name": null,
    "exchange_to_exchange": false
  }
}

The Actor also emits a run-level summary record:

{
  "type": "RUN_SUMMARY",
  "total_wallets": 150,
  "total_transfers_scanned": 892,
  "total_alerts": 27,
  "enabled_chains": ["ethereum", "bsc", "solana"]
}

---

⚙️ How It Works

1. Wallet loading: Pulls bundled whale wallets and merges any custom wallets you provide.
2. Chain scanning: Fetches balances and recent transfers from the relevant chain adapter.
3. Price enrichment: Resolves USD prices for native assets and supported tokens.
4. Exchange matching: Tags counterparties as exchange deposits or withdrawals when they match the exchange address database.
5. Alert scoring: Applies your threshold rules and sorts alerts by severity, then USD value.
6. Output: Pushes alert records and a run summary into the Apify dataset.

---

🚀 How to Use

Method 1: Apify Console

Best for analysts and operators who want a no-code monitoring workflow.

1. Open the Actor in Apify Store.
2. In the Input tab, choose your target chains.
3. Add custom wallets or leave the field empty to use the bundled whale registry.
4. Set min_usd_value and any optional severity thresholds.
5. Click Start.
6. Review alerts in the Dataset tab or connect the dataset to your downstream workflow.

Method 2: API Integration

Trigger the Actor programmatically from your own systems:

curl --request POST \
  --url https://api.apify.com/v2/acts/YOUR_USERNAME~whale-wallet-tracker/runs?token=YOUR_API_TOKEN \
  --header "Content-Type: application/json" \
  --data '{
    "chains": ["ethereum", "bsc", "solana"],
    "wallets": [
      {
        "address": "0x1111111111111111111111111111111111111111",
        "chain": "ethereum",
        "label": "Treasury Wallet"
      },
      {
        "address": "7xKXtg2CW8E4Y9rWcL6sQ9qfDq8f7nP4v1L5Tn6i7Y8Z",
        "chain": "solana",
        "label": "Solana Watchlist Wallet"
      }
    ],
    "min_usd_value": 100000,
    "critical_usd_value": 5000000,
    "critical_exchange_pct_of_holdings": 10,
    "high_exchange_usd_value": 1000000,
    "medium_usd_value": 500000,
    "include_exchange_flows_only": false,
    "top_whales_count": 50
  }'

After the run finishes, read the dataset items through the Apify API or export them to JSON, CSV, or your preferred integration target.

---

🧩 Input Schema

{
  "wallets": [],
  "chains": ["ethereum", "bsc", "solana"],
  "min_usd_value": 50000,
  "include_exchange_flows_only": false,
  "critical_usd_value": 5000000,
  "critical_exchange_pct_of_holdings": 10,
  "high_exchange_usd_value": 1000000,
  "medium_usd_value": 500000,
  "top_whales_count": 50,
  "proxy_configuration": {
    "useApifyProxy": true
  }
}

Parameter	Type	Default	Description
wallets	Array<Object>	[]	Optional custom wallets to monitor. Leave empty to use the bundled whale registry.
chains	Array<String>	["ethereum", "bsc", "solana"]	Chains to scan in the current run.
min_usd_value	Integer	50000	Minimum transfer value in USD required to report an alert.
include_exchange_flows_only	Boolean	false	If true, only exchange-related transfers are returned.
critical_usd_value	Integer	5000000	Transfers above this value are marked critical.
critical_exchange_pct_of_holdings	Number	10	Exchange deposits above this percentage of wallet holdings are marked critical.
high_exchange_usd_value	Integer	1000000	Exchange deposits above this value are marked high unless already critical.
medium_usd_value	Integer	500000	Transfers above this value are marked medium when higher rules do not apply.
top_whales_count	Integer	50	Number of bundled whale wallets to load per chain when custom wallets are not provided.
proxy_configuration	Object	{"useApifyProxy": true}	Optional Apify proxy settings passed through to chain adapters.

Custom wallet example

{
  "wallets": [
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "chain": "ethereum",
      "label": "ETH Treasury"
    },
    {
      "address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
      "chain": "bsc",
      "label": "BNB Whale"
    },
    {
      "address": "7xKXtg2CW8E4Y9rWcL6sQ9qfDq8f7nP4v1L5Tn6i7Y8Z",
      "chain": "solana",
      "label": "SOL Watch Wallet"
    }
  ]
}

---

🧾 Output Schema

Each alert record includes:

Field	Type	Description
wallet_address	String	Source wallet being monitored.
wallet_label	String | null	Human-readable wallet label when available.
chain	String	Blockchain name: ethereum, bsc, or solana.
token	String	Native asset or token symbol.
amount	Number	Transfer amount in token units.
usd_value	Number | null	Estimated USD value when pricing is available.
direction	String	inflow or outflow.
destination.address	String	Counterparty wallet or token account.
destination.label	String | null	Counterparty label when known.
destination.is_exchange	Boolean	Whether the counterparty matched the exchange database.
destination.exchange_name	String | null	Exchange name if matched.
destination.flow_type	String | null	deposit or withdrawal for exchange-related flows.
alert_severity	String	critical, high, medium, or low.
tx_hash	String	Transaction hash or Solana signature.
block_number	Integer | null	Block number or slot when available.
timestamp	Integer	Unix timestamp.
metadata.pct_of_holdings	Number | null	Transfer size as a percentage of wallet holdings.
metadata.wallet_total_usd	Number | null	Estimated total wallet value in USD.
metadata.source_is_exchange	Boolean | null	Whether the monitored wallet is itself recognized as an exchange wallet.
metadata.source_exchange_name	String | null	Exchange name for the source wallet when matched.
metadata.exchange_to_exchange	Boolean	Whether the flow moved between exchange-controlled wallets.

---

⚠️ Disclaimer

This Actor is provided for informational and analytical purposes only.

• Wallet labels and exchange matches are heuristic and database-driven.
• API providers may rate-limit, delay, or omit some activity.
• Token prices can be unavailable or stale for illiquid or newly created assets.
• Large transfers do not automatically imply buying, selling, or market intent.
• This is not financial advice.

Always validate important signals independently before making trading, treasury, or risk decisions.

---

🛠️ Tech Stack

• Apify Actor for scheduling, runs, datasets, and API access
• Python 3.11 runtime
• aiohttp for async network requests
• Etherscan for Ethereum wallet and token activity
• BscScan for BNB Chain wallet and token activity
• Solscan for Solana portfolio and transfer data
• CoinGecko for USD token pricing
• jsonschema / pytest for contract-style output validation

---

Built for crypto intelligence. Shipped for automation.