Wallets/wallet

What's in this wallet

$0.01per call after 25 free a day

SOL balance, top tokens with USD values, estimated total, and recent activity in one answer.

Run when asked what a wallet holds or is worth. One call instead of balance + tokens + history; spam is left out of the total.

Keeps the model from guessing. Keeps priced and unpriced, verified and unverified holdings apart, so spam airdrops don't inflate what a wallet is worth.

Call it

Transport	How
HTTP	`POST /api/tools/wallet` with a JSON body of the inputs below.
MCP	`tools/call` with name `wallet` on `/mcp`.

Inputs

Name	What it's looking for	Where to get it
`wallet` string (base58 address), required	The wallet to sum up.	The user's wallet address.
`network` "mainnet-beta" \| "devnet", optional	Default "mainnet-beta" (real money).	"devnet" only for test wallets.

Returned fields

Every field the tool returns, what it is, and exactly how it's worked out.

Field	What it is	How it's worked out
`sol` string	SOL balance.	The balance tool.
`sol_usd` number \| null	USD value of the SOL.	sol x Jupiter's SOL price, rounded to cents.
`tokens_usd` number	USD value of the verified, priced tokens among the top 10.	The tokens tool's total_usd for the top 10 (unverified tokens left out).
`unverified_usd` number	Claimed USD value of unverified top tokens, kept out of the total because spam often carries a fake price.	The tokens tool's unverified_usd for the top 10.
`total_usd` number	Estimated total worth: SOL plus verified, priced top tokens.	sol_usd + tokens_usd. Unverified tokens, unpriced tokens and anything outside the top 10 aren't counted.
`partial` boolean	True when the total leaves something out (unpriced or unverified tokens, or more tokens than shown).	A top token has no price or isn't verified, or the wallet holds more tokens than returned.
`token_count` number	How many token accounts with a balance the wallet has.	The tokens tool's accounts_with_balance.
`unverified_count` number	Top tokens that aren't verified (maybe spam or scams). Don't present these as real value.	The tokens tool's unverified_count for the top 10.
`top_tokens[]` object[]	Up to 10 tokens, highest USD value first, with address, symbol, amount, verified and value.	The tokens tool with how_many 10. Fields explained there.
`activity.checked / failed` number	Recent transactions looked at, and how many failed.	The history tool with how_many 10.
`activity.last_active` string \| null	When the latest transaction happened (UTC).	Time of the newest transaction.