{"uid":"cap_SPObzebsEpFGtvIAG4rFS","slug":"trust402-procurement-plan-8fa844d4","name":"Trust402 Procurement Plan","description":"Create a bounded spend plan without spending money.","url":"https://trust402.aztecbeacon.uk/api/procurement/plan","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.plan","recommendation":"approve-after-review"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JBH906hhwbdxQUcostqvg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 pay-per-call API candidates against a buyer goal and budget, producing a scored procurement recommendation.","exampleAgentPrompt":"I have three x402 endpoints I'm considering — https://api.example.com/search, https://api.foo.com/enrich, and https://api.bar.com/classify — with prices of $0.01, $0.03, and $0.02 respectively on Base (eip155:8453). My goal is to enrich customer records and my total budget is $2.00. Can you build a procurement plan and tell me which ones are worth approving?","exampleUseCases":[{"title":"Rank data-enrichment APIs by value","prompt":"I'm looking at four x402 endpoints for real-time customer profile enrichment and I've got $3.50 to spend. They're at https://api.dataprovider.io/enrich, https://api.intel.com/profile, https://api.signals.eth/match, and https://api.verify.xyz/validate — priced at $0.05, $0.08, $0.04, and $0.06 per call. Can you score them against my enrichment goal and recommend which ones I should actually approve?"},{"title":"Find trustworthy APIs within strict budget","prompt":"I need to integrate three pay-per-call endpoints into my automation workflow but I only have $1.00 to spend this month. The candidates are https://api.classify.io/categorize at $0.015, https://api.extract.com/parse at $0.025, and https://api.transform.ai/convert at $0.020. Which of these should I trust and approve given my budget and classification task?"},{"title":"Plan multi-API spending across suppliers","prompt":"We're building a document processing pipeline and considering five different x402 suppliers for OCR, entity extraction, and validation. My procurement budget is $5.00 and I need recommendations on which combo of these endpoints represents the best trust-to-cost ratio. Can you evaluate them and give me a ranked approval plan?"}],"resultDescription":"A JSON object with an 'ok' boolean, the tool name ('procurement.plan'), and a 'recommendation' field (e.g. 'approve-after-review') indicating whether the buyer should proceed with the candidate set, along with any ranked or scored breakdown of the candidates.","failureModes":["Missing or empty 'goal' field causes unscored or rejected plan","Budget of 0 or below may result in all candidates being rejected","Candidates with no 'endpoint' or 'url' field fail schema validation","Malformed payTo address (not a valid 0x Ethereum address) causes candidate rejection","Unknown or unsupported network string may reduce scoring confidence","Empty candidates array returns a trivially empty plan","Price fields with non-numeric strings may be ignored or cause parse errors"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously decide which x402 pay-per-call APIs to purchase or invoke, especially when comparing multiple candidates against a fixed budget and a specific task goal. It is the right choice when you need a structured trust assessment and procurement recommendation before committing micropayments, rather than paying blindly or manually comparing endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:32:07.162Z","isFirstParty":false}