{"openapi":"3.1.0","info":{"title":"Veyra Trust API on Arc","version":"1.0.0","description":"Veyra checks x402 sellers before an agent pays them. These routes are paid per call with x402 v2, in USDC on Arc mainnet (eip155:5042), through Circle Gateway. A request without payment is answered 402, with the price and payment terms in the PAYMENT-REQUIRED header. A GET is answered with the same 402 and is never charged: the answer takes a POST. Pay by sending the signed payment in the PAYMENT-SIGNATURE header. A request that cannot be served is refused before any payment is taken. What Veyra says about a seller is its own claim, not independent truth."},"servers":[{"url":"https://agent-commerce-six.vercel.app"}],"paths":{"/api/x402/v1/arc/history":{"post":{"operationId":"arc_history","summary":"Everything Veyra has observed of an endpoint: latency and price distributions, payee changes, uptime.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","description":"The x402 resource URL to assess."},"method":{"type":"string","enum":["GET","POST"],"description":"HTTP method the resource is called with. Defaults to POST."}},"required":["resource"]}}}},"responses":{"200":{"description":"The answer, after the payment settled.","content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string"},"resourceKey":{"type":"string"},"method":{"type":"string"},"observations":{"type":"number","description":"How many times Veyra has measured this endpoint."},"firstObservedAt":{"type":["string","null"]},"lastObservedAt":{"type":["string","null"]},"statisticalEvidenceAvailable":{"type":"boolean","description":"False below ten observations, where the quality engine refuses to score."},"availability":{"type":"object"},"latencyMs":{"type":"object"}},"required":["resource","resourceKey","observations","statisticalEvidenceAvailable"]}}}},"400":{"description":"The request was refused. No payment was taken."},"402":{"description":"Payment required: 0.005 USDC on Arc mainnet through Circle Gateway. The terms are in the PAYMENT-REQUIRED header."},"503":{"description":"Veyra cannot take payment or answer right now. Nothing was charged."}},"x-payment-info":{"protocol":"x402","x402Version":2,"network":"eip155:5042","asset":"USDC","priceUsdc":0.005,"settledBy":"Circle Gateway"}}},"/api/x402/v1/arc/select":{"post":{"operationId":"arc_select","summary":"Discover, probe and rank counterparties for a capability. On Arc mainnet, no clearance is signed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capability":{"type":"string","description":"What the agent needs done, e.g. web_research."},"budgetUsdc":{"type":"number","description":"Ceiling for the purchase this selection leads to."},"maxPriceUsdc":{"type":"number","description":"Refuse candidates above this price."},"network":{"type":"string","description":"Where the counterparty is paid. Defaults to Arc mainnet (eip155:5042)."}},"required":["capability","budgetUsdc"]}}}},"responses":{"200":{"description":"The answer, after the payment settled.","content":{"application/json":{"schema":{"type":"object","properties":{"selection":{"type":"object","properties":{"selectionId":{"type":"string"},"network":{"type":"string","description":"Where the sellers are paid, as CAIP-2."},"candidates":{"type":"array","description":"Every seller probed, ranked, with its trust decision and evidence."},"recommendation":{"type":"object","description":"The seller to buy from, or why there is none.","properties":{"granted":{"type":"boolean","description":"True only when a clearance was signed."},"reason":{"type":"string"},"candidateId":{"type":["string","null"]},"resource":{"type":["string","null"]},"payTo":{"type":["string","null"]},"priceUsdc":{"type":["number","null"]},"decision":{"type":["string","null"],"description":"The recommended seller's trust decision, such as ALLOW_WITH_LIMITS."},"maxExposureUsdc":{"type":"number"}},"required":["granted","reason","candidateId","decision","maxExposureUsdc"]},"clearance":{"type":["object","null"],"description":"The signed EIP-712 clearance, or null when none was signed."},"expiresAt":{"type":"string"}},"required":["selectionId","network","candidates","recommendation","clearance","expiresAt"]},"note":{"type":"string","description":"Why no clearance was signed, when none was."}},"required":["selection"]}}}},"400":{"description":"The request was refused. No payment was taken."},"402":{"description":"Payment required: 0.02 USDC on Arc mainnet through Circle Gateway. The terms are in the PAYMENT-REQUIRED header."},"503":{"description":"Veyra cannot take payment or answer right now. Nothing was charged."}},"x-payment-info":{"protocol":"x402","x402Version":2,"network":"eip155:5042","asset":"USDC","priceUsdc":0.02,"settledBy":"Circle Gateway"}}}}}