{"uid":"cap_qFHjIJ8DvP4YWjjbvMksd","slug":"evm-wallet-balance-x402-payment-readiness-checker-97f1498b","name":"EVM Wallet Balance & x402 Payment Readiness Checker","description":"Read a public EVM wallet balance on Base or Ethereum and determine whether its Base USDC balance can cover a suggested $0.001 x402 payment. Returns a coherent provider snapshot, USDC runway, shortfall, native-gas presence, and a handoff to the full funding-readiness doctor without signing, broadcasting, or handling private keys. Balance-only readiness does not prove client, signing, spend-cap, or retry capability. GET variant for agents, crawlers, and wallets that prefer query parameters over...","url":"https://gpt55.558686.xyz/v1/tools/evm-wallet-balance","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","additionalProperties":true},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","mainnet","eip155:8453","eip155:1","8453","1"],"type":"string"},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"network":{"enum":["base","ethereum","mainnet","eip155:8453","eip155:1","8453","1"],"type":"string","default":"base"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"evmWalletBalance","address":"0x1111111111111111111111111111111111111111","chainId":"eip155:8453","network":"base","observedAt":"2026-08-10T00:00:00.000Z","blockNumber":"1234567","usdcBalance":{"raw":"1234567","symbol":"USDC","decimals":6,"formatted":"1.234567","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"nativeBalance":{"raw":"1000000000000000000","symbol":"ETH","decimals":18,"formatted":"1"},"x402Readiness":{"shortfall":{"atomic":"0","formatted":"0"},"assessment":"balance_ready","balanceOnly":true,"limitations":["Balance signals do not prove payment-client, typed-data signing, spend-cap, or same-request retry readiness."],"nativeGasPresent":true,"suggestedPayment":{"asset":"USDC","network":"eip155:8453","amountUsd":"0.001","amountAtomic":"1000"},"walletNetworkMatches":true,"fundingReadinessDoctor":{"paidUrl":"https://gpt55.558686.xyz/v1/tools/x402-wallet-funding-readiness-doctor","guideUrl":"https://gpt55.558686.xyz/x402/wallet-funding-readiness-doctor"},"canCoverSuggestedX402Amount":true,"usdcRunwayAtSuggestedAmount":"1234"},"rpcProviderHost":"rpc.example.test"}},"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_1HnDMc6ZTodfIWcfIipOE","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":"Reads a public EVM wallet's USDC and native gas balance on Base or Ethereum and determines whether it can cover a $0.001 x402 payment, returning a funding-readiness snapshot with runway and shortfall details.","exampleAgentPrompt":"Check whether the wallet 0xAbC1234567890abcdef1234567890abcdef123456 on Base has enough USDC to cover a $0.001 x402 payment — I want to see the balance, any shortfall, and whether gas is present.","exampleUseCases":[{"title":"Pre-flight check before paid API call","prompt":"Before my agent makes an x402 API call, check if wallet 0xAbC1234567890abcdef1234567890abcdef123456 on Base has enough USDC to cover the $0.001 fee and tell me if there's any shortfall."},{"title":"Agent wallet funding audit","prompt":"Can you look up the USDC and gas balance on Base for wallet 0xDEF9876543210fedcba9876543210fedcba987654 and tell me how many $0.001 x402 payments it could still make before running dry?"},{"title":"Cross-chain wallet readiness comparison","prompt":"Check if my Ethereum mainnet wallet 0x1234567890abcdef1234567890abcdef12345678 has enough USDC for a $0.001 x402 payment and show me the full funding snapshot including gas status."}],"resultDescription":"Returns a provider snapshot including the wallet's Base USDC balance, native gas presence, USDC runway (how many $0.001 payments can be made), shortfall if the balance is insufficient, overall payment readiness verdict, and a pointer to a full funding-readiness diagnostic. Does not sign transactions, broadcast anything, or touch private keys.","failureModes":["Invalid or malformed wallet address returns a validation error","Unsupported chain/network value returns an enum error","RPC or provider timeout may return an upstream error with no balance data","Wallet with zero USDC returns a shortfall equal to the full payment amount","Network congestion may cause stale or delayed balance reads"],"whenToPreferThis":"Use this endpoint when an agent or workflow needs to verify that a specific EVM wallet is funded with enough Base USDC to cover a $0.001 x402 micropayment before attempting the payment — especially in pre-flight checks, funding audits, or automated agent pipelines where signing and broadcasting are handled elsewhere. Prefer this over a general blockchain explorer when you specifically need x402 payment readiness framing with runway and shortfall calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:58.308Z","isFirstParty":false}