{"openapi":"3.0.3","info":{"title":"The Maraventano Index — Agent Endpoints","version":"2026.10.19","description":"Machine-payable endpoints of The Maraventano Index — signed, longitudinal, independently-replicable merchant-side intelligence on the x402 agent economy, operated continuously since April 2026. Paid routes gated by x402 (USDC on Base or Solana); the two Reports are also purchasable by card (Stripe). Ed25519-signed attestations on every delivery. CC0 payloads except the Reports (institutional-use license).","contact":{"email":"research@maraventanoindex.com"}},"servers":[{"url":"https://maraventanoindex.com"}],"paths":{"/api/report/founding":{"get":{"summary":"The Founding Report — the full Apr 6-Sep 8 2026 record (156 days from go-live): report PDF + File 1 observational dataset (1,096,694 request-level records) + Ed25519-signed integrity manifest + data dictionary + Appendix B (133 on-chain settlements). One-time, $3,000 via x402 USDC, or by card (Stripe). Delivered on verified settlement as an expiring single-purchase download.","responses":{"200":{"description":"Signed download link to the Founding bundle"},"402":{"description":"Payment required ($3,000 USDC)"}}}},"/api/report/30day":{"get":{"summary":"The 30-Day Report — a complete 30-day edition (V.1: Sep 9-Oct 8 2026, four x402 virtual hosts): report PDF + File 1 observational dataset (306,799 request-level records) + Ed25519-signed integrity manifest + data dictionary + Appendix B (49 on-chain settlements). $1,000 per edition via x402 USDC, or by card (Stripe). Delivered on verified settlement as an expiring single-purchase download.","responses":{"200":{"description":"Signed download link to the 30-Day bundle"},"402":{"description":"Payment required ($1,000 USDC)"}}}},"/api/x402-operator-census":{"get":{"summary":"Full signed roster of x402 operators observed from the merchant seat ($0.50 USDC via x402)","responses":{"200":{"description":"Signed operator census"},"402":{"description":"Payment required"}}},"post":{"summary":"Same as GET","responses":{"402":{"description":"Payment required"}}}},"/api/x402-operator-census/lookup":{"get":{"summary":"Per-call counterparty check — pass ?ua=<counterparty-UA>, receive one signed verdict row (known_payer | probe_only | low_signal | unknown) ($0.01 USDC via x402)","parameters":[{"name":"ua","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signed verdict row"},"402":{"description":"Payment required"}}},"post":{"summary":"Same as GET; accepts {ua, wallet} in a JSON body","responses":{"402":{"description":"Payment required"}}}},"/api/x402-operator-census/headline":{"get":{"summary":"FREE: signed headline numbers from the operator census","responses":{"200":{"description":"Signed headline"}}}},"/api/mirror":{"get":{"summary":"Full merchant-side telemetry corpus + your_client reflection ($0.25 USDC via x402)","responses":{"200":{"description":"Signed corpus + reflection"},"402":{"description":"Payment required"}}},"post":{"summary":"Same as GET","responses":{"402":{"description":"Payment required"}}}},"/api/mirror/preview":{"get":{"summary":"FREE: caller's own merchant-side reflection (your_client only)","responses":{"200":{"description":"Signed reflection"}}}},"/api/x402-failure-corpus":{"get":{"summary":"Classified failure taxonomy + probe-only operator roster ($0.50 USDC via x402)","responses":{"200":{"description":"Signed failure corpus"},"402":{"description":"Payment required"}}},"post":{"summary":"Same as GET","responses":{"402":{"description":"Payment required"}}}},"/api/x402-failure-corpus/headline":{"get":{"summary":"FREE: counts and failure-mode distribution","responses":{"200":{"description":"Signed headline"}}}},"/api/x402-conformance/self/card":{"get":{"summary":"Signed report card + 30-day SVG badge grading the caller's own x402 client ($0.33 USDC via x402)","responses":{"200":{"description":"Signed report card + badge"},"402":{"description":"Payment required"}}},"post":{"summary":"Same as GET","responses":{"402":{"description":"Payment required"}}}},"/api/x402-conformance/self":{"get":{"summary":"FREE: signed grade letter + teaser","responses":{"200":{"description":"Signed grade letter"}}}},"/api/data-daily":{"get":{"summary":"Signed daily snapshot of the merchant seat ($1.00 USDC via x402)","responses":{"200":{"description":"Signed snapshot"},"402":{"description":"Payment required"}}}}}}