{"uid":"cap_hFZjeVjTIeqsiC2-ZvN_k","slug":"beggar-bot-wallet-portfolio-enrichment-b4ac43be","name":"Beggar Bot Wallet Portfolio Enrichment","description":"Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/portfolio?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base (default) or ethereum (needs tokens)"},"tokens":{"type":"string","description":"optional extra token addresses (≤20)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ji5mg77gISURjWAZLHz0Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native ETH balance plus USD-priced holdings across 24 curated Base tokens (stables, LSTs, cbBTC, AERO, VIRTUAL, memes) and optional custom tokens for any wallet address, with account type classification.","exampleAgentPrompt":"What's the full portfolio breakdown for wallet 0xAbc1234567890abcdef1234567890abcdef123456 on Base — show me all token balances and their USD values, plus the total?","exampleUseCases":[{"title":"DeFi wallet snapshot for Base user","prompt":"Can you pull up the complete portfolio for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — I want to see every token balance, what each is worth in USD, and the grand total?"},{"title":"Custom token portfolio check","prompt":"Check the wallet 0x1234567890abcdef1234567890abcdef12345678 on Base and also include these extra tokens: 0xabc123... and 0xdef456... — what are the balances and USD values?"},{"title":"Ethereum wallet holdings overview","prompt":"Look up the token portfolio for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, including ETH balance and any top token holdings, with USD pricing."}],"resultDescription":"A JSON object containing: native ETH balance, a list of token holdings (each with token name/address, raw balance, and USD value), a total portfolio USD value, and an account type classification (EOA, contract, smart-EOA, etc.). Pricing is sourced on-chain via Uniswap v3 or Aerodrome. The endpoint fails soft — tokens that can't be priced are omitted rather than causing an error.","failureModes":["Invalid wallet address format (must be 0x + 40 hex chars) returns an error","Token address not found or illiquid on Uniswap v3/Aerodrome results in that token being silently skipped (soft fail)","More than 20 custom tokens passed via tokens= parameter may be rejected or truncated","Unsupported chain value returns an error","Temporary RPC unavailability may result in partial or empty results"],"whenToPreferThis":"Use this endpoint when you need a fast, on-chain priced snapshot of a wallet's portfolio on Base (or Ethereum) without needing to manage your own RPC keys. It is ideal for agents that need to assess DeFi wallet value, check exposure to specific Base ecosystem tokens (stables, LSTs, cbBTC, AERO, VIRTUAL, memes), or enrich wallet data with USD valuations. Prefer this over generic block explorer APIs when you need live USD pricing sourced directly from Uniswap v3/Aerodrome rather than off-chain price feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:29.304Z","isFirstParty":false,"canonicalSlug":"beggar-bot-wallet-portfolio-enrichment-b4ac43be"}