{"uid":"cap_OzjyD-n4rViKSrhk0Nrpr","slug":"x402-agent-spend-recurrence-guard-bd3f1066","name":"x402 Agent Spend Recurrence Guard","description":"A buyer-side control console for signature risk, EIP-712 review, transaction decoding, ERC20 allowance risk, Permit/Permit2 approvals, transaction simulation summaries, spend guard policy, receipt gate enforcement, and private-key boundaries.","url":"https://x402-wallet.558686.xyz/v1/tools/x402-agent-spend-recurrence-guard","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"ok":true,"tool":"x402-agent-spend-recurrence-guard","input":{"routePriceUsd":0.012,"dailyBudgetUsd":0.05,"requestedCalls":3,"cooldownSeconds":30},"route":"/v1/tools/x402-agent-spend-recurrence-guard","result":{"decision":"decision_example","stopConditions":"stopConditions_example","recurrencePolicy":"recurrencePolicy_example","maxPaidCallsPerDay":true},"project":"x402-agent-wallet-tools","deterministic":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KqmNhcyzBacnKQ4taBl5r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates whether a recurring paid API call pattern stays within daily budget limits and cooldown constraints, returning a spend decision and recurrence policy for AI agent wallet management.","exampleAgentPrompt":"Before you retry that $0.012 API call, check the spend recurrence guard with a daily budget of $0.05, 3 requested calls, and a 30-second cooldown — make sure we're allowed to proceed.","exampleUseCases":[{"title":"Daily budget cap enforcement for agent loops","prompt":"My agent is looping a paid route that costs $0.012 per call — check the recurrence guard with a $0.05 daily budget, 5 requested calls, and a 60-second cooldown to see if it should stop."},{"title":"Cooldown policy check before retry","prompt":"Before my agent retries that failed API call, run a spend recurrence check: the route costs $0.012, my daily budget is $0.10, I only need 1 more call, and the cooldown is 30 seconds."},{"title":"Max paid calls per day calculation","prompt":"How many times can my AI agent call a route priced at $0.012 within a $0.05 daily budget? Use the recurrence guard with 10 requested calls and a 15-second cooldown to get the policy."}],"resultDescription":"Returns a JSON object with a 'decision' (whether to allow or block the calls), 'stopConditions' describing when the agent must halt, a 'recurrencePolicy' detailing frequency and limits, and 'maxPaidCallsPerDay' indicating the ceiling on paid calls within the daily budget. The response is deterministic given the same inputs.","failureModes":["Missing or invalid routePriceUsd causes schema validation error","dailyBudgetUsd of 0 or negative may return an immediate block decision","requestedCalls exceeding logical limits may return maxPaidCallsPerDay as false","cooldownSeconds of 0 may produce undefined recurrence policy behavior","Payment failure (402) if the $0.012 USDC call itself cannot be settled"],"whenToPreferThis":"Use this endpoint when your AI agent needs to enforce deterministic spend caps and cooldown policies before making recurring paid API calls, especially in loop or retry scenarios where runaway spending is a risk. Prefer this over manual budget checks when you need a structured recurrencePolicy and stop conditions returned in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:26.692Z","isFirstParty":false}