{"uid":"cap_z3XhhGyafAx8mHVSNqB_-","slug":"trust402-procurement-quote-44e1240d","name":"Trust402 Procurement Quote","description":"Produce a concrete quote and approval payload for a multi-resource purchase path without spending.","url":"https://trust402.aztecbeacon.uk/api/procurement/quote","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"goal":{"type":"string","description":"Buyer goal for selecting x402 resources."},"budgetUsd":{"type":"number","description":"Maximum spend budget for the plan or quote."},"candidates":{"type":"array","items":{"type":"object","anyOf":[{"required":["endpoint"]},{"required":["url"]}],"properties":{"id":{"type":"string","description":"Stable candidate identifier used in rankings and receipts."},"url":{"type":"string","format":"uri","description":"Alternate field for the x402 resource endpoint."},"name":{"type":"string","description":"Human-readable resource name."},"x402":{"type":"object","description":"Optional parsed x402 challenge metadata."},"asset":{"type":"string","description":"Payment asset address or symbol."},"payTo":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"price":{"oneOf":[{"type":"number","minimum":0},{"type":"string"}],"description":"Alternate price field accepted by Trust402."},"accept":{"type":"object","description":"Optional single x402 accept object."},"has402":{"type":"boolean","description":"Whether the endpoint is known to return an x402 challenge."},"network":{"type":"string","description":"x402 payment network, for example eip155:8453."},"endpoint":{"type":"string","format":"uri","description":"HTTPS x402 resource endpoint."},"metadata":{"type":"object","description":"Additional public-safe metadata used during scoring."},"observed":{"type":"object","description":"Optional probe observations such as status or latency."},"priceUsd":{"oneOf":[{"type":"number","minimum":0},{"type":"string"}],"description":"Advertised resource price in USD."},"hasOpenApi":{"type":"boolean","description":"Whether the origin publishes OpenAPI metadata."},"openapiUrl":{"type":"string","format":"uri"},"proofReady":{"type":"boolean","description":"Alternate receipt/proof readiness signal."},"description":{"type":"string","description":"Buyer-facing explanation of the resource."},"inputSchema":{"type":"object","description":"Optional embedded input schema for the candidate."},"hasWellKnown":{"type":"boolean","description":"Whether the origin publishes /.well-known/x402 discovery."},"receiptReady":{"type":"boolean","description":"Whether the candidate can return receipt/proof-ready output."},"wellKnownUrl":{"type":"string","format":"uri"},"hasInputSchema":{"type":"boolean","description":"Whether structured input schema metadata is available."}},"additionalProperties":true},"maxItems":10,"minItems":2},"maxPaidCalls":{"type":"integer","default":3},"riskTolerance":{"enum":["low","medium","high"],"type":"string","default":"low"}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"procurement.quote","recommendation":"approve-after-review"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8RjN3Ry6ce-l0KmJ9hEek","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates a set of x402-gated API candidates against a buyer goal and budget, returning a ranked recommendation on whether to approve procurement.","exampleAgentPrompt":"I have a $0.50 budget and I'm trying to find the best x402 API for real-time weather data — can you run a Trust402 procurement quote comparing these three candidates and tell me which one to approve: api.weatherx402.io, wx402.example.com, and forecast402.network?","exampleUseCases":[{"title":"Rank paywalled APIs by trustworthiness","prompt":"I've got a $2 budget and I need to pull live stock price data — I found four x402-gated endpoints I could pay for: equityfeed402.io, markets402.net, stockstream402.com, and pricewall402.org. Can you run a Trust402 procurement quote and tell me which ones are actually worth approving, ranked by trust and price?"},{"title":"Filter x402 endpoints before committing payment","prompt":"Before I let my agent start spending money, I want a recommendation on which of these paywalled NLP inference APIs I should actually buy — my goal is fast sentiment analysis under $1 per call. The candidates are nlpgate402.ai, sentimentwall402.com, and inferx402.net. Can you run a trust-weighted procurement quote and flag any I should skip?"},{"title":"Approve budget-constrained x402 API procurement","prompt":"I'm building an automated research pipeline and I need to pick one geospatial data API from a shortlist of x402-gated options — geodata402.io, mapwall402.com, and geostream402.net — without going over $5 total. Can you evaluate these candidates against my goal and budget and give me a procurement recommendation on which to approve?"}],"resultDescription":"A JSON object with an 'ok' boolean, a 'tool' identifier ('procurement.quote'), and a 'recommendation' string (e.g. 'approve-after-review') indicating the trust-weighted procurement decision for the submitted x402 candidates.","failureModes":["Missing required 'goal' field returns validation error","Budget of 0 or negative may yield no approvable candidates","Candidates missing both 'endpoint' and 'url' fields fail schema validation","Unknown or unreachable x402 endpoints may return low trust scores or be excluded","Malformed payTo address (non-0x Ethereum format) causes candidate rejection","Response may return ok:false if no candidates pass trust threshold"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously decide which x402-paywalled API resources to purchase from a pool of candidates, especially when trust scoring and budget constraints must be applied before committing any payment. Prefer this over raw x402 payment endpoints when the agent does not yet know which resource to buy and needs a recommendation layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:30:46.260Z","isFirstParty":false}