{"uid":"cap_iq2VQzhJ0lxd1vMYSdvU4","slug":"sleuth-ai-wallet-holdings-api-2691f417","name":"Sleuth AI Wallet Holdings API","description":"Pay-per-call on-chain investigation API (x402, USDC on Base).","url":"https://x402.sleuthagent.ai/api/v1/wallet-holdings","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["auto","base","ethereum","arbitrum","polygon","bsc","robinhood","solana","bnb","robinhoodchain"],"type":"string","default":"auto"},"wallet":{"type":"string","maxLength":200,"minLength":1},"conversation_id":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"nodes":[{"id":"base_sleuth:obs0","rows":[["0x1111111111111111111111111111111111111111","12,400,000","41.2%"],["0x2222222222222222222222222222222222222222","6,900,000","22.9%"]],"tool":"data_miner","title":"Holdings","columns":["token","amount","usd_value"],"summary":"Largest current holders by balance.","row_count":2,"truncated":false}]},"response":"The wallet holds 1,200 ETH, 3.4M USDC, and 40 other tokens…","request_id":"req_9f8e7d6c5b4a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.099","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.099/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.099","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.099","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F_2vVHsBib0DwF611EzCp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.099","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current token holdings (balances, USD values, and percentage shares) for a given blockchain wallet address using on-chain data.","exampleAgentPrompt":"Can you pull up the current token holdings for wallet 0xAbCd...1234 on Base and show me what tokens it holds, their balances, and USD values?","exampleUseCases":[{"title":"Whale wallet portfolio analysis","prompt":"Look up the current holdings for wallet 0x3f5CE5FEFe2c1cBF4E9BFBA5A5b3d9F1234abcd and tell me which tokens it holds, how much of each, and their USD values — I want to know if this is a whale."},{"title":"DeFi due diligence on counterparty","prompt":"Before I do a deal with this address — 0xDead...Beef — can you check what tokens they actually hold on-chain so I can see if they're legit?"},{"title":"Portfolio tracking for personal wallet","prompt":"What's currently sitting in my wallet 0x1A2B3C4D5E6F7890abcdef1234567890abcdef12? Give me a full breakdown of every token and its current USD value."}],"resultDescription":"Returns a structured JSON response containing a list of token holdings for the queried wallet, including token identifiers, raw balances, USD values, and percentage share of the total portfolio. Also includes a natural language summary of the wallet's holdings and a unique request ID for tracing.","failureModes":["Invalid or malformed wallet address returns an error","Wallet address with no on-chain activity may return empty holdings","Network timeouts or on-chain data unavailability may cause failures","Insufficient USDC balance for x402 payment will block the call","Unsupported blockchain network may return no data"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, structured breakdown of all tokens held by a specific on-chain wallet address, including USD-denominated values and portfolio percentage shares. Prefer this over generic block explorers when you need machine-readable, agent-consumable output with natural language summaries for downstream reasoning. Best suited for on-chain investigation, portfolio analysis, counterparty due diligence, or whale-watching tasks on Base or compatible EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:33:09.452Z","isFirstParty":false}