V1 Semantic Search

x402.fuchss.app · Data Lookup

Semantic search across the entire monitored x402 catalog. Given a free-text query (e.g. "weather forecast", "image generation", "EVM gas price oracle"), returns the closest endpoints by advertised purpose. Ranking is deterministic: cosine similarity bucketed to whole percentage points first (80.3% and 80.5% are the same bucket), then trust score, then described-before-undescribed, then endpoint id. Matches below a 0.5 cosine-similarity floor are dropped entirely, so a query can return fewer than the requested limit (or none). Endpoints that advertise no description are still matched: they are embedded from their service name and URL path tokens instead of a written description (host name as a last resort). The exact effect of a missing description: no fixed point deduction and no direct similarity malus; the only deterministic penalty is the described-before-undescribed tiebreak (at equal similarity bucket AND equal trust score, a described endpoint ranks first). Beyond that it is purely indirect: the shorter fallback text typically yields lower cosine similarity than a prose description, so such endpoints tend to land in lower similarity buckets, by a query-dependent amount. Each match carries its resource URL, trust score, grade, cosine similarity (0-1, raw value; ranking buckets it), advertised description when present, and a free endpoint-page URL. This is a DISCOVERY product: it deliberately carries no verdict, recommendation or flag detail (the per-endpoint trust report sold at /v1/x402-trust carries those). The query is embedded with the same model as the catalog, so phrasing the capability you need works better than guessing keywords.

• data-lookup
• payment-native
• x402-exact