{"uid":"cap_zUz5qGXlChmV3JMtabnqC","slug":"delx-commerce-price-ceiling-check-c7797a92","name":"Delx Commerce Price Ceiling Check","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/price-ceiling-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"buffer_pct":{"type":"integer","description":"Input field: buffer pct."},"price_usdc":{"type":"number","description":"Input field: price usdc."},"ceiling_usdc":{"type":"number","description":"Input field: ceiling usdc."}}},"responseSchema":{"type":"json","example":{"ok":true,"schema":"delx/util-price-ceiling-check/v1","status":"within_budget","allowed":true,"buffer_pct":0,"price_usdc":0.01,"ceiling_usdc":0.02,"headroom_usdc":0.01,"effective_ceiling_usdc":0.02}},"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_yb9bieQIYJ-K1zYmdRrs7","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 whether a given USDC price falls within a specified budget ceiling, optionally applying a buffer percentage, and returns headroom and allowance status.","exampleAgentPrompt":"Before we pay for that API call, check if the price of 0.01 USDC is within my ceiling of 0.05 USDC with a 10% buffer — I want to make sure we're within budget before proceeding.","exampleUseCases":[{"title":"Pre-payment budget guard for agents","prompt":"Before paying for that search result, check if the 0.005 USDC price is within my 0.02 USDC ceiling with a 5% buffer — only proceed if it's allowed."},{"title":"Spending headroom dashboard","prompt":"Tell me how much headroom I have left if I'm about to spend 0.01 USDC and my budget ceiling is 0.03 USDC — no buffer needed."},{"title":"Conservative budget enforcement with safety margin","prompt":"I want to make sure a 0.008 USDC charge won't breach my 0.01 USDC limit even after applying a 20% safety buffer — is it still allowed?"}],"resultDescription":"Returns a JSON object indicating whether the price is allowed (boolean), a human-readable status string (e.g. 'within_budget'), the effective ceiling after applying any buffer, and the remaining headroom in USDC. Also echoes back the input price, ceiling, and buffer percentage for verification.","failureModes":["Missing required fields (price_usdc or ceiling_usdc) may result in validation errors or unexpected null comparisons","Negative or zero ceiling_usdc could produce nonsensical headroom values","buffer_pct values above 100 may cause the effective ceiling to drop to zero, always returning disallowed","Non-numeric inputs for USDC fields will likely cause schema validation failures","Floating-point precision issues with very small USDC amounts may affect headroom calculations"],"whenToPreferThis":"Use this endpoint when an AI agent needs a lightweight, structured pre-flight check before authorizing a micropayment — especially in agentic pipelines where spending must be capped per call. Ideal when you want a verifiable, schema-tagged response that can be logged or audited. Prefer this over ad-hoc arithmetic when you need buffer logic baked in and a clear allowed/disallowed signal that downstream logic can act on without ambiguity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:59.431Z","isFirstParty":false,"canonicalSlug":"delx-commerce-price-ceiling-check-c7797a92"}