← all AgentPay tools

whale_activity

Detect recent large wallet movements for a token (whale tracking).

When agents use this

You need to detect large token transfers that may signal institutional moves, accumulation, or sell-offs.

Parameters

name	type	required	description
token	string	yes	Token symbol to track
min_usd	number	no	Minimum transaction size in USD

Returns

large_transfers[] with from, to, amount, usd_value, minutes_ago; total_volume_usd

Example response

{
  "token": "USDC",
  "large_transfers": [
    {
      "from": "0xabc...1234",
      "to": "0xdef...5678",
      "amount": 5000000.0,
      "usd_value": 5000000.0,
      "minutes_ago": 12
    },
    {
      "from": "0x111...aaaa",
      "to": "0x222...bbbb",
      "amount": 2500000.0,
      "usd_value": 2500000.0,
      "minutes_ago": 34
    }
  ],
  "total_volume_usd": 7500000.0,
  "source": "etherscan"
}

Call it — HTTP (x402)

curl -X POST https://agentpay.tools/tools/whale_activity/call \
  -H 'Content-Type: application/json' \
  -d '{"parameters": {"token": "Token symbol to track"}, "agent_address": "<your wallet or any identifier>"}'

Call it — Python SDK

from agentpay import quickstart  # pip install agentpay-x402

s = quickstart(max_spend=0.10)   # hard budget cap; mints a wallet, no funding needed
r = s.call("whale_activity", {"token": "Token symbol to track"})
print(r.data)                    # + r.cost, r.tx, r.network — full receipt

Call it — MCP

npx -y @romudille/agentpay-mcp   # keyless; exposes whale_activity to any MCP agent runtime