Ontario Protocol Buyer API

{"components":{"schemas":{"AgentCanPayDecision":{"properties":{"agent_policy":{"type":"string"},"auditable_paid_continuation":{"additionalProperties":true,"description":"Optional 0.002 USDC receipt path. It is recommended only after an allow decision and an explicit require_audit_receipt request.","type":"object"},"decision":{"enum":["allow","review","deny"],"type":"string"},"declared_price_usdc":{"nullable":true,"type":"number"},"endpoint":{"type":"string"},"max_usdc":{"nullable":true,"type":"number"},"reason":{"type":"string"},"reasons":{"items":{"type":"string"},"type":"array"},"recommendations":{"items":{"type":"object"},"type":"array"},"report":{"$ref":"#/components/schemas/VerificationSummary"},"report_integrity_ok":{"type":"boolean"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"},"ReportIntegrity":{"properties":{"algorithm":{"type":"string"},"canonical_sha256":{"type":"string"},"canonicalization":{"type":"string"},"key_id":{"type":"string"},"public_key":{"type":"string"},"signature":{"type":"string"},"signed_by":{"type":"string"}},"type":"object"},"VerificationSummary":{"properties":{"grade":{"type":"string"},"normalized_base":{"type":"string"},"readiness_score":{"type":"integer"},"report_id":{"type":"string"},"report_url":{"type":"string"},"target_url":{"type":"string"},"verified_at":{"type":"string"}},"type":"object"},"X402ReadinessReport":{"properties":{"base_readiness_score":{"type":"integer"},"buyer_conversion_next_step":{"additionalProperties":true,"description":"Unsigned handoff from endpoint readiness to the free end-to-end buyer-path diagnostic. A public buyer job is required before any repair is recommended.","properties":{"commercial_boundary":{"type":"string"},"free_diagnostic":{"additionalProperties":true,"type":"object"},"recommended_action":{"additionalProperties":true,"type":"object"},"schema":{"enum":["ontario.buyer_conversion_next_step.v1"],"type":"string"},"signed_evidence_boundary":{"type":"string"},"status":{"enum":["buyer_job_required"],"type":"string"}},"type":"object"},"evidence":{"type":"object"},"grade":{"enum":["ready","close","needs_work"],"type":"string"},"integrity":{"$ref":"#/components/schemas/ReportIntegrity"},"max_score":{"type":"integer"},"normalized_base":{"type":"string"},"provider_listing_next_step":{"additionalProperties":true,"description":"Unsigned grade-aware commercial handoff from free readiness evidence to free listing validation and the optional 0.50 USDC provider publication.","properties":{"free_validation":{"additionalProperties":true,"type":"object"},"publication":{"additionalProperties":true,"properties":{"asset":{"type":"string"},"listing_page":{"format":"uri","type":"string"},"method":{"enum":["POST"],"type":"string"},"network":{"enum":["eip155:8453"],"type":"string"},"price_usdc":{"enum":["0.50"],"type":"string"},"url":{"format":"uri","type":"string"},"value":{"type":"string"}},"type":"object"},"ready_for_listing_preflight":{"type":"boolean"},"recommended_action":{"additionalProperties":true,"type":"object"},"schema":{"enum":["ontario.provider_listing_next_step.v1"],"type":"string"},"sequence":{"items":{"type":"string"},"type":"array"},"signed_evidence_boundary":{"type":"string"},"status":{"enum":["ready_for_free_listing_validation","fix_before_listing"],"type":"string"},"trust_boundary":{"type":"string"}},"type":"object"},"readiness_score":{"type":"integer"},"recommendations":{"items":{"properties":{"detail":{"type":"string"},"docs_url":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"report_id":{"type":"string"},"report_url":{"type":"string"},"signals":{"type":"object"},"status":{"type":"string"},"target_url":{"type":"string"},"verifier":{"type":"string"},"warning_penalty":{"type":"integer"},"warnings":{"items":{"properties":{"detail":{"type":"string"},"docs_url":{"type":"string"},"id":{"type":"string"},"severity":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"info":{"contact":{"email":"hello@ontarioprotocol.com"},"description":"Ontario Protocol's x402 API for autonomous agents, wallets, MCP hosts and paid-API registries: a live x402 API finder, paid Base wallet-balance, transaction-check and gas reads, free x402 readiness and can-pay checks, task-to-tool routing, settlement classification and service publication. Existing paid provider profiles can refresh their readiness evidence without editing metadata or buying a better grade.","license":{"name":"MIT"},"title":"Ontario Protocol Buyer API","version":"1.0.0","x-guidance":"Ontario Protocol sells a live x402 API finder and three first-party Base reads. POST /api/x402/find-api (0.005 USDC) returns up to 5 paid x402 APIs for one task that answered a fresh unpaid probe with a valid Base USDC 402, ranked by task fit, price and Bazaar-reported repeat buyers; no live match, no charge. GET /api/x402/base/balances (0.002 USDC), GET /api/x402/base/tx-check (0.002 USDC) and GET /api/x402/base/gas (0.0015 USDC) read live Base mainnet data; a failed read or a transaction that is not found is not charged. Free routes verify an x402 endpoint before payment (POST /api/verify/x402-readiness), evaluate a can-pay policy (POST /api/agent/can-pay) and route a task to a tool (POST /api/agent/tool-quote). Other paid routes publish an agent or paid API listing and refresh paid profile evidence. Every paid route answers an unsigned request with an HTTP 402 challenge that states its price, network, asset and payTo.","x-ontario":{"buyer_catalog":{"free_preflight":"https://ontarioprotocol.com/.well-known/agent-buyer.json","full_openapi":"https://ontarioprotocol.com/openapi-full.json","payment_policy":"https://ontarioprotocol.com/.well-known/agent-payment-policy.json","selection_rule":"Each paid operation carries x-payment-info with its fixed USD price. An unsigned request returns the HTTP 402 challenge with price, network, asset and payTo. POST /api/agent/tool-quote, readiness and can-pay are free.","trust_boundary":"Readiness evidence does not guarantee safety, service quality, financial outcome, independent demand, or future behavior."},"trust_methodology":{"trust_standard":"https://ontarioprotocol.com/trust","what_ontario_checks":"https://ontarioprotocol.com/trust/what-ontario-checks","what_ontario_does_not_check":"https://ontarioprotocol.com/trust/what-ontario-does-not-check"}}},"openapi":"3.0.1","paths":{}}