Skip to main content

Wallet Overview

Returns wallet type, token balances, and activity data for any address.

Returns

  • Wallet Type - EOA, multisig, smart wallet, or delegated account
  • Token Balances - Holdings with USD values
  • Activity - Transaction count, deployed contracts
  • Multisig Details - Signers and pending transactions (for Safes)
  • ERC-7702 - Implementation address for delegated EOAs

Example Queries

Give me an overview of vitalik.eth
What tokens does 0x... hold?
Is this wallet a multisig? Who are the signers?

Parameters

ParameterRequiredDescription
walletAddressYesThe wallet address (0x…)
blockchainNoethereum (default) or base

Wallet Types Detected

TypeDescription
EOAExternally Owned Account (regular wallet)
ERC-7702EOA with delegated code (smart account features)
ERC-4337Smart contract wallet (Account Abstraction)
MultisigSafe or similar multi-signature wallet
ContractOther smart contract

Example Output

Regular Wallet (EOA)

Wallet Overview: 0xUser...
============================
Type: EOA (Externally Owned Account)
Chain: Ethereum

Balances:
┌──────────────┬─────────────────┬────────────────┐
│ Token        │ Balance         │ USD Value      │
├──────────────┼─────────────────┼────────────────┤
│ ETH          │ 15.234          │ $48,234.56     │
│ USDC         │ 25,000.00       │ $25,000.00     │
│ WETH         │ 5.000           │ $15,825.00     │
│ UNI          │ 1,500.00        │ $12,750.00     │
│ AAVE         │ 100.00          │ $8,500.00      │
└──────────────┴─────────────────┴────────────────┘

Total Portfolio Value: ~$110,309.56

Activity:
- Transaction Count: 1,245
- Contracts Deployed: 3
- First Transaction: 2021-03-15

Multisig Wallet (Safe)

Wallet Overview: 0xTreasury...
==============================
Type: Multisig (Gnosis Safe)
Chain: Ethereum
Threshold: 3 of 5 signers

Signers:
1. 0xSigner1... (EOA)
2. 0xSigner2... (EOA)
3. 0xSigner3... (EOA - also a contract signer)
4. 0xSigner4... (EOA)
5. 0xSigner5... (EOA)

Pending Transactions: 2
- Tx #45: Transfer 100 ETH to 0x... (2/3 signatures)
- Tx #46: Upgrade contract 0x... (1/3 signatures)

Balances:
┌──────────────┬─────────────────┬────────────────┐
│ Token        │ Balance         │ USD Value      │
├──────────────┼─────────────────┼────────────────┤
│ ETH          │ 5,000.00        │ $15.8M         │
│ USDC         │ 10,000,000.00   │ $10.0M         │
│ ...          │ ...             │ ...            │
└──────────────┴─────────────────┴────────────────┘

Total Portfolio Value: ~$45.2M

Smart Wallet (ERC-4337)

Wallet Overview: 0xSmartWallet...
=================================
Type: ERC-4337 Smart Account
Implementation: Biconomy Smart Account v2
Chain: Ethereum

Features:
- Batch transactions
- Gasless transactions (paymaster support)
- Social recovery enabled

Balances: [similar to above]

Delegated EOA (ERC-7702)

Wallet Overview: 0xDelegated...
===============================
Type: ERC-7702 Delegated EOA
Delegation: Active
Implementation: 0xImpl... (Coinbase Smart Wallet)

Delegated Functions:
- execute(address,uint256,bytes)
- executeBatch(...)
- supportsInterface(bytes4)

Balances: [similar to above]

Use Cases

TaskQuery
Check control”Is this wallet a multisig?”
Portfolio value”Total value of tokens in this wallet?”
DAO treasury”Details on the Uniswap governance treasury”
  1. Start with overviewgetWalletOverviewTool
  2. Check specific tokensgetTokenActivityTool
  3. View transactionsgetTransactionActivityTool
  4. Check deploymentsgetDeployedContractsTool

Tips

ENS names work: “vitalik.eth” resolves automatically
Be specific: “Is this a fresh wallet?” or “How active is this wallet?”

Common Questions

The overview shows the most valuable holdings. Ask for “all tokens” to see the complete list.
Balances reflect the latest indexed block, typically within seconds of real-time.
Yes, NFT holdings are included with floor price estimates where available.

Limitations

USD values are estimates. Based on current market prices and may fluctuate.
Some tokens may not have prices. Low-liquidity or new tokens might show $0 value.

Next Steps