Search x402 services
x402_search_servicesRead-only
Find x402 payment services matching your criteria by searching a directory of 500+ listed services. Filter by query, category, network, status, and signability, then sort results to identify candidates.
Instructions
Your first call when you do not know which x402 service exists for a job: it narrows a directory of 500+ listed services to candidates. Filter by free-text query, category, network, live status, and whether the last observed 402 envelope is signable by a standard x402 client; sort by newest, uptime, cheapest, or endpoints. Returns up to 100 compact summaries a page: price in decimal USD, uptime, status, verification. Then x402_get_service for the full record.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search across name, description, category, base_url. | |
| page | No | 1-based page index into the filtered result set (see meta.total_pages). | |
| sort | No | Server-side sort order. | newest |
| fields | No | Response detail: 'compact' (default) = lean summaries (identity, price, status, uptime, verification, networks, compliance grade), 'full' = every field including the per-service assessment block. Compact keeps a directory sweep small enough to not truncate. | compact |
| status | No | Filter by live monitoring status. | all |
| network | No | Network name or abbreviation, e.g. 'Base' or 'BSE'; any network code returned by /api/v1/networks is accepted. Omit for all. | |
| category | No | Exact category name (see categories context). Omit for all. | |
| per_page | No | Services per page, 1 to 100 (default 25). Higher values return larger results; with fields='full' a large page can be very heavy, so prefer compact when raising it. | |
| signable | No | Filter on the signability of the last observed 402 envelope: true = no EVM route of the service was observed missing the EIP-712 domain parameters (extra.name and extra.version) that a standard x402 client requires in order to sign a payment, false = at least one such route was observed. It describes the payment envelope on the wire, not the merit of the service. A service whose latest assessment has not measured that check yet matches NEITHER value, so omit this parameter to include it. Filtered server-side, so the result total covers the whole filtered set. | |
| verified_only | No | If true, return only verified services. Filtered server-side, so the result total covers the whole verified set, not just this page. |