# x402 Service Finder

> x402 Service Finder is a paid API for AI agents from finder.kagurazaka.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Searches the CDP Bazaar for x402-compatible API sellers matching a plain-language task description, ranked by relevance, buyer count, uptime, and price.

## Facts

- Endpoint: GET https://finder.kagurazaka.dev/v1/find?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-service-finder-6bb75941
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l6oTAYPyH6lxthpDOzSP1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-service-finder-6bb75941
```

Example prompt: Search the x402 Bazaar for sellers that can remove the background from a photo — show me up to 5 results, only include sellers with at least 3 distinct buyers in the last 30 days, and filter out anything over $0.005 per call.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover the best x402-compatible API for a task at runtime, especially when comparing multiple sellers on trust signals (buyer count, uptime) and price. Prefer this over hardcoding a specific x402 seller URL when the optimal provider may change over time or when the task domain isn't known in advance.

## Known failure modes

- No matching sellers found for the task description — returns empty results array
- Task string is too long (over 300 characters) — schema validation error
- limit out of range (must be 1–10) — validation error
- min_payers or max_price_usd filters too strict — returns empty results with exclusion counts
- Bazaar data temporarily stale or unavailable — may return degraded or cached results

## How this service works

Find the best x402 API for a task. Describe what you need (for example "remove the background from a photo") and get the matching sellers from the CDP Bazaar ranked by relevance, how many distinct buyers paid them in 30 days, their uptime measured by our monitor every 6 hours, and price. Each result has its price, payers, uptime, median latency and how to call it (method and example input).

## Output

A JSON array of matching x402 sellers sorted by composite score, each including the seller's resource URL, score, description, price in USD, number of distinct payers in the past 30 days, call volume, uptime percentage, median latency in milliseconds, how to call the seller (HTTP method and example input), and per-dimension score breakdown. Also returns metadata: how many total listings were considered, how the score was computed, and how many were excluded and why.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "task"
     ],
     "properties": {
      "task": {
       "type": "string",
       "maxLength": 300,
       "description": "what you need done, in plain words"
      },
      "limit": {
       "type": "integer",
       "description": "how many results to return (1-10, default 5)"
      },
      "min_payers": {
       "type": "integer",
       "description": "leave out sellers with fewer distinct payers in 30 days"
      },
      "max_price_usd": {
       "type": "number",
       "description": "leave out sellers that charge more per call"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "task",
      "results"
     ],
     "properties": {
      "task": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "description": "best first: resource, score, description, price_usd, payers_30d, calls_30d, uptime_30d (null when not measured), median_ms, how_to_call, score_parts"
      },
      "scoring": {
       "type": "string",
       "description": "how the score is computed"
      },
      "excluded": {
       "type": "object",
       "description": "listings left out, by reason"
      },
      "considered": {
       "type": "integer",
       "description": "how many Bazaar listings matched the task"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "remove the background from a photo",
  "results": [
   {
    "score": 0.83,
    "resource": "https://seller.example/api/remove-background",
    "calls_30d": 12,
    "median_ms": 210,
    "price_usd": 0.001,
    "payers_30d": 7,
    "uptime_30d": 1,
    "description": "Remove the background from an image URL and return a transparent PNG URL.",
    "how_to_call": {
     "method": "POST",
     "example": {
      "imageUrl": "https://example.com/cat.png"
     }
    },
    "score_parts": {
     "price": 1,
     "payers": 1,
     "uptime": 1,
     "relevance": 1
    },
    "last_called_at": "2026-10-20T08:00:00Z"
   }
  ],
  "scoring": "score = 0.3 × relevance + 0.3 × payers + 0.25 × uptime + 0.15 × price ...",
  "excluded": {
   "above max_price_usd": 3
  },
  "considered": 18
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-service-finder-6bb75941/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finder.kagurazaka.dev](https://www.zero.xyz/host/finder.kagurazaka.dev/llms.txt)