Wallet audit
Full wallet activity review: balance, recent transactions, and token metadata for a given address.
3 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
Investigating wallet activity - what's the balance, what has it been doing, and what tokens are involved.
Tools in this pack
All 3 run inside the single $0.005 call above. Each is also callable on its own if you only need one part.
- Wallet balance (native + ERC-20) POST /api/wallet-balance Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism. Returns clean decimal balances (already scaled by token decimals) plus symbol and contract - ready to display in a UI or feed into a portfolio tool.
- Wallet transaction history POST /api/wallet-transactions Return the most recent asset transfers (incoming + outgoing) for a wallet address - native coin, ERC-20, ERC-721, ERC-1155 - already merged and sorted newest first. Each row carries the block, tx hash, counterparty, asset, and decimal value. Cap is 100 per direction; widen the window via `fromBlock` if you need deeper history.
- ERC-20 token metadata POST /api/token-metadata Resolve an ERC-20 contract address to its on-chain metadata: symbol, decimals, name, and logo URL where available. Use this to humanize a raw contract address before showing it to a user or before computing fiat values.
Bought one at a time, these 3 tools cost $0.005 together; the pack is that sum less a 10% bundle discount, rounded up to the $0.001 settlement floor, which is $0.005.
Workflow
- Get the native + token balances for the address.
- Pull recent transactions to see activity patterns.
- Look up token metadata for contracts the wallet interacts with.
Arguments
| Name | Required | Description | Example |
|---|---|---|---|
address | yes | Wallet address (0x…) | 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 |
What one call returns
A JSON object with pack, args, steps, summary; steps holds one entry per tool (wallet-balance, wallet-transactions, token-metadata), each with its own result or error. Full example on the API page.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response. With the agent402-client SDK (npm i agent402-client, an ES module):
import { Agent402 } from "agent402-client";
// payFetch: an x402-wrapped fetch your wallet signs (@x402/fetch).
// Tools on the free tier need no options: new Agent402() pays them by proof-of-work.
// an existing prepaid credits key also works: new Agent402({ creditsKey })
const client = new Agent402({ fetch: payFetch });
const result = await client.call("skill-wallet-audit", {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"});
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Audit the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Agent402's wallet-audit skill pack. Get (1) balance, (2) recent transactions, (3) token metadata. Summarize activity and flag anything unusual.