{"openapi":"3.1.0","info":{"title":"NullClear Arbiter API","version":"2.0.0","description":"Non-custodial deferred clearing and reputation protocol for x402 AI Agents"},"paths":{"/v1/clear":{"post":{"summary":"Execute deferred escrow clearing for an x402 target request","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["targetUrl","paymentSignatureHeader"],"properties":{"targetUrl":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","DELETE"],"default":"GET"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{},"paymentSignatureHeader":{"type":"string"},"sellerAgentId":{"type":"string"},"minTrustScore":{"type":"number","default":50},"validation":{"type":"object","properties":{"expectedStatus":{"type":"array","items":{"type":"integer"}},"jsonSchema":{"type":"object"},"requiredFields":{"type":"array","items":{"type":"string"}},"sha256Match":{"type":"string"}}}}}}}},"responses":{"200":{"description":"Cleared and settled upstream response"},"400":{"description":"Invalid request or invalid EIP-3009 payment signature"},"403":{"description":"Reputation gate blocked: seller trust score below threshold"},"422":{"description":"Schema validation failed: settlement VOIDED, $0 charged"},"502":{"description":"Upstream network error or facilitator failure"}}}},"/v1/score/{chainId}/{agentId}":{"get":{"summary":"Retrieve composite trust score and Sybil wash-trade analysis for an agent","parameters":[{"name":"chainId","in":"path","required":true,"schema":{"type":"string"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trust score and metrics result"},"400":{"description":"Invalid chain ID"}}}},"/v1/kya/attest":{"post":{"summary":"Register and attest a corporate liability KYA mandate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mandate","chainId"],"properties":{"chainId":{"type":"integer"},"mandate":{"type":"object","required":["corporateEntity","agentId","agentWallet"],"properties":{"corporateEntity":{"type":"string"},"entityRegistrationNumber":{"type":"string"},"agentId":{"type":"string"},"agentWallet":{"type":"string"},"maxTxLimitUsd":{"type":"number"},"liabilityCoverageUsd":{"type":"number"},"validUntil":{"type":"integer"},"jurisdiction":{"type":"string"}}},"signature":{"type":"string"},"signerAddress":{"type":"string"}}}}}},"responses":{"200":{"description":"Mandate recorded"},"400":{"description":"Invalid mandate parameters"}}}},"/v1/kya/{chainId}/{agentId}":{"get":{"summary":"Retrieve active KYA corporate mandate for an agent","parameters":[{"name":"chainId","in":"path","required":true,"schema":{"type":"string"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"KYA corporate mandate record"},"404":{"description":"No mandate found"}}}}}}