Skip to main content

​
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

ParameterRequiredDescription
holderAddressYesThe wallet address to check
tokenAddressYesThe token contract address
blockchainNoethereum (default) or base
pageNoPage 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

DirectionMeaning
INTokens received by the holder
OUTTokens 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

“Show me all incoming USDC transfers over $1,000”
“Track aUSDC (Aave deposit token) activity for this wallet”
“Show the WETH in/out flow for this trader”
“When did this wallet start accumulating this token?”

​
Combining with Other Tools

For complete analysis:
  1. Check all holdings → getWalletOverviewTool
  2. Focus on one token → getTokenActivityTool
  3. Analyze specific transfer → queryTransactionTool
  4. 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

TypeSupport
ERC-20Full support
Native ETHFull support
ERC-721 (NFTs)Transfer tracking
ERC-1155Transfer 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