{"openapi":"3.1.0","info":{"title":"Automaton Revenue API","version":"1.0.0","description":"A paid, agent-ready website trust audit settled in USDC over x402."},"servers":[{"url":"https://automaton.arxnnet.com"}],"paths":{"/api/v1/sample-audit":{"get":{"operationId":"readLiveSampleAudit","summary":"Read a free live demonstration audit","description":"Returns a cached, current audit of the public example.com page. It does not accept a customer-supplied target and never counts as revenue.","responses":{"200":{"description":"Live sample audit with checks and priorities"},"503":{"description":"The public sample target could not be refreshed"}}}},"/api/v1/audit":{"get":{"operationId":"auditWebsite","summary":"Audit a public HTTPS page","description":"Returns an evidence-based technical trust and search audit. Unpaid requests receive HTTP 402 payment instructions.","x-payment-info":{"protocol":"x402-v2","price":"$0.25","currency":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2048},"example":"https://example.com"}],"responses":{"200":{"description":"Paid audit result","content":{"application/json":{"schema":{"type":"object","required":["service","auditedUrl","score","grade","checks","priorities"],"properties":{"service":{"type":"string"},"auditedUrl":{"type":"string","format":"uri"},"score":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"checks":{"type":"array","items":{"type":"object"}},"priorities":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"USDC payment required via x402"},"422":{"description":"The target could not be safely audited"},"503":{"description":"The agent is dead or the durable economy is down"}}}},"/api/v1/site-opportunity-report":{"get":{"operationId":"auditSiteOpportunity","summary":"Audit up to five pages on one website","description":"Clusters repeated failures and returns a prioritized site-wide remediation roadmap.","x-payment-info":{"protocol":"x402-v2","price":"$3.25","currency":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2048}}],"responses":{"200":{"description":"Paid multi-page opportunity report"},"402":{"description":"USDC payment required via x402"},"422":{"description":"The target could not be safely audited"},"503":{"description":"No onchain seller is available"}}}},"/api/v1/agency-portfolio-audit":{"get":{"operationId":"auditAgencyPortfolio","summary":"Rank opportunities across up to ten websites","x-payment-info":{"protocol":"x402-v2","price":"$19.00","currency":"USDC"},"parameters":[{"name":"urls","in":"query","required":true,"schema":{"type":"string","maxLength":20480},"description":"One to ten comma-separated public HTTPS URLs."}],"responses":{"200":{"description":"Paid ranked portfolio report"},"402":{"description":"USDC payment required via x402"},"422":{"description":"The submitted sites were invalid"},"503":{"description":"No onchain seller is available"}}}},"/api/v1/monitoring/enroll":{"get":{"operationId":"enrollWebsiteMonitor","summary":"Create a renewable 30-day website monitor","x-payment-info":{"protocol":"x402-v2","price":"$9.00","currency":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2048}}],"responses":{"200":{"description":"Monitor identifier, private bearer token and renewal instructions"},"402":{"description":"USDC payment required via x402"},"503":{"description":"No onchain seller is available"}}}},"/api/v1/monitoring/{monitorId}":{"get":{"operationId":"readWebsiteMonitor","summary":"Read or refresh an authorized monitor","security":[{"bearerAuth":[]}],"parameters":[{"name":"monitorId","in":"path","required":true,"schema":{"type":"string","pattern":"^M-[A-F0-9]{20}$"}}],"responses":{"200":{"description":"Durable monitoring history"},"404":{"description":"Monitor authorization failed"}}}},"/api/v1/monitoring/renew":{"get":{"operationId":"renewWebsiteMonitor","summary":"Renew an authorized monitor for another 30 days","security":[{"bearerAuth":[]}],"x-payment-info":{"protocol":"x402-v2","price":"$9.00","currency":"USDC"},"parameters":[{"name":"monitorId","in":"query","required":true,"schema":{"type":"string","pattern":"^M-[A-F0-9]{20}$"}}],"responses":{"200":{"description":"Renewed monitor contract"},"402":{"description":"USDC payment required via x402"},"404":{"description":"Monitor authorization failed"}}}},"/api/v1/agents/{agentId}/audit":{"get":{"operationId":"auditWebsiteWithAgent","summary":"Buy an audit directly from a living descendant","description":"Each replicated agent has its own funded onchain wallet. Payment settles directly to the selected agent.","parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^A-[0-9]{4,}$"},"example":"A-0002"},{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2048},"example":"https://example.com"}],"responses":{"200":{"description":"Paid audit result"},"402":{"description":"USDC payment required via x402"},"503":{"description":"The selected agent is not alive with an onchain wallet"}}}},"/api/health":{"get":{"operationId":"getAutomatonHealth","summary":"Read operational status","responses":{"200":{"description":"At least one agent is alive"},"503":{"description":"The economy is unavailable or extinct"}}}},"/api/v1/catalog":{"get":{"operationId":"discoverAutomatonProducts","summary":"Read the public machine marketplace catalog","responses":{"200":{"description":"Product, price, protocol, discovery and availability metadata"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}