{"uid":"cap_5BUpidll5SC2k-Z7Ua5A-","slug":"trust402-procurement-quote-78d4b64d","name":"Trust402 Procurement Quote","description":"Produce a concrete quote and approval payload for a multi-resource purchase path without spending.","url":"https://trust402.vercel.app/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":null,"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_WHB42jVubpF9QLMZtSz-8","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":"Generates a concrete quote and approval payload for purchasing multiple x402 resources within a budget, without actually executing any payments.","exampleAgentPrompt":"I want to buy access to these three x402 endpoints for data enrichment — my goal is 'enrich lead profiles', my total budget is $2.00, and here are the candidate URLs with their prices. Can you generate a quote and approval payload without actually spending anything?","exampleUseCases":[{"title":"Budget-capped agent procurement plan","prompt":"I have a goal of 'summarize recent news for 10 topics' and a $1.50 budget. Here are 5 candidate x402 API endpoints with their prices and descriptions — can you produce a quote and approval payload that fits within budget without making any payments?"},{"title":"Pre-flight cost check for agentic workflow","prompt":"Before my agent starts running, I need a concrete quote for these 4 x402 resources it wants to call — the goal is 'generate weekly market reports', budget is $3.00. Show me what the spend plan would look like and give me an approval payload I can review first."},{"title":"Multi-vendor x402 resource selection quote","prompt":"I'm comparing 6 paid API endpoints for my goal of 'translate and classify customer feedback'. My max budget is $0.50 per run. Can you rank these candidates and give me a quote with an approval payload so I can authorize the best combination?"}],"resultDescription":"Returns a structured quote object with a ranked list of selected x402 resources that fit within the budget, per-resource price breakdown, total estimated cost, and a ready-to-sign approval payload that can be passed to a payment executor — all without triggering any actual transactions.","failureModes":["Budget too low to cover any candidate resource — returns empty plan or error","Invalid candidate endpoint URLs — schema validation failure","Missing required 'goal' or 'budgetUsd' fields — 400 bad request","All candidates lack x402 metadata — scoring impossible, returns degraded quote","Payment asset or network mismatch across candidates — may exclude incompatible resources","Endpoint returns 402 during enrichment probe — expected, handled gracefully"],"whenToPreferThis":"Use this endpoint when an agent needs to plan and review a multi-resource x402 purchase before committing funds — especially when working with a fixed budget across heterogeneous candidate endpoints. Prefer this over the single-endpoint probe when you have 2–10 candidate resources and need a ranked, cost-bounded selection with an approval artifact. Choose this over the spend-plan endpoint when you need a concrete, signable quote payload rather than just a budget allocation sketch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:34.492Z","isFirstParty":false}