{"uid":"cap_PqAfXFsddjtD5IAKThsR8","slug":"x402-base-tools-usdc-authorization-nonce-status-balance-27593877","name":"x402 Base Tools – USDC Authorization Nonce Status & Balance","description":"Whether a USDC transferWithAuthorization nonce of an authorizer has already been used on Base, which is how an x402 buyer tells a settled payment from one that never landed, plus the authorizer's USDC balance.","url":"https://base.kagurazaka.dev/v1/authorization?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":["authorizer","nonce"],"properties":{"nonce":{"type":"string","description":"the authorization nonce (0x + 64 hex digits)"},"authorizer":{"type":"string","description":"the paying wallet (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"used":{},"usdc_balance":{}}}}}}},"responseSchema":{"type":"json","example":{"used":false,"usdc_balance":"2.89"}},"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_1aUmHCzpSTuMuBQAYzVaf","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 USDC transferWithAuthorization nonce has been used on Base and returns the authorizer's current USDC balance, letting x402 payment flows confirm settlement.","exampleAgentPrompt":"Has the USDC authorization nonce 0xabc123...def456 already been used on Base for wallet 0x1234...5678, and what's their current USDC balance?","exampleUseCases":[{"title":"Confirm x402 payment settlement","prompt":"I need to know if the x402 payment from wallet 0xAbCd...1234 with nonce 0x000000...deadbeef has actually settled on Base — did the nonce get consumed?"},{"title":"Check buyer USDC balance before fulfilling order","prompt":"Before I ship the order, can you check if the buyer at 0x9876...fedc has enough USDC on Base and whether their payment nonce 0xfeed...cafe has already been used?"},{"title":"Audit double-spend attempt detection","prompt":"I'm seeing two payment attempts with the same nonce 0x1111...aaaa from authorizer 0x4444...bbbb — has that nonce already been spent on Base?"}],"resultDescription":"A JSON object with a boolean `used` field indicating whether the nonce has been consumed on-chain, and a `usdc_balance` string showing the authorizer's current USDC balance (e.g. {\"used\": false, \"usdc_balance\": \"2.89\"}).","failureModes":["Invalid or malformed nonce format (not 0x + 64 hex digits) returns an error","Invalid or non-checksummed authorizer address returns an error","Missing required query parameters returns a 400-level error","Network or RPC issues reading Base chain state may cause transient failures","Nonce or balance data may lag slightly behind the latest block"],"whenToPreferThis":"Use this endpoint when building or verifying x402 payment flows on Base and you need to determine in one call whether a specific USDC transferWithAuthorization nonce has been consumed and check the payer's current USDC balance. Prefer it over general blockchain explorers when you need fast, structured JSON output for programmatic settlement confirmation without parsing raw transaction logs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:54.379Z","isFirstParty":false,"canonicalSlug":"x402-base-tools-usdc-authorization-nonce-status-balance-27593877"}