# Whale Watcher 🐋 (`thrilled_estuary/whale-tracker`) Actor

Spy on crypto whales for $0.25 👀 Track Binance, Coinbase & top wallets. Get AI BUY/SELL alerts. Free tier: 20 whales. No more $150/mo subs. Includes Vitalik's wallet 🐋

- **URL**: https://apify.com/thrilled_estuary/whale-tracker.md
- **Developed by:** [Tanvir](https://apify.com/thrilled_estuary) (community)
- **Categories:** Automation, AI, Developer tools
- **Stats:** 39 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 wallet trackeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🐋 Whale Tracker

Track crypto whale wallets with AI-powered insights. Pay-per-use pricing — $0.25 for 10 whales vs $150+/month subscriptions.

### What It Does

- **Track Wallet Balances**: Monitor ETH + ERC-20 token balances with live USD values
- **AI Trading Signals**: Get BUY/SELL/HOLD recommendations from multiple AI models
- **Historical Analysis**: See 4H and 24H portfolio changes
- **Pattern Detection**: Automated recognition of accumulation, distribution, and smart money moves
- **Known Whale Database**: Track exchanges (Binance, Coinbase), founders (Vitalik), institutions with one click

### Pricing

#### Pay-Per-Use (No Monthly Subscription)

- **Simple Pricing**: $0.03 per wallet tracked
- **No start fee** — only pay for what you track

**Example Costs:**

- Track 1 whale: **$0.03**
- Track 10 whales: $0.03 × 10 = **$0.30**
- Track 50 whales: $0.03 × 50 = **$1.50**

**Compare to competitors:**

- Nansen Pro: $150/month
- Glassnode: $199/month
- **You save 99%** with pay-per-use

#### Free Tier

✅ Track top 20 whales\
✅ 10 runs per month\
✅ Basic wallet tracking\
❌ No AI signals (upgrade to enable)\
❌ No custom wallets (upgrade to enable)\
❌ No historical tracking (upgrade to enable)

**Apify provides $5 free credits monthly** — enough to test with 1-2 runs.

### How to Use

#### Track All Exchange Whales (Easiest!)

```json
{
  "useKnownWhales": ["exchange"]
}
```

Tracks Binance, Coinbase, Kraken, and other major exchanges automatically.

#### Track Founders & Exchanges

```json
{
  "useKnownWhales": ["founder", "exchange"]
}
```

#### Track Custom Wallets

```json
{
  "wallets": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]
}
```

#### Track All Known Whales

```json
{
  "useKnownWhales": "all"
}
```

### Output

Download results as **JSON, CSV, or Excel** from Apify Console.

Each whale wallet includes:

- Wallet address and portfolio value (USD)
- ETH balance and ERC-20 token holdings
- Recent transactions (sends/receives)
- AI signals (ACCUMULATION, DISTRIBUTION, SMART_MONEY_BUY)
- Portfolio changes (4H and 24H comparisons)

### Use Cases

1. **Alert when whales buy >$25k of new tokens** — Set up webhook alerts
2. **Daily CSV of top whale buys** — Run daily and download reports
3. **Track accumulation patterns** — See what smart money is buying before market reacts
4. **Monitor exchange movements** — Track Binance, Coinbase wallet activity
5. **Follow founders** — Monitor Vitalik and other public figure wallets

### Quick Start

1. Go to [Apify Console](https://console.apify.com)
2. Search for "whale-tracker"
3. Click "Start" with default settings
4. Wait ~30 seconds for results
5. Download as JSON/CSV

**No API keys needed** — everything is included!

### ROI Example

**One profitable trade pays for 100+ runs:**

- Average position: $1,000
- 5% gain from whale-timed entry: **$50 profit**
- Cost of whale check: **$0.25**
- **Net profit: $49.75** (199x ROI)

**Weekly checking:**

- Check 10 whales once a week: $0.25/week = **$1/month**
- Nansen Pro: **$150/month**
- **Savings: $149/month** (99% cheaper)

### Support

Questions? Check the [Apify Store page](https://apify.com/thrilled_estuary/whale-tracker) or contact the developer.

***

**Built for traders who want whale intelligence without monthly commitments.**

# Actor input Schema

## `wallets` (type: `array`):

Array of Ethereum wallet addresses to track (e.g., \["0x...", "0x..."]). Leave empty if using known whales.

## `useKnownWhales` (type: `string`):

Track curated whale addresses. Options: 'all' for all whales, or comma-separated categories like 'exchange,founder'

## `chains` (type: `array`):

Array of supported chains. Currently only ETH_MAINNET is supported.

## `includeTokens` (type: `boolean`):

Whether to fetch ERC-20 token balances and USD values for each wallet. Disable to speed up runs and reduce costs.

## `transactionLimit` (type: `integer`):

Number of recent transactions to fetch per wallet. Higher values provide more historical context but increase runtime and costs.

## `minBalanceThreshold` (type: `number`):

Filter wallets below this USD portfolio value. Leave empty or set to 0 to include all wallets.

## `enableAI` (type: `boolean`):

Enable AI swarm analysis for trading insights. Uses multiple AI models to generate consensus recommendations (BUY/SELL/HOLD) with confidence scores. Included - no setup needed!

## `enableHistorical` (type: `boolean`):

Enable historical tracking and 4H/24H portfolio comparisons. Tracks changes over time and detects patterns like accumulation, distribution, and rank changes.

## `maxWallets` (type: `integer`):

Maximum number of wallets to track per run. Prevents accidental high costs. Default: 100.

## `concurrencyLimit` (type: `integer`):

Number of wallets to process concurrently (1-8). Higher values are faster but may hit API rate limits. Default: 2.

## `webhookUrl` (type: `string`):

Telegram or Discord webhook URL to receive alerts when significant whale movements are detected. Leave empty to disable.

## `webhookType` (type: `string`):

Type of webhook service. Required if webhookUrl is provided.

## `plan` (type: `string`):

Set to 'free' to enable free tier limits (20 whales max, no AI signals). Leave empty for paid tier.

## Actor input object example

```json
{
  "useKnownWhales": "exchange,founder",
  "chains": [
    "ETH_MAINNET"
  ],
  "includeTokens": true,
  "transactionLimit": 50,
  "enableAI": true,
  "enableHistorical": true,
  "maxWallets": 100,
  "concurrencyLimit": 2
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("thrilled_estuary/whale-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("thrilled_estuary/whale-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call thrilled_estuary/whale-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,thrilled_estuary/whale-tracker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/PjP3BkJjOs8RzoO74/builds/6ICOlwFsbp8hFiEfS/openapi.json