{"uid":"cap_FOcvvok1j1IThnfyFSdZ8","slug":"ardaro-agent-spend-budget-check-d482a71b","name":"Ardaro Agent Spend Budget Check","description":"Evidence-bounded visibility into publicly discoverable x402 agent services.","url":"https://agents.getardaro.com/v1/agent-utilities/budget-check/analyze","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"result":{"tool":"authorize_agent_spend","checks":{"rate_within_limit":true,"currency_consistent":true,"hourly_within_limit":true,"transaction_within_limit":true},"policy":{"scope":"Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled.","fee_scope":"The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed.","stateless":true,"model_calls":0,"advisory_only":true,"history_scope":"The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified.","ledger_updated":false,"history_verified":false,"delivery_verified":false,"credentials_issued":false,"reservation_created":false,"policy_authenticated":false,"human_review_required":true,"external_spend_enforced":false,"checks_exclude_service_fee":true,"submitted_records_retained":false,"submitted_evidence_verified":false,"caller_identity_authenticated":false,"downstream_payment_authorized":false},"currency":"USD","findings":[],"proposed_cost":"0.300000","policy_currency":"USD","history_currency":"USD","proposed_hour_total":"0.600000","authorization_status":"WITHIN_SUBMITTED_LIMITS","submitted_budget_in_use":"0.300000","hourly_remaining_after_proposal":"4.400000"},"status":"review_required","identities":{"analysis_result_identity":"res_3c6a67153fe1a091ccf08839ea792ccdf312bfda5453ba66fd50cab04dc263c4"},"service_id":"ardaro.authorize_agent_spend","contract_version":"ardaro.agent-utilities.response.v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_G6O9Ybn_wD3C_WeL1MVa-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a stateless, advisory-only check of whether a proposed agent spend falls within caller-supplied budget limits and rolling-hour history, returning a within-limits or review-required verdict.","exampleAgentPrompt":"Before my agent pays for the next downstream API call, can you do an advisory budget check — the proposed cost is $0.30, my hourly limit is $5.00, I've already committed $0.30 this hour, I have no pending reservations, and this is my first check this minute?","exampleUseCases":[{"title":"Pre-payment guard rail for autonomous agent","prompt":"My agent is about to spend $0.50 on a downstream service — can you check if that fits within its $5 hourly budget? It's already committed $0.30 this hour, has two unresolved pending reservations totaling $0.20, and this is the third budget check in the current minute."},{"title":"Currency consistency check before agent spend","prompt":"Can you validate that a proposed $0.25 USD transaction is consistent with my agent's USD-denominated policy and that it won't push the hour total over my $3.00 limit? No prior spend this hour and no pending reservations."},{"title":"Rate-limit compliance check for high-frequency agent","prompt":"My agent is firing lots of downstream calls — can you run a budget check on a proposed $0.10 spend, given my $2.00 hourly cap, $1.60 already committed this hour, $0.10 in pending reservations, and this is the eighth check this minute?"}],"resultDescription":"Returns a JSON object with authorization_status (e.g. WITHIN_SUBMITTED_LIMITS), boolean check results for rate, currency, hourly, and transaction limits, proposed_hour_total, hourly_remaining_after_proposal, submitted_budget_in_use, a findings array, and a cryptographic analysis_result_identity. The result is advisory only — no reservation is created, no spend is authorized, no ledger is updated, and caller-supplied history is not verified.","failureModes":["Caller supplies incomplete or inconsistent history, leading to misleading within-limits verdict","Currency mismatch between proposed cost and policy may trigger a failed currency_consistent check","Proposed cost exceeding hourly limit returns a review-required status rather than a hard block","Service fee ($0.10 USDC per call) is excluded from checks and must be budgeted separately","No external enforcement: a within-limits result does not prevent actual overspend"],"whenToPreferThis":"Use this endpoint when an AI agent needs a lightweight, stateless advisory check before executing a downstream payment or API call, and you want a structured verdict with a cryptographic result identity for audit trails. Prefer this over building custom budget logic when operating within the x402 agent ecosystem. Note that this is advisory only and must be combined with real enforcement mechanisms; do not rely on it as a sole spending control.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:11.196Z","isFirstParty":false}