# Settled x402 Endpoint Discovery

> Settled x402 Endpoint Discovery is a paid API for AI agents from settled.justinedwardvolmer.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Returns a ranked list of up to 50 live x402 pay-per-call endpoints filtered by keyword, network, and max price, ordered by Settled quality score

## Facts

- Endpoint: GET https://settled.justinedwardvolmer.workers.dev/v1/endpoints?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/settled-x402-endpoint-discovery-46e69076
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xmXjTJdwLHAqPuCCHx8BL

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 settled-x402-endpoint-discovery-46e69076
```

Example prompt: Find me the top live x402 endpoints related to 'image generation' on the Base network (eip155:8453) that cost no more than $0.01 per call — show me up to 20 results ranked by quality.

## When to prefer this

Choose this endpoint when an agent needs to dynamically discover live, priced x402 APIs at runtime — especially when an existing endpoint has gone dead or become too expensive and a replacement is needed. Prefer this over static API directories when you need real-time liveness signals and quality ranking specific to the x402 micropayment ecosystem.

## Known failure modes

- No results returned if keyword matches no live endpoints
- Network filter mismatch returns empty list if CAIP-2 identifier is malformed
- max_price set too low may return zero results
- limit out of 1–50 range may cause validation error
- Endpoint may return stale data if liveness cache has not refreshed within 5 minutes

## How this service works

Ranked list of live x402 endpoints (top 50) filtered by keyword, network and max price, ordered by Settled quality score. Use it to find a working alternative to a dead or overpriced endpoint.

## Output

A ranked JSON list of up to 50 live x402 endpoints, each including the endpoint URL, service name, description, tags, network, price per call (USD), and Settled quality score. Results are filtered by keyword match against URL/description/name/tags, network, and max price, and ordered by descending quality score.

## 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",
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword matched against URL, description, service name and tags"
      },
      "limit": {
       "type": "string",
       "description": "1–50, default 20"
      },
      "network": {
       "type": "string",
       "description": "CAIP-2 network filter, e.g. eip155:8453"
      },
      "max_price": {
       "type": "string",
       "description": "Maximum USD price per call"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/settled-x402-endpoint-discovery-46e69076/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from settled.justinedwardvolmer.workers.dev](https://www.zero.xyz/host/settled.justinedwardvolmer.workers.dev/llms.txt)