{"uid":"cap_FdRwl1HOMcLJvP2VYEVsy","slug":"santyvv-data-native-balance-65078e62","name":"santyvv-data Native Balance","description":"Native balance of an address","url":"https://santyvv-x402.santyvv1993.workers.dev/api/chain/balance?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","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3xEF-TEo4x4AQBO67Fiet","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native cryptocurrency balance (e.g. ETH, MATIC) of a given blockchain address","exampleAgentPrompt":"What's the current native ETH balance of wallet address 0x742d35Cc6634C0532925a3b8D4C9C0B1c2e3f4a5?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check the native ETH balance for my wallet 0xAbCd1234567890abcdef1234567890abcdef1234 so I know how much gas money I have left?"},{"title":"Monitor whale wallet holdings","prompt":"Look up the native token balance on this address 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe — I want to see how much ETH this known whale wallet is holding."},{"title":"Verify funded address before transaction","prompt":"Before I send funds, can you check if address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 has any native ETH balance on chain?"}],"resultDescription":"Returns the native cryptocurrency balance (in wei or the chain's base unit) for the queried address, reflecting its current on-chain state.","failureModes":["Invalid or malformed address returns an error response","Unsupported chain identifier results in a 400 or 404 error","Network congestion or node unavailability may cause timeouts","Payment failure ($0.01 USDC) will block access to the endpoint","Empty or zero balance returned for unfunded addresses — not an error, but may be misinterpreted"],"whenToPreferThis":"Use this endpoint when you need a quick, pay-per-call lookup of a native token balance (ETH, MATIC, etc.) for any given address without running your own node or indexer. It is ideal for lightweight agents that occasionally need balance checks without managing blockchain infrastructure. Prefer this over ERC-20 balance endpoints when you want the chain's native currency, not a token contract balance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:24:19.179Z","isFirstParty":false,"canonicalSlug":"santyvv-data-native-balance-65078e62"}