---
title: "Find better-scored alternatives to an x402 endpoint"
method: POST
path: "/v1/similar"
---

# Find better-scored alternatives to an x402 endpoint

`POST /v1/similar`

## Request

- Base URL: `https://x402-trust.com`
- URL: `https://x402-trust.com/v1/similar`
- Auth: none declared

Semantically similar endpoints that currently out-score a given one, for routing away from a mediocre endpoint toward a more reliable one serving the same function. Same-host siblings and avoid-flagged endpoints are excluded; an empty list means nothing beats the subject.

## Request body

- object
  - `resource` string, required: Full x402 resource URL (https://...) as listed in discovery.
  - `limit` number: Max alternatives to return (1-25, default 5).
  - `minScoreDelta` number: Minimum trust-score advantage an alternative must have over the subject (default 5).

## Response `200`

Successful response

- object
  - `resource` string: Echoed subject resource URL.
  - `subject` object: Subject's own score/grade + observation status.
  - `count` number: Number of alternatives returned.
  - `alternatives` object: Ranked array: resource, score, grade, recommendation, similarity, amountUsd, network, endpointPage.

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/x402-trust/apis/x402-trust-trust-reliability-data-for-the-x402-ecosystem.md) · [All operations](https://skmtc.dev/x402-trust/apis/x402-trust-trust-reliability-data-for-the-x402-ecosystem/llms.txt) · [OpenAPI document](https://skmtc.dev/x402-trust/apis/x402-trust-trust-reliability-data-for-the-x402-ecosystem/revisions/2a53d895d466?raw)