Find better alternatives to an x402 endpoint
Find better alternatives to an x402 endpoint. Given a resource URL, returns the top semantically-similar endpoints (matched on advertised purpose via description embeddings) that currently OUT-SCORE it on our deterministic trust score — so an agent about to pay a mediocre endpoint can discover a more reliable, better-settled one serving the same function. Each result carries its trust score, grade, cosine similarity, advertised price and free endpoint-page URL. The price fields stay machine-readable: amountUsd is always the raw advertised amount, and the separate boolean priceCeiling is true when the endpoint uses the x402 'upto' scheme, i.e. amountUsd is an authorization ceiling and the real charge is typically lower. Same-host siblings and 'avoid'-flagged endpoints are excluded. Returns an empty list (still a valid answer) when nothing beats the subject.
Provider
x402-trust.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xbBECBE90F28632a9d52ed67b33b43767b8c89285",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 120
}
]Output schema
{
"bazaar": {
"category": "data",
"discoverable": true,
"info": {
"input": {
"body": {
"limit": 5,
"resource": "https://api.example.com/v1/thing"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"alternatives": [
{
"amountUsd": 0.001,
"endpointPage": "https://x402-trust.com/endpoint/12345",
"grade": "A",
"network": "eip155:8453",
"priceCeiling": false,
"recommendation": "proceed",
"resource": "https://api.better.com/v1/thing",
"score": 88.1,
"similarity": 0.912
}
],
"count": 2,
"note": "Semantically similar endpoints that out-score the subject. Similarity is cosine over description embeddings.",
"resource": "https://api.example.com/v1/thing",
"subject": {
"grade": "C",
"inObservationSet": true,
"score": 61.2,
"vectorized": true
}
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"limit": {
"type": "integer"
},
"resource": {
"type": "string"
}
},
"required": [
"resource",
"limit"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
]
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD"
]
},
"type": {
"const": "http"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"alternatives": {
"items": {
"properties": {
"amountUsd": {
"type": "number"
},
"endpointPage": {
"type": "string"
},
"grade": {
"type": "string"
},
"network": {
"type": "string"
},
"priceCeiling": {
"type": "boolean"
},
"recommendation": {
"type": "string"
},
"resource": {
"type": "string"
},
"score": {
"type": "number"
},
"similarity": {
"type": "number"
}
},
"required": [
"resource",
"score",
"grade",
"recommendation",
"similarity",
"amountUsd",
"priceCeiling",
"network",
"endpointPage"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"note": {
"type": "string"
},
"resource": {
"type": "string"
},
"subject": {
"properties": {
"grade": {
"type": "string"
},
"inObservationSet": {
"type": "boolean"
},
"score": {
"type": "number"
},
"vectorized": {
"type": "boolean"
}
},
"required": [
"score",
"grade",
"inObservationSet",
"vectorized"
],
"type": "object"
}
},
"required": [
"resource",
"subject",
"count",
"alternatives",
"note"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
},
"tags": [
"x402",
"similar",
"discovery",
"routing",
"score"
]
}
}Use it
curl
curl "https://x402-trust.com/v1/similar" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://x402-trust.com/v1/similar");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402-trust.com/v1/similar")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/7067.json, and this resource appears in /discovery/resources and /discovery/search.