Search x402 resources
Searches for active x402 resources using a text query and optional filters.
Supports both text-based and vector-based search depending on availability. Results are sorted by relevance and quality score.
Legacy network names (e.g., base, base-sepolia, solana) are automatically normalized to their CAIP-2 equivalents.
The response is limited to 20 items per request. If more results exist, partialResults will be true.
Query Parameters
Full-text or semantic search query to find matching resources.
400"weather forecast"
Filter results by network in CAIP-2 format (e.g., eip155:8453) or legacy name (e.g., base, base-sepolia, solana).
Legacy names are normalized to their CAIP-2 equivalents before filtering.
"eip155:8453"
Filter results by asset address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address. Matching is case-insensitive.
"0x036CbD53842c5426634e7929541eC2318f3dCF7e"
Filter results by payment scheme (e.g., exact).
"exact"
Filter results by the merchant's payment address. For EVM networks, provide a 0x-prefixed EVM address. For Solana networks, provide a base58-encoded address. A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).
1 - 128"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
Filter results to resources whose URL contains this value (case-insensitive substring match against the resource URL).
Useful for narrowing results to a specific domain, subdomain, or path segment. Combine with query to perform semantic search restricted to a URL subset.
Tip: include enough of the URL to disambiguate (e.g. api.example.com rather than example) — a short substring may also match resources whose path contains the same string.
3 - 2048"api.example.com"
Filter results to resources with a USD price at or below this value.
"1.00"
Filter results to resources that support the specified protocol extensions. Can be specified multiple times to filter by multiple extensions.
Maximum number of resources to return. Must be a positive integer no greater than 20. Defaults to 20.
1 <= x <= 20Response
Successfully retrieved matching x402 resources.
Response from a search for x402 resources.
List of x402 resources matching the search query and filters.
Indicates whether the result set was truncated because there were more results than the requested limit.
false
The version of the x402 protocol.
1, 2 2
The search method used to retrieve the results (e.g., "text", "vector", "hybrid").
text, vector, hybrid "text"