{"uid":"cap_DLETxReNDSK81UgArNarz","slug":"base-wallet-balance-lookup-x402-6699d643","name":"Base Wallet Balance Lookup (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/crypto/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":["wallet"],"properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0xe4be4d0bd82d8e68203deff81f79ede0529f2617"],"description":"Wallet"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"block":53204016,"chain":"base","nonce":0,"wallet":"0xe4be4d0bd82d8e68203deff81f79ede0529f2617","balance_eth":0,"balance_wei":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ayheontpX2BlTh4RvKiCs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native ETH balance (in both ETH and wei) plus nonce and block number for a given Base wallet address, paid via USDC microtransaction over x402.","exampleAgentPrompt":"What's the current ETH balance on Base for wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 — show me the amount in ETH and the current nonce.","exampleUseCases":[{"title":"Pre-payment counterparty check","prompt":"Before I send funds, check whether wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 has any ETH balance on Base and what its nonce is — I want to know if it's an active wallet."},{"title":"Agent self-check for gas","prompt":"Check my own Base wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 to see if I have enough ETH to cover gas fees before I submit the next transaction."},{"title":"Monitor funded wallet status","prompt":"Look up the ETH balance and current block for wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 on Base so I can confirm the deposit arrived."}],"resultDescription":"A JSON object containing: the current Base block number, chain identifier ('base'), the wallet's nonce (transaction count), the queried wallet address, ETH balance as a decimal float, and wei balance as a string. Useful for confirming wallet activity, gas availability, and deposit receipt.","failureModes":["Invalid wallet address format (must be 0x followed by 40 hex chars) returns a 400 or validation error","Wallet address does not exist on Base — returns balance of 0 and nonce 0 (not an error, but may mislead)","x402 payment failure if agent lacks sufficient USDC on Base returns a 402 Payment Required","Base RPC node downtime could cause a 500 or timeout","Missing required wallet query parameter returns a schema validation error"],"whenToPreferThis":"Choose this endpoint when your AI agent needs a lightweight, no-API-key way to check a Base wallet's native ETH balance, nonce, or current block height, and can pay $0.002 USDC per call via x402. Ideal for pre-flight gas checks, counterparty verification, and deposit confirmation in onchain agent pipelines. Prefer over free alternatives when you need guaranteed access without API key management and already have x402 payment infrastructure in place.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:07.913Z","isFirstParty":false,"canonicalSlug":"base-wallet-balance-lookup-x402-6699d643"}