{"uid":"cap_LBnFfo9ixIkDp-Ug78hB_","slug":"agent-spend-assurance-5c8fac76","name":"Agent Spend Assurance","description":"One signed preflight for an autonomous x402 payment: WalletGuard counterparty screening, Payment Policy challenge validation, and structured evidence verification. Returns allow, deny, or needs_review plus the component findings and a tamper-evident service receipt. Caller-provided wallet context only; no external chain-intelligence feed.","url":"https://hermesplant.com/api/agent-services/spend-assurance/run","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"runId":{"type":"string","description":"Optional caller run identifier."},"wallet":{"type":"object","description":"WalletGuard context: wallet plus optional labels, sanctionsHits, exposures, transfers, and fundingSources."},"payment":{"type":"object","description":"Payment Policy input: resource, x402 challenge fields, buyer policy, and optional replay context."}}},"responseSchema":{"type":"json","example":{"status":"assessed","wallet":{"riskLevel":"low","riskScore":0,"recommendedAction":"proceed_with_standard_controls"},"allowed":true,"payment":{"allowed":true,"decision":"allow","recommendedAction":"sign_and_retry_payment"},"receipt":{"algorithm":"HMAC-SHA-256","verifyUrl":"https://hermesplant.com/api/receipts/verify"},"service":"spend-assurance","decision":"allow","evidence":{"decision":"verified","verified":true},"recommendedAction":"sign_and_retry_payment"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JkfRkzAgcJONix0XuB7GB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a deterministic safety gate on wallet risk and x402 payment policy before consequential agent actions, returning an allow/deny decision with HMAC-signed evidence receipts.","exampleAgentPrompt":"Before my agent signs and retries this x402 payment challenge for the resource at api.example.com, run a spend assurance check on my wallet — assess the risk level and tell me if I should proceed, with a verifiable HMAC receipt I can store as evidence.","exampleUseCases":[{"title":"Pre-payment wallet risk gate","prompt":"My agent is about to make an x402 payment to access a data API — can you run a spend assurance check on my wallet first and tell me if the risk level is low enough to proceed, and give me a signed receipt?"},{"title":"Autonomous deploy safety check","prompt":"Before my agent executes that infrastructure deployment and the associated x402 charge, validate the wallet context and payment challenge and tell me whether to allow or block it, with a machine-readable evidence bundle."},{"title":"Compliance evidence for agent spend audit","prompt":"My agent just completed an autonomous purchase — run a spend assurance assessment on the wallet and payment details so I have an HMAC-signed receipt and verified evidence I can keep for our audit trail."}],"resultDescription":"Returns a JSON object with an overall allow/deny decision, wallet risk level and score, recommended action (e.g. 'proceed_with_standard_controls' or 'sign_and_retry_payment'), a payment-specific sub-decision, and an HMAC-SHA-256 signed receipt with a verify URL for tamper-evident audit evidence.","failureModes":["Missing required wallet or payment fields returns a validation error","High-risk or sanctioned wallet triggers a deny decision with a block recommended action","Invalid or replayed x402 challenge may return a deny with replay-detected evidence","Malformed bodyType or method enum causes a 400-level rejection","Unreachable receipt verify URL may indicate a transient service issue"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a deterministic, policy-driven safety gate specifically for x402 payments combined with wallet risk scoring and tamper-evident receipt generation — particularly when audit trails and machine-readable evidence of spend decisions are required. Prefer this over generic fraud checks when the x402 protocol, wallet sanctions screening, and HMAC-signed receipts are all needed in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:41:38.447Z","isFirstParty":false}