{"uid":"cap_B_XkxK0890F6PkBDpFviK","slug":"aether-base-portfolio-lookup-e55d6d3c","name":"Aether Base Portfolio Lookup","description":"Pay-per-call Base onchain data, token risk verdicts and x402 payability audits over x402 (USDC on Base).","url":"https://aether-x402.vercel.app/v1/base/portfolio?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":20},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":{"type":"json","example":{"holdings":[{"usd":750.1,"symbol":"ETH","balance":"0.3"}],"totalUsd":1234.56}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_keqKSl3WlITN5C4pc3fIA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the token holdings and USD portfolio value for a Base network wallet address, optionally filtered to specific token contracts.","exampleAgentPrompt":"Can you pull up the full token portfolio for the Base wallet 0xAbc123...def456 and show me all the holdings with their USD values?","exampleUseCases":[{"title":"DeFi portfolio net worth check","prompt":"What is the total USD value of my Base wallet 0x1234567890abcdef1234567890abcdef12345678 right now, and list each token I'm holding?"},{"title":"Specific token balance audit","prompt":"For wallet 0xabcdef1234567890abcdef1234567890abcdef12, check how much I'm holding in these two tokens on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and 0x4200000000000000000000000000000000000006"},{"title":"Agent treasury monitoring","prompt":"Give me a snapshot of the token holdings and USD value for our DAO treasury at 0xDeadBeef0000000000000000000000000000dEaD on Base so I can report on our current onchain balance."}],"resultDescription":"Returns a JSON object with a 'holdings' array where each item contains the token symbol, raw balance, and USD value, plus a 'totalUsd' field with the aggregate portfolio value across all held tokens.","failureModes":["Invalid or malformed wallet address returns a validation error","Address with no Base activity returns empty holdings array","Token contract addresses not on Base return empty or null entries","Rate limiting or payment failure (x402) if USDC payment not attached","Up to 20 token addresses per call; exceeding maxItems causes a 400 error","Unverified or very new tokens may have missing price data and return null USD values"],"whenToPreferThis":"Use this endpoint when you need onchain portfolio data specifically for Base network wallets, paid micro-per-call via x402/USDC — ideal for AI agents that need to audit wallet value without managing a full RPC node or subscribing to a bulk data provider. Best when you want a simple holdings snapshot rather than deep historical or cross-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:43:58.046Z","isFirstParty":false,"canonicalSlug":"aether-base-portfolio-lookup-e55d6d3c"}