{"uid":"cap_6JCkz98dLB2hwpc0NnnbU","slug":"agentindex-x402-wallet-pay-check-c8cad081","name":"AgentIndex x402 Wallet Pay-Check","description":"Check whether a Base wallet holds enough USDC to pay an x402 amount (default $0.001). Returns balance, can_pay, shortfall. The checklist agents run before spending. Try GET /can-pay/sample.","url":"https://x402.agentindex.world/can-pay?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"amount":{"type":"number","description":"USDC amount the agent plans to spend (default 0.001)."},"address":{"type":"string","description":"EVM wallet address (0x…) to check on Base mainnet."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","usdc","can_pay"],"properties":{"eth":{"type":"object"},"usdc":{"type":"object"},"address":{"type":"string"},"can_pay":{"type":"boolean"},"network":{"type":"string"},"x402_receipt":{"type":"object"},"shortfall_usdc":{"type":"number"},"amount_requested":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"eth":{"balance":0},"usdc":{"balance":0,"contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","balance_atomic":"0"},"address":"0xb3F32bdfe8D07825BC0D7387295aB1D7559BA69d","can_pay":false,"network":"eip155:8453","shortfall_usdc":0.001,"amount_requested":0.001}},"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_BcF-PwtUB4xrTbzcUJ_GD","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":"Checks whether a given EVM wallet address has sufficient USDC balance on Base mainnet to pay for an API call","exampleAgentPrompt":"Before we make any paid API calls, check if my wallet 0xb3F32bdfe8D07825BC0D7387295aB1D7559BA69d has enough USDC on Base to cover a 0.001 USDC charge.","exampleUseCases":[{"title":"Pre-flight agent wallet funding check","prompt":"Check if my agent wallet 0xb3F32bdfe8D07825BC0D7387295aB1D7559BA69d has at least 0.001 USDC on Base before I start running paid search queries."},{"title":"Diagnose why API calls are failing","prompt":"My automated agent keeps getting rejected on pay-per-call requests — can you check if 0xABC123...def456 has enough USDC on Base, and tell me how much it's short by?"},{"title":"Monitor agent wallet before bulk task","prompt":"I'm about to run a batch of 50 paid tool calls at 0.001 USDC each — verify that wallet 0x1234567890abcdef1234567890abcdef12345678 has at least 0.05 USDC available on Base mainnet."}],"resultDescription":"Returns a JSON object with a can_pay boolean, the wallet's USDC balance (raw and atomic), ETH balance, the network identifier (eip155:8453 for Base mainnet), the amount requested, and a shortfall_usdc value indicating how much more USDC is needed if the wallet cannot pay.","failureModes":["Missing or invalid EVM address returns an error — address must be a valid 0x-prefixed hex string","If the wallet has zero USDC, can_pay is false with shortfall_usdc equal to the requested amount","Network unavailability or RPC errors may cause lookup failure","Malformed address format (non-checksummed or wrong length) may result in a 400 or error response"],"whenToPreferThis":"Use this endpoint when an AI agent needs to pre-flight check whether its wallet is funded before attempting a pay-per-call x402 API request on Base mainnet. It is the authoritative balance check for the AgentIndex x402 ecosystem and returns structured data including shortfall amounts, making it ideal for automated agents that need to handle insufficient funds gracefully before attempting a payment flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:31.716Z","isFirstParty":false,"canonicalSlug":"agentindex-x402-wallet-pay-check-c8cad081"}