{"uid":"cap_Ae0Zn6IgdjPAS3wcw2_np","slug":"nightshift-labs-base-balance-lookup-5c37da83","name":"Nightshift Labs Base Balance Lookup","description":"Base wallet balances: native ETH and USDC for any address, with the block number they were read at.","url":"https://nightshift-x402.nightshift-labs.workers.dev/v1/base/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","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"eth":"283543.09","usdc":"179.137106","block":53585397,"chain":"base","address":"0x4200…0006"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BlEZuZtUjE3-0HuF8OuEs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ETH and USDC balances for a given Base network wallet address at the current block","exampleAgentPrompt":"What's the current ETH and USDC balance of the wallet 0x4200000000000000000000000000000000000006 on Base?","exampleUseCases":[{"title":"Pre-transaction balance check","prompt":"Before I send that USDC payment, can you check how much ETH and USDC is currently sitting in my Base wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234?"},{"title":"DeFi portfolio snapshot","prompt":"Pull up the current ETH and USDC balances for the Base address 0x1111222233334444555566667777888899990000 — I want to know what's available on-chain right now."},{"title":"Agent treasury monitoring","prompt":"Check the balance of our agent treasury wallet 0xDeAdBeEf00000000000000000000000000000001 on Base and tell me how much ETH and USDC it holds at the latest block."}],"resultDescription":"Returns a JSON object containing the ETH balance (as a decimal string), USDC balance (as a decimal string), the current block number, the chain name ('base'), and the queried wallet address. Example: {eth: '283543.09', usdc: '179.137106', block: 53585397, chain: 'base', address: '0x4200…0006'}.","failureModes":["Invalid or malformed address (not matching 0x + 40 hex chars) returns a validation error","Address not found on Base returns zero balances","Network or RPC node outage may cause timeout or 5xx error","Payment failure (insufficient USDC for x402 fee) blocks the call","Rate limiting if too many calls are made in rapid succession"],"whenToPreferThis":"Use this endpoint when you need a quick, pay-per-call lookup of both ETH and USDC balances for any address on the Base L2 network without setting up your own RPC node or indexer. It is ideal for AI agents that need lightweight, on-demand balance checks with no subscription overhead, paying only $0.005 USDC per call via the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:40:28.234Z","isFirstParty":false,"canonicalSlug":"nightshift-labs-base-balance-lookup-5c37da83"}