services / token-smart-money
Token Smart Money and Whale Tracker
Smart money and whale activity for a token, straight from the chain: which large wallets are accumulating or distributing right now (buy/sell USD, net, average buy and sell price, realized profit, what they still hold), who the first buyers after launch were and whether they still hold or sold everything, and how much of the volume is bots. Trades are attributed to the wallet that really received or sent the token, so Coinbase smart wallets and aggregator routes count as the real trader. Wallet types from on-chain data: trader, fresh_wallet (< 10 tx, possible insider), smart_account, high_frequency_bot, contract. Base, Ethereum, BSC, Arbitrum, Polygon, Avalanche, Optimism. For trading agents deciding whether to follow or avoid a token.
Call it
Input
| Field | Type | Description |
|---|---|---|
| token * | string | Token contract address (0x...) |
| chain | string | base, ethereum, bsc, arbitrum, polygon, avalanche or optimism. Default base |
| hours | number = 6 | Window for current whale activity, 1 to 24 (limited to the most recent blocks the node serves, about 5.5 h on Base) |
| min_usd | number | USD a wallet must have bought or sold to count as large. Default: 5% of the window volume, between 50 and 1000 |
| early_buyers | boolean = true | Also list the first 20 buyers after launch and whether they still hold |
| include_bots | boolean = false | Keep bots and contracts in large_wallets instead of listing them separately |
Output
| Field | Type | Description |
|---|---|---|
| symbol | string | |
| price_usd | number | |
| window_hours | number | |
| whale_threshold_usd | number | |
| summary | object | |
| signals | array | |
| large_wallets | array | |
| bots_and_contracts | array | |
| early_buyers | object | |
| pools | array |