{"uid":"cap__zCJuCK5t9ynXOfqj-hB_","slug":"agent-data-bench-wallet-token-holdings-378eadf0","name":"Agent Data Bench – Wallet Token Holdings","description":"Every token a wallet holds on Solana, Base or Ethereum, with balance, symbol, decimals, bought/sold volume and last update. No USD valuation is claimed: spam tokens carry fabricated prices upstream, so price a holding with the market routes. Sorted by balance and capped by limit.","url":"https://x402.deepsense.stream/api/v1/wallet/holdings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain","wallet"],"properties":{"chain":{"enum":["sol","eth","base"],"type":"string","description":"Chain id: sol (Solana), eth (Ethereum), base (Base)"},"limit":{"type":"integer","default":50,"maximum":100,"minimum":1},"wallet":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HMAZjhWk85Qlphsvi4aXb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all tokens held in a wallet on Solana, Base, or Ethereum with balance, symbol, decimals, and traded volume — without USD price estimates.","exampleAgentPrompt":"Can you pull up all the token holdings for Solana wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU and show me the top 50 by balance?","exampleUseCases":[{"title":"Portfolio audit for a Solana wallet","prompt":"List all the tokens held in Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM — I want to see balances, symbols, and how much has been bought and sold for each."},{"title":"Ethereum wallet due-diligence check","prompt":"Can you fetch the full token holdings for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 and list up to 100 tokens sorted by balance? I want to see decimals and trade volumes too."},{"title":"Base chain asset inventory","prompt":"What tokens does Base wallet 0x4200000000000000000000000000000000000006 currently hold? Show me all of them on Base chain with their balances and last update times."}],"resultDescription":"A list of token records for the wallet, sorted by balance descending and capped at the requested limit (default 50, max 100). Each record includes the token symbol, raw balance, decimal precision, total bought volume, total sold volume, and last update timestamp. No USD prices are included — use a market/DEX route for valuation.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported chain value (not sol/eth/base) returns a validation error","Wallet with no on-chain history returns an empty holdings list","Limit outside 1–100 range is rejected","Payment failure or expired x402 token results in a 402 or 401 error","Upstream indexer lag may cause stale or incomplete holdings for recently active wallets"],"whenToPreferThis":"Use this endpoint when you need a raw, comprehensive token inventory for a wallet across Solana, Ethereum, or Base — especially when you want volume and balance data without relying on potentially fabricated price feeds from spam tokens. Prefer it over wallet-overview endpoints when you need per-token detail (decimals, trade volumes) rather than just a summary. Pair it with a DEX pricing route if USD valuations are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:39:40.104Z","isFirstParty":false,"canonicalSlug":"agent-data-bench-wallet-token-holdings-378eadf0"}