{"uid":"cap_KnMMnemHzks_-BetJ8XgJ","slug":"no-hands-ai-budget-check-ca2692d1","name":"NO HANDS AI Budget Check","description":"Compare caller-supplied requested spend with supplied budget and transaction limits. Advisory policy calculation only; it does not reserve funds, enforce a wallet limit or authorize payment.","url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/x402/v1/policy/budget-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"purpose":{"type":"string","example":"api_purchase","pattern":"^[A-Za-z0-9._:-]{2,120}$","description":"Purpose code for the requested spend."},"agent_id":{"type":"string","example":"agent-123","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Caller-defined agent or principal id."},"currency":{"enum":["USDC","USDT","USD"],"type":"string","example":"USDC","description":"Policy currency."},"idempotency_key":{"type":"string","maxLength":128,"description":"Optional idempotency key for deterministic decision replay."},"remaining_budget":{"type":"string","example":"100","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Remaining budget available to this agent."},"requested_amount":{"type":"string","example":"250","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Requested spend amount."},"per_transaction_limit":{"type":"string","example":"150","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum amount allowed in one transaction."},"auto_approval_threshold":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional amount above which REVIEW is required even when budget fits."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.020005","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.020005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.020005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.020005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7IJTAxH97CozJ9WUmowjZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.020005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a requested spend amount against a supplied remaining budget and per-transaction limit, returning an advisory policy decision (ALLOW/REVIEW/BLOCK) without reserving or authorizing funds.","exampleAgentPrompt":"Before making this $25 USDC purchase, check whether it fits within my remaining budget of $80 USDC with a per-transaction limit of $50 USDC for agent 'agent-123' doing an 'api_purchase' — and flag it for review if it goes above $40.","exampleUseCases":[{"title":"Pre-purchase spend gate for autonomous agent","prompt":"My agent 'agent-456' wants to spend $30 USDC on a data API call. I have $75 USDC remaining budget and a $50 USDC per-transaction cap. Run a budget check so I know if it should proceed or needs review."},{"title":"Auto-approval threshold enforcement","prompt":"Check if a requested spend of $120 USDC is allowed for agent 'agent-789' with a $200 remaining budget and $150 per-transaction limit in USDC — but flag anything over $100 for manual review."},{"title":"Zero-headroom budget block detection","prompt":"I need to know if agent 'agent-001' can still spend $60 USDC on an 'api_purchase' when its remaining budget is only $10 USDC and the per-transaction limit is $50 USDC. Tell me if it should be blocked."}],"resultDescription":"Returns an advisory policy result (e.g. ALLOW, REVIEW, or BLOCK) indicating whether the requested spend fits within the supplied remaining budget and per-transaction limit, along with reasoning. Does not reserve, hold, or authorize any funds — purely advisory.","failureModes":["Invalid number format in requested_amount or remaining_budget returns a validation error","requested_amount or remaining_budget fields missing causes a 400 bad request","Currency enum value not in [USDC, USDT, USD] is rejected","Pattern violations on agent_id or purpose fields cause schema errors","Service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when an AI agent needs a lightweight, advisory pre-spend check before executing a payment — especially when enforcing per-transaction caps, remaining budget headroom, or auto-approval thresholds without any side effects. Prefer it over full authorization flows when you only need a policy decision, not a fund reservation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:25.633Z","isFirstParty":false,"canonicalSlug":"no-hands-ai-budget-check-ca2692d1"}