{"name":"wallet","oldName":"wallet_snapshot","title":"What's in this wallet","category":"wallets","useWhen":"Run when asked what a wallet holds or is worth. One call instead of balance + tokens + history, and spam is kept out of the total.","benefit":{"kind":"accuracy","text":"Keeps priced and unpriced, verified and unverified holdings apart, so spam airdrops don't inflate what a wallet is worth."},"description":"SOL balance, top tokens with USD values, estimated total worth, and recent activity, in one answer.","price":"$0.01","priceText":"25 free calls a day, then $0.01 USDC per call (x402)","http":{"method":"POST","path":"/api/tools/wallet","body":"JSON object with the inputs below"},"mcp":{"method":"tools/call","name":"wallet"},"inputs":[{"name":"wallet","type":"string (base58 address)","required":true,"lookingFor":"The wallet address to sum up.","whereToGet":"The user's wallet address."},{"name":"network","type":"\"mainnet-beta\" | \"devnet\"","required":false,"lookingFor":"Which Solana network to read. Default \"mainnet-beta\" (real money).","whereToGet":"Leave it out for mainnet. Use \"devnet\" only for test wallets."}],"outputs":[{"field":"sol","type":"string","is":"SOL balance.","howWorkedOut":"The balance tool."},{"field":"sol_usd","type":"number | null","is":"USD value of the SOL.","howWorkedOut":"sol x Jupiter's SOL price, rounded to cents."},{"field":"tokens_usd","type":"number","is":"USD value of the verified, priced tokens among the top 10.","howWorkedOut":"The tokens tool's total_usd for the top 10 (unverified tokens left out)."},{"field":"unverified_usd","type":"number","is":"Claimed USD value of unverified top tokens, kept out of the total because spam often carries a fake price.","howWorkedOut":"The tokens tool's unverified_usd for the top 10."},{"field":"total_usd","type":"number","is":"Estimated total worth: SOL plus verified, priced top tokens.","howWorkedOut":"sol_usd + tokens_usd. Unverified tokens, unpriced tokens and anything outside the top 10 aren't counted."},{"field":"partial","type":"boolean","is":"True when the total leaves something out (unpriced or unverified tokens, or more tokens than shown).","howWorkedOut":"A top token has no price or isn't verified, or the wallet holds more tokens than returned."},{"field":"token_count","type":"number","is":"How many token accounts with a balance the wallet has.","howWorkedOut":"The tokens tool's accounts_with_balance."},{"field":"unverified_count","type":"number","is":"Top tokens that aren't verified (maybe spam or scams). Don't present these as real value.","howWorkedOut":"The tokens tool's unverified_count for the top 10."},{"field":"top_tokens[]","type":"object[]","is":"Up to 10 tokens, highest USD value first, with address, symbol, amount, verified and value.","howWorkedOut":"The tokens tool with how_many 10. Fields explained there."},{"field":"activity.checked / failed","type":"number","is":"Recent transactions looked at, and how many failed.","howWorkedOut":"The history tool with how_many 10."},{"field":"activity.last_active","type":"string | null","is":"When the latest transaction happened (UTC).","howWorkedOut":"Time of the newest transaction."}],"notes":[],"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wallet":{"type":"string"},"network":{"default":"mainnet-beta","type":"string","enum":["mainnet-beta","devnet"]}},"required":["wallet"]}}