{"uid":"cap_IoC-46h7lRMqgIFXDUCeO","slug":"x402-amount-budget-check-044567e3","name":"X402 Amount Budget Check","description":"X402 Amount Budget Check: X402 Amount Budget Check checks challenge raw amount against an exact buyer call budget from bounded caller-supplied values without an external provider. Call X402 Amount Budget Check before paying for or accepting an x402 or agent delivery assembled from caller-supplied challenge and result metadata. Returns contract-specific checks, normalized evidence, mismatch reasons, and an explicit acceptance or rejection status for X402 Amount Budget Check as versioned determin…","url":"https://api.delx.ai/api/v1/x402/x402-amount-budget-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount_raw":{"type":"string","maxLength":8192,"description":"Amount Raw supplied to X402 Amount Budget Check; used only for this bounded calculation and processed in memory without retention."},"maximum_raw":{"type":"string","maxLength":8192,"description":"Maximum Raw supplied to X402 Amount Budget Check; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"amount_raw":"1000","maximum_raw":"2000","within_budget":true},"schema":"delx/util-x402-amount-budget-check/v1","status":"pass","evidence":{"retained":false,"input_sha256":"95ec59ab3108f4c8d18b157c563dcdebd3f620f744be1691dbc78948f24b6667","external_calls":0},"operation":"delivery_contract:x402_amount_budget_check"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mNi8ctoiJTgySQpqK8pYE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a raw payment amount against a caller-supplied maximum budget, returning an explicit accept/reject decision with mismatch reasoning for x402 payment challenges.","exampleAgentPrompt":"Before we approve this x402 payment, check whether the raw amount '1000000' is within our maximum budget of '5000000' — I need an explicit accept or reject with any mismatch reasons.","exampleUseCases":[{"title":"Pre-payment x402 budget gate","prompt":"We're about to pay an x402 challenge with a raw amount of '2000000'. Our budget cap is '1500000'. Check whether it fits and tell me if it's rejected and why."},{"title":"Agent delivery cost approval","prompt":"An agent just returned a delivery challenge quoting raw amount '750000'. My maximum allowed spend per call is '1000000'. Validate that amount against my budget and give me the acceptance status."},{"title":"Automated micropayment overspend guard","prompt":"Before my workflow approves any x402 micropayment, verify that the raw amount '9999999' doesn't exceed the maximum '5000000' — return the normalized evidence and any mismatch reasons so I can log them."}],"resultDescription":"Returns a structured response containing: an explicit acceptance or rejection status, contract-specific validation checks, normalized evidence of the comparison, and mismatch reasons explaining why the amount was rejected (if applicable). The decision is deterministic and versioned, derived solely from the two caller-supplied raw values.","failureModes":["Missing amount_raw or maximum_raw — endpoint requires both fields to compute a result","Non-numeric or malformed raw strings may cause a validation error or unexpected rejection","Values exceeding maxLength of 8192 characters will be rejected","Network or service unavailability returning a non-200 response"],"whenToPreferThis":"Use this endpoint when you need a deterministic, no-external-dependency check of an x402 raw payment amount against a caller-defined budget cap before authorizing a payment or accepting an agent delivery. Prefer it over ad-hoc client-side comparisons when you need structured rejection reasons, normalized evidence, and a versioned audit-ready decision rather than a simple boolean.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:01:40.060Z","isFirstParty":false}