Ontario Protocol x402 API Finder

{
  "example": {
    "task": "web search for an AI agent",
    "count": 1,
    "funnel": {
      "live": 1,
      "probed": 4,
      "ranked": 7,
      "skipped": {
        "write_route": 1,
        "host_probe_cap": 3,
        "opted_out_host": 0,
        "endpoint_template": 2,
        "ontario_first_party": 0
      },
      "discarded": {
        "unreachable": 1,
        "no_payment_challenge": 2
      },
      "marketplace_candidates": 12
    },
    "method": "Candidates come from Ontario's copy of the Coinbase CDP Bazaar catalog (Base USDC listings settled in the last 30 days; index_as_of gives its age). When that copy is missing, older than 12 hours or has too few matches, live Coinbase CDP Bazaar, Agentic Market and Ontario ready-catalog searches are used. Candidates are ranked by task fit, price and repeat buyers (calls beyond unique payers), then probed unpaid: at most 2 per host, 3 s connect and read timeouts, observations reused up to 10 minutes. Write and money-moving routes and hosts that opted out are skipped, not probed. Only valid Base USDC x402 challenges within budget are returned. Ontario's own paid routes are excluded.",
    "schema": "ontario.x402_api_finder.v1",
    "status": "ok",
    "filters": {
      "asset": "USDC",
      "limit": 3,
      "network": "eip155:8453",
      "max_usdc": "0.01"
    },
    "results": [
      {
        "rank": 1,
        "method": "POST",
        "endpoint": "https://search.example.com/v1/web/search",
        "live_check": {
          "cached": false,
          "pay_to": "0x1234567890AbcdEF1234567890aBcdef12345678",
          "status": "live_matches_listing",
          "network": "eip155:8453",
          "checked_at": "2026-10-25T09:14:03Z",
          "latency_ms": 312,
          "http_status": 402,
          "price_drift": "0",
          "x402_version": 2,
          "live_price_usdc": "0.005",
          "listed_price_usdc": "0.005",
          "payto_matches_listing": true
        },
        "price_usdc": "0.005",
        "rank_score": 118.787,
        "description": "Live web search for AI agents: ranked results with title, URL, snippet, publish date and source, with automatic provider failover.",
        "how_to_call": {
          "url": "https://search.example.com/v1/web/search",
          "json": {
            "query": "x402 facilitator fees",
            "max_results": 5
          },
          "method": "POST",
          "payment": {
            "flow": "x402 exact: an unpaid request returns PAYMENT-REQUIRED; the retry carries the signed accepts entry in PAYMENT-SIGNATURE.",
            "asset": "USDC",
            "pay_to": "0x1234567890AbcdEF1234567890aBcdef12345678",
            "scheme": "exact",
            "network": "eip155:8453",
            "amount_usdc": "0.005"
          }
        },
        "buyer_signal": {
          "basis": "Source-reported 30-day marketplace counters; payers are wallets, not verified customers.",
          "label": "repeat_buyers",
          "score": 22.878,
          "calls_30d": 602,
          "payers_30d": 11,
          "calls_per_payer": 54.73
        },
        "service_name": "search.example.com",
        "task_relevance": 1,
        "source_marketplaces": [
          "Agentic Market",
          "Coinbase CDP Bazaar"
        ]
      }
    ],
    "index_as_of": "2026-10-25T06:00:04Z",
    "index_status": "ok",
    "ranking_method": "deterministic",
    "trust_boundary": "A live challenge shows the endpoint is up and payable now. It does not prove the paid response is correct, safe or fit for the task. Marketplace counters are source-reported. Provider calls are paid separately, under the caller's own spend policy.",
    "candidate_source": "finder_index"
  }
}