{"openapi":"3.1.0","info":{"title":"x402 capability router","version":"3.0.0","description":"Finds x402 services for a natural-language capability, probes candidates without paying them, and returns up to three currently reachable services ranked by live reliability. Exact USDC payment on Base."},"servers":[{"url":"https://agent-production-1daa.up.railway.app"}],"paths":{"/v1/directory/search":{"get":{"operationId":"searchX402Directory","summary":"Free cached natural-language search of public x402 services","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Matching Bazaar resources; no payment required"}}}},"/v1/routes/recommend":{"post":{"operationId":"recommendX402Routes","summary":"Live reliability-ranked x402 route recommendations","description":"Finds x402 services for a natural-language capability, probes candidates without paying them, and returns up to three currently reachable services ranked by live reliability. Exact USDC payment on Base. Price: $0.05.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capability":{"type":"string","minLength":2,"maxLength":500,"description":"Natural-language capability the buyer needs"},"limit":{"type":"integer","minimum":1,"maximum":3,"default":3}},"required":["capability"]},"example":{"capability":"current weather data for a city","limit":3}}}},"responses":{"200":{"description":"Up to three currently reachable routes ranked by reliability","content":{"application/json":{"example":{"routeId":"route_opaque","capability":"current weather data for a city","observedAt":"2026-08-09T12:00:00.000Z","paymentState":"settled","recommendations":[{"resource":"https://weather.example/v1/current","method":"POST","serviceName":"Weather API","description":"Current weather observations","reliabilityScore":95,"summary":"Endpoint passed every reliability check.","latencyMs":120,"accepts":[]}]}}}},"400":{"description":"Invalid request or payment identifier"},"402":{"description":"Exact x402 payment required"},"404":{"description":"No currently reachable matching routes; payment canceled"},"409":{"description":"Payment identifier already used"},"502":{"description":"Bounded routing evaluation failed; payment canceled"}}}},"/v1/reliability/evaluate":{"post":{"operationId":"evaluateX402Reliability","summary":"Fresh deterministic reliability report for a public x402 endpoint","description":"Fresh reliability evaluation for public x402 services. Checks HTTPS reachability, unpaid HTTP 402 behavior, PAYMENT-REQUIRED decoding, discovery metadata, schemas, and quote consistency. Returns a deterministic scored report and public report URL. No account or API key; exact USDC payment on Base. Price: $0.25.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resourceUrl":{"type":"string","description":"Public HTTPS x402 resource URL to evaluate"},"method":{"type":"string","enum":["GET","POST"]},"sampleBody":{"type":"object","description":"Optional bounded JSON body for a POST probe"}},"required":["resourceUrl","method"]},"example":{"resourceUrl":"https://seller.example/v1/tool","method":"POST","sampleBody":{"query":"health check"}}}}},"responses":{"200":{"description":"Reliability report; publication follows successful settlement","content":{"application/json":{"example":{"reportId":"rpt_opaque","serviceId":"svc_opaque","observedAt":"2026-07-26T12:00:00.000Z","score":82,"scoringVersion":"1","summary":"Payment challenge is live; discovery metadata is incomplete.","checks":[],"reportUrl":"/v1/reliability/reports/rpt_opaque"}}}},"400":{"description":"Invalid target or payment identifier"},"402":{"description":"Exact x402 payment required"},"409":{"description":"Payment identifier already used"},"502":{"description":"Evaluation could not be completed"}}}}}}