{"uid":"cap_oTYfO23RZF1RKmSxk8Zj4","slug":"vibes-coded-spend-guard-2304f9c7","name":"Vibes-Coded Spend Guard","description":"Pay-per-call JSON for AI agents: skill search, listing optimization, install plans, productization, and artifact risk scoring. HTTP 402 → USDC. Full skill marketplace on-site.","url":"https://vibes-coded.com/api/v1/outcomes/spend-guard","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"ok":true,"reason":"would_exceed_cap","allowed":false,"cap_usd":1,"spent_usd":0.92,"next_call_usd":0.15}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0xcoZLkmwesXvY26df01m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether an agent's next API call would exceed a configured USDC spending cap before executing it","exampleAgentPrompt":"Before making that next tool call, check my spend guard — my cap is $1.00, I've spent $0.92 so far, and the next call costs $0.15 — tell me if I'm allowed to proceed.","exampleUseCases":[{"title":"Pre-flight budget check for agent loop","prompt":"My autonomous agent is about to call another paid skill costing $0.10 — my total cap is $5.00 and I've spent $4.95 so far. Run a spend guard check and tell me whether the call should be allowed."},{"title":"Enforcing per-session USDC cap","prompt":"I want to make sure my agent session doesn't go over $2 total in USDC. I've already spent $1.80 and the next planned call costs $0.25 — can you check if that's still within my cap?"},{"title":"Safety gate in multi-step agentic workflow","prompt":"Before proceeding to the next step in this automated workflow, verify my spend guard: cap is $0.50, spent so far is $0.48, next call is $0.02 — should the agent be allowed to continue?"}],"resultDescription":"Returns a JSON object with an 'allowed' boolean indicating whether the next call should proceed, a 'reason' code explaining the decision (e.g. 'would_exceed_cap'), the configured cap in USD, the amount already spent in USD, and the cost of the prospective next call in USD.","failureModes":["Missing or invalid cap_usd / spent_usd / next_call_usd fields return an error","Non-numeric spend values cause validation failure","Payment via x402 required (HTTP 402) if the $0.02 call fee itself is unpaid","Negative spend amounts may be rejected","Extremely large cap values may be clamped or rejected"],"whenToPreferThis":"Use this endpoint when you need a lightweight, pay-per-call pre-flight guard that prevents an AI agent from autonomously exceeding a USDC budget ceiling. Prefer it over manual arithmetic or client-side checks when you want a neutral third-party enforcement point in an agentic loop, especially when working within the x402 micropayment ecosystem on Vibes-Coded's skill marketplace.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:52.647Z","isFirstParty":false}