# x402 Service Finder

> x402 Service Finder is a paid API for AI agents from tvy64m9w0dfvxmkq.68r.lambda-web.us-east-1.on.aws, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Search and rank x402 API sellers from the CDP Bazaar by relevance, payer count, uptime, and price for a given task description

## Facts

- Endpoint: GET https://tvy64m9w0dfvxmkq.68r.lambda-web.us-east-1.on.aws/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-e201f3ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VHOxW-x_XHhPXtCCOQrYX

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-e201f3ec
```

Example prompt: Search the x402 Bazaar for APIs that can remove the background from a photo — show me the top 5 results ranked by payer count and uptime, and only include ones that cost less than $0.005 per call.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover and select the best x402-compatible API for a specific task at runtime, especially when comparing multiple sellers by trustworthiness signals (payer count, uptime) and cost. Prefer this over hardcoding a specific x402 seller URL when the optimal provider may change over time or when you want to filter by price ceiling or minimum adoption threshold.

## Known failure modes

- No matching sellers found for the task description — results array is empty
- task parameter missing — request fails with validation error
- max_price_usd or min_payers filters too restrictive — all candidates excluded
- Payment not included or incorrect — 402 Payment Required response returned
- Lambda cold start may add latency on first call
- Uptime data unavailable for new sellers — uptime_30d returned as null

## 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 object containing the original task string, a ranked list of matching x402 API sellers (each with resource URL, relevance score, description, price in USD, 30-day payer count, 30-day call count, uptime percentage, median latency in ms, and example call instructions), a human-readable explanation of the scoring formula, a breakdown of excluded listings by reason, and the total number of Bazaar listings considered.

## 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-e201f3ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tvy64m9w0dfvxmkq.68r.lambda-web.us-east-1.on.aws](https://www.zero.xyz/host/tvy64m9w0dfvxmkq.68r.lambda-web.us-east-1.on.aws/llms.txt)