{"uid":"cap_NUSP_UglTMGSPZ_ajXukV","slug":"cdp-wallet-balance-lookup-feaee9b4","name":"CDP Wallet Balance Lookup","description":"List a wallet's native ETH and USDC balances with human-readable amounts. Canonical wallet-balance contract for autonomous agents: address plus optional CAIP-2 chain.","url":"https://x402-gateway-production-1f21.up.railway.app/wallet-balance/cdp?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":["address"],"properties":{"chain":{"enum":["eip155:8453","eip155:1"],"type":"string","default":"eip155:8453","description":"CAIP-2 chain id."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The wallet address."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","balances"],"properties":{"address":{"type":"string"},"balances":{"type":"array","items":{"type":"object","required":["symbol","amount"],"properties":{"amount":{"type":"number"},"symbol":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"address":"0x0000000000000000000000000000000000000000","balances":[{"amount":0,"symbol":"ETH"},{"amount":0,"symbol":"USDC"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GoNGahahGF9ldPMZwEndb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ETH and USDC token balances for a given wallet address on Base (eip155:8453) or Ethereum mainnet (eip155:1).","exampleAgentPrompt":"What are the ETH and USDC balances for wallet address 0xAbCd1234...5678 on the Base network?","exampleUseCases":[{"title":"Pre-transaction funding check","prompt":"Before I send that USDC payment, can you check whether wallet 0x1234567890abcdef1234567890abcdef12345678 on Base actually has enough USDC to cover it?"},{"title":"Portfolio balance snapshot","prompt":"Give me the current ETH and USDC balances for my wallet 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef on Ethereum mainnet."},{"title":"Automated agent treasury monitoring","prompt":"Check the token balances on Base for our agent treasury wallet at 0xaabbccddeeff00112233445566778899aabbccdd so I know if we need to top it up."}],"resultDescription":"A JSON object containing the queried wallet address and an array of token balances, each with a symbol (e.g. 'ETH', 'USDC') and a numeric amount representing the current on-chain balance.","failureModes":["Invalid or malformed address (not matching ^0x[a-fA-F0-9]{40}$) returns an error","Unsupported chain ID (anything other than eip155:8453 or eip155:1) returns an error","Payment failure (insufficient USDC or x402 protocol error) blocks the request","Network or RPC node downtime may cause timeout or empty response","Newly funded wallets may have a short propagation delay before balance reflects"],"whenToPreferThis":"Use this endpoint when you need a quick, machine-payable lookup of ETH and USDC balances for any EVM-compatible wallet on Base or Ethereum mainnet, especially in agent workflows where micropayment-based access (x402) is already in use and you want a lightweight alternative to running your own RPC node or integrating a full blockchain SDK.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:34:53.182Z","isFirstParty":false,"canonicalSlug":"cdp-wallet-balance-lookup-feaee9b4"}