{"uid":"cap_Beqgth1W0Yz6kpzjS38gW","slug":"chain-live-balance-lookup-0befc5ec","name":"Chain Live Balance Lookup","description":"Machine-payable x402 utilities for hashing, Base64, UUID generation, unit and timezone conversion, realtime crypto market data, webpage/document extraction, URL-to-Markdown, metadata, RAG ingestion and deterministic website change detection.","url":"https://x402-gateway-production-1f21.up.railway.app/chain/live-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["address"],"properties":{"tokens":{"type":"array","items":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"maxItems":20},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"network":{"enum":["base","ethereum"],"type":"string","default":"base"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"status":"ready"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_pKEOPyL5Pl1I3Bm-yRN9h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the live on-chain token balances for a given Ethereum-compatible wallet address on Base or Ethereum networks.","exampleAgentPrompt":"What are the live token balances for wallet address 0xAbC1234567890123456789012345678901234567 on Base, including holdings for token contracts 0xDef...1 and 0xGhi...2?","exampleUseCases":[{"title":"DeFi portfolio balance snapshot","prompt":"Can you pull the live on-chain balances for wallet 0xAbC1234567890123456789012345678901234567 on the Base network, including these three token contracts: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, 0x6B175474E89094C44Da98b954EedeAC495271d0F, and 0x4200000000000000000000000000000000000006?"},{"title":"Ethereum wallet holdings check","prompt":"Look up the current token balances for address 0x1234567890abcdef1234567890abcdef12345678 on Ethereum mainnet — I want to see what ERC-20 tokens it holds."},{"title":"Agent treasury monitoring","prompt":"Fetch the realtime on-chain balance for our agent's treasury wallet 0xDeAdBeEf0000000000000000000000000000dEaD on Base so I can confirm the funds are still there."}],"resultDescription":"Returns a JSON object with live on-chain balance data for the specified wallet address, including balances for each requested token contract address on the specified network (Base or Ethereum). The response confirms readiness with a status field and includes the wallet's current holdings.","failureModes":["Invalid Ethereum address format (not matching 0x + 40 hex chars) returns a validation error","Unsupported network value returns an enum mismatch error","More than 20 token addresses in the tokens array exceeds the maxItems limit and is rejected","RPC node unavailability or blockchain congestion may cause timeouts","Wallet with no holdings returns empty or zero balances rather than an error","Payment failure via x402 protocol prevents request from processing"],"whenToPreferThis":"Use this endpoint when you need real-time, live on-chain token balance data for a specific wallet address on Base or Ethereum. It is ideal for DeFi portfolio monitoring, agent treasury checks, and multi-token balance lookups in a single call. Prefer this over centralized exchange APIs when you need trustless, chain-verified balance data. The x402 micropayment model makes it cost-effective for per-query agent workflows without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:42:38.739Z","isFirstParty":false,"canonicalSlug":"chain-live-balance-lookup-0befc5ec"}