# Settled – Live x402 Endpoint Discovery (Top 50 Ranked)

> Settled – Live x402 Endpoint Discovery (Top 50 Ranked) is a paid API for AI agents from settled.tools, 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 endpoints filtered by keyword, network, and max price, ordered by Settled quality score, to help agents find working alternatives to dead or overpriced endpoints.

## Facts

- Endpoint: GET https://settled.tools/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-live-x402-endpoint-discovery-top-50-ranked-49859caa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HtoBBlnFSIz3NzPDC1SUV

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-live-x402-endpoint-discovery-top-50-ranked-49859caa
```

Example prompt: Search Settled for live x402 endpoints related to 'weather', on the Base network (eip155:8453), priced under $0.01 per call, and show me the top 10 results ranked by quality score.

## When to prefer this

Use this endpoint when an agent needs to discover or switch to a live x402-compatible API, especially when a previously used endpoint is dead or over budget. Prefer this over manual endpoint registries or static lists when freshness and quality ranking matter. Best suited for agents operating in the x402 ecosystem that need dynamic endpoint selection based on network, price, or capability keyword.

## Known failure modes

- No results returned when keyword is too specific or no endpoints match filters
- Network filter uses incorrect CAIP-2 format causing empty result set
- max_price filter too low to match any live endpoints
- limit parameter outside 1–50 range may be rejected or clamped
- Payment of $0.005 USDC required per call via x402 — missing payment header causes 402 error

## 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 list of up to 50 live x402 endpoints, each with its URL, service name, description, tags, network, price per call, and Settled quality score — ordered from highest to lowest quality score based on liveness, metadata completeness, and pricing signals.

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "items": [
   {
    "url": "https://api.example.com/search",
    "tags": [
     "search"
    ],
    "status": "live",
    "network": "eip155:8453",
    "quality": 62,
    "price_usd": 0.01,
    "description": "Web search for agents",
    "service_name": "Example",
    "avg_latency_ms": 380
   }
  ],
  "generated_at": "2026-09-25T15:10:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/settled-live-x402-endpoint-discovery-top-50-ranked-49859caa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from settled.tools](https://www.zero.xyz/host/settled.tools/llms.txt)