{"openapi":"3.1.0","info":{"title":"x402.fuchss.app — trust & reliability data for the x402 ecosystem","version":"2.0.0","description":"Trust & reliability scores for x402 endpoints. Continuous 24/7 monitoring of every publicly listed x402 service: uptime probes, 402-envelope spec compliance, advertised price history, and real on-chain USDC settlement volume per payTo address. Deterministic, auditable scoring — know before you pay. Free top-25 leaderboard at /trust/leaderboard.","x-guidance":"We monitor every publicly listed x402 endpoint 24/7: uptime probes, 402-envelope compliance, advertised price history, and REAL on-chain USDC settlement volume per payTo address. Buy a trust score before you pay an unknown endpoint. Payment: USDC EIP-3009 on Base mainnet (eip155:8453) via the x402 X-PAYMENT header. Free tier: GET /trust/leaderboard.","contact":{"name":"x402.fuchss.app","url":"https://x402.fuchss.app"}},"servers":[{"url":"https://x402.fuchss.app"}],"paths":{"/v1/x402-trust":{"post":{"summary":"Trust score for any listed x402 endpoint","description":"Deterministic trust score (0-100, graded A-F) computed from our observation history: 30d probe uptime, 402-envelope spec compliance, latency, observed age, on-chain USDC settlement activity to the endpoint's payTo, and price stability. Returns the full component breakdown + machine-readable flags so you can audit the math. No LLM involved.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","description":"Full x402 resource URL (https://...) as listed in discovery."}},"required":["resource"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","description":"Echoed resource URL."},"score":{"type":"number","description":"0-100 trust score."},"grade":{"type":"string","description":"A/B/C/D/F."},"confidence":{"type":"number","description":"0-1, scales with observation count."},"breakdown":{"type":"object","description":"Per-component subscores (uptime, compliance, latency, age, activity, stability)."},"flags":{"type":"object","description":"Machine-readable issue slugs."},"stats":{"type":"object","description":"Raw 30d stats the score was computed from."}},"required":[]}}}},"402":{"description":"Payment Required"}}}},"/v1/x402-history":{"post":{"summary":"Observation history for any listed x402 endpoint","description":"Raw time-series from our monitoring database: discovery snapshots (listed/delisted/relisted, advertised price changes, payTo changes) and probe results (uptime, latency, quoted amount) for the requested window. This is the data nobody can backfill — we were watching, you weren't.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","description":"Full x402 resource URL (https://...) as listed in discovery."},"days":{"type":"number","description":"Lookback window in days (1-90, default 30)."}},"required":["resource"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/v1/x402-payment-trace":{"post":{"summary":"x402 EIP-3009 payment trace","description":"Decodes an EIP-3009 settlement tx (transferWithAuthorization / receiveWithAuthorization), identifies payer/payee/amount/token, cross-references our local ledger if the payment was local.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.011673"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txHash":{"type":"string","description":"0x-prefixed 32-byte transaction hash.","pattern":"^0x[0-9a-fA-F]{64}$"},"hintResource":{"type":"string","description":"Optional x402 resource URL the caller believes this payment was for."},"network":{"type":"string","description":"Venice RPC network slug (default base-mainnet). One of: base-mainnet, ethereum-mainnet, arbitrum-mainnet, optimism-mainnet, polygon-mainnet.","enum":["base-mainnet","ethereum-mainnet","arbitrum-mainnet","optimism-mainnet","polygon-mainnet"]},"model":{"type":"string","description":"Optional Venice model id (default picks the cheapest catalog model satisfying the request)."}},"required":["txHash"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}}}}