Token Activity

Returns token balance and transfer history for a specific holder/token pair.

Returns

Current balance
Transfer history (in/out direction)
Paginated results (100 per page)

Example Queries

Show me the USDC transfer history for 0x...

When did this wallet last receive ETH?

Track PEPE token activity for this address

Parameters

Parameter	Required	Description
`holderAddress`	Yes	The wallet address to check
`tokenAddress`	Yes	The token contract address
`blockchain`	No	`ethereum` (default) or `base`
`page`	No	Page number (default: 1)

You can use token symbols (like “USDC”) - Claude will look up the correct contract address.

Example Output

Token Activity for 0xUser...
Token: USDC (0xA0b86991...)
============================

Current Balance: 25,000.00 USDC

Transfer History (Page 1):
┌───────────────────────┬───────────┬─────────────────┬────────────────┐
│ Date                  │ Direction │ Amount          │ Counterparty   │
├───────────────────────┼───────────┼─────────────────┼────────────────┤
│ 2024-01-15 14:32:00   │ OUT       │ 1,000.00        │ 0xDEX...       │
│ 2024-01-14 10:15:00   │ IN        │ 5,000.00        │ 0xCEX...       │
│ 2024-01-13 22:45:00   │ OUT       │ 2,500.00        │ 0xFriend...    │
│ 2024-01-12 08:00:00   │ IN        │ 10,000.00       │ 0xSalary...    │
│ 2024-01-10 16:30:00   │ OUT       │ 500.00          │ 0xMerchant...  │
└───────────────────────┴───────────┴─────────────────┴────────────────┘

Showing 5 of 150 transfers (100 per page)

Understanding Direction

Direction	Meaning
IN	Tokens received by the holder
OUT	Tokens sent from the holder

Use Cases

Track incoming funds:

When did this wallet last receive USDC and from where?

Analyze spending:

How much ETH has this wallet spent in the last month?

Track whale movements:

Track PEPE transfers for this known whale wallet

Pagination

For addresses with extensive history: You: “Show page 5 of USDC transfers for 0x…”

Transfer History (Page 5):
Showing transfers 401-500 of 1,234

Comparing Multiple Tokens

You can ask about multiple tokens: You: “Compare the USDC and USDT activity for this wallet” Claude will make multiple queries and provide comparison.

Common Use Cases

Track salary/income payments

“Show me all incoming USDC transfers over $1,000”

Monitor DeFi positions

“Track aUSDC (Aave deposit token) activity for this wallet”

Analyze trading activity

“Show the WETH in/out flow for this trader”

Investigate token accumulation

“When did this wallet start accumulating this token?”

Combining with Other Tools

For complete analysis:

Check all holdings → getWalletOverviewTool
Focus on one token → getTokenActivityTool
Analyze specific transfer → queryTransactionTool
Check counterparty → getWalletOverviewTool on the other address

Tips

Use token symbols—“USDC activity” is easier than the full address.

Ask for net flow: “What’s the net USDC flow for this wallet?”

Supported Token Types

Type	Support
ERC-20	Full support
Native ETH	Full support
ERC-721 (NFTs)	Transfer tracking
ERC-1155	Transfer tracking

Limitations

100 transfers per page. Use pagination for complete history.

Historical depth. Very old transfers may have limited data.

Next Steps

Wallet Overview

See complete wallet profile

Deployed Contracts

Find contracts created by an address

Configuration

Contract Tools

Transaction Tools

Wallet Tools

Bookmark Tools

HAL Tools

Token Activity

Token Activity

Returns

Example Queries

Parameters

Example Output

Understanding Direction

Use Cases

Comparing Multiple Tokens

Common Use Cases

Combining with Other Tools

Tips

Supported Token Types

Limitations

Next Steps

Wallet Overview

Deployed Contracts

​Token Activity

​Returns

​Example Queries

​Parameters

​Example Output

​Understanding Direction

​Use Cases

​Pagination

​Comparing Multiple Tokens

​Common Use Cases

​Combining with Other Tools

​Tips

​Supported Token Types

​Limitations

​Next Steps

Wallet Overview

Deployed Contracts

Token Activity

Returns

Example Queries

Parameters

Example Output

Understanding Direction

Use Cases

Pagination

Comparing Multiple Tokens

Common Use Cases

Combining with Other Tools

Tips

Supported Token Types

Limitations

Next Steps