# Smart Money Wallet Tracker (`gochujang/smart-money-tracker`) Actor Track on-chain activity of whale wallets across Ethereum, BSC, and Solana. Detect large transfers, token swaps, and portfolio changes in real time. - **URL**: https://apify.com/gochujang/smart-money-tracker.md - **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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) ```json { "mode": "both", "chains": ["ethereum"], "minTxValueUsd": 50000, "lookbackHours": 24, "maxDiscoveredWallets": 20 } ```` #### Example: Monitor specific wallets ```json { "mode": "monitor", "wallets": [ "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503" ], "chains": ["ethereum", "base"], "minTxValueUsd": 100000 } ``` *** ### Output All records include a `_type` field for easy filtering. #### `tx` — Individual whale transaction ```json { "_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 ```json { "_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 ```json { "_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 ```json { "_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) ```json { "_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 ```bash ## 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 ```bash ## 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. # Actor input Schema ## `mode` (type: `string`): discover: find smart money wallets from top-gaining tokens. monitor: scan wallets and output insights. both: run discover then monitor. ## `wallets` (type: `array`): List of wallet addresses to track. If empty in monitor mode, uses auto-discovered wallets from previous discover runs. ## `chains` (type: `array`): Which chains to check ## `minTxValueUsd` (type: `integer`): Only report transactions above this USD value ## `lookbackHours` (type: `integer`): How many hours back to scan transactions ## `maxDiscoveredWallets` (type: `integer`): How many top-scored discovered wallets to include in monitor mode (0 = manual only) ## `includeTokenBalances` (type: `boolean`): Fetch current token holdings for each wallet ## `etherscanApiKey` (type: `string`): Free key from etherscan.io for higher rate limits ## `solscanApiKey` (type: `string`): From pro.solscan.io for higher Solana rate limits ## `telegramBotToken` (type: `string`): Send whale alerts to Telegram. Get a bot token from @BotFather. ## `telegramChatId` (type: `string`): Your Telegram chat ID to receive alerts ## Actor input object example ```json { "mode": "monitor", "wallets": [], "chains": [ "ethereum" ], "minTxValueUsd": 10000, "lookbackHours": 24, "maxDiscoveredWallets": 20, "includeTokenBalances": true, "etherscanApiKey": "", "solscanApiKey": "", "telegramBotToken": "", "telegramChatId": "" } ``` # Actor output Schema ## `transactions` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "wallets": [] }; // Run the Actor and wait for it to finish const run = await client.actor("gochujang/smart-money-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "wallets": [] } # Run the Actor and wait for it to finish run = client.actor("gochujang/smart-money-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "wallets": [] }' | apify call gochujang/smart-money-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gochujang/smart-money-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Smart Money Wallet Tracker", "description": "Track on-chain activity of whale wallets across Ethereum, BSC, and Solana. Detect large transfers, token swaps, and portfolio changes in real time.", "version": "0.1", "x-build-id": "dzSp5Os0BC7XPXy0N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~smart-money-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-smart-money-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gochujang~smart-money-tracker/runs": { "post": { "operationId": "runs-sync-gochujang-smart-money-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gochujang~smart-money-tracker/run-sync": { "post": { "operationId": "run-sync-gochujang-smart-money-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "discover", "monitor", "both" ], "type": "string", "description": "discover: find smart money wallets from top-gaining tokens. monitor: scan wallets and output insights. both: run discover then monitor.", "default": "monitor" }, "wallets": { "title": "Wallet Addresses (optional in monitor mode)", "type": "array", "description": "List of wallet addresses to track. If empty in monitor mode, uses auto-discovered wallets from previous discover runs.", "items": { "type": "string" } }, "chains": { "title": "Blockchains", "type": "array", "description": "Which chains to check", "items": { "type": "string", "enum": [ "ethereum", "bsc", "base", "arbitrum", "solana" ] }, "default": [ "ethereum" ] }, "minTxValueUsd": { "title": "Minimum Transaction Value (USD)", "minimum": 0, "type": "integer", "description": "Only report transactions above this USD value", "default": 10000 }, "lookbackHours": { "title": "Lookback Period (hours)", "minimum": 1, "maximum": 168, "type": "integer", "description": "How many hours back to scan transactions", "default": 24 }, "maxDiscoveredWallets": { "title": "Max Auto-Discovered Wallets (monitor mode)", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many top-scored discovered wallets to include in monitor mode (0 = manual only)", "default": 20 }, "includeTokenBalances": { "title": "Include Current Token Balances", "type": "boolean", "description": "Fetch current token holdings for each wallet", "default": true }, "etherscanApiKey": { "title": "Etherscan API Key (optional)", "type": "string", "description": "Free key from etherscan.io for higher rate limits", "default": "" }, "solscanApiKey": { "title": "Solscan API Key (optional)", "type": "string", "description": "From pro.solscan.io for higher Solana rate limits", "default": "" }, "telegramBotToken": { "title": "Telegram Bot Token (optional)", "type": "string", "description": "Send whale alerts to Telegram. Get a bot token from @BotFather.", "default": "" }, "telegramChatId": { "title": "Telegram Chat ID (optional)", "type": "string", "description": "Your Telegram chat ID to receive alerts", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```