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.
Filter results to resources published with any of the specified provider tags (case-sensitive exact match). Can be specified multiple times to filter by multiple tags; a resource matches if it carries at least one of the supplied tags (OR).
5Filter results to resources that belong to any of the specified curated bundles (by bundle slug). Can be specified multiple times to filter by multiple bundles; a resource matches if it belongs to at least one of the supplied bundles (OR).
564^[a-z0-9]+(?:-[a-z0-9]+)*$When true, restrict results to Coinbase-curated resources (those with curated: true). On this HTTP REST endpoint, the field defaults to false, so omitting it returns both curated and non-curated resources. On the Bazaar MCP search_resources tool, the field defaults to true when curation is enabled; pass false to include non-curated resources.
true
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"