Search the public x402 index
search_x402Read-onlyIdempotent
Find any pay-per-call x402 endpoint on the internet — the public x402 index (~15,000 priced endpoints from hundreds of hosts), not only FiatDock's own marketplace. Ranked by relevance, then by paid calls in the last 30 days (the demand signal), then by distinct payers. Each row carries the URL, the price the index recorded, the network, where the money goes, and the 30-day call/payer counts; call_x402 then reads the endpoint's own 402 and pays it directly from your wallet — FiatDock takes no fee and never touches the money. Read-only, free. Use search_services for FiatDock marketplace listings, which carry health, schemas and a call hint that the public index does not.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search over host, service name, tags, description and URL path. Multi-word queries are SCORED: a row must carry at least half your words, except that the single best match always survives | |
| sort | No | demand (default: relevance, then 30-day calls), price (cheapest first), recent (last paid call first) | |
| limit | No | Rows to return, 1-50 (default 20). Bounded because the result lands in your context; narrow with q, maxPriceUsd or network before raising it | |
| network | No | Only this CAIP-2 network, e.g. eip155:8453 (Base) | |
| maxPriceUsd | No | Only endpoints whose indexed price is at or below this (USDC, 6 decimals) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Present only when truncated: how to reach the rest | |
| count | Yes | Rows RETURNED — never more than the limit | |
| stale | Yes | True when the snapshot is more than three hours old (it is still served) | |
| total | Yes | Rows that matched before the limit | |
| source | Yes | The public index this was read from | |
| results | Yes | Matching endpoints, best first: relevance, then 30-day calls, then payers, then price | |
| indexedAt | Yes | When this snapshot of the public index was read | |
| truncated | Yes | True when the list was cut. Never conclude the index is small from a truncated answer |