Find live x402 endpoints
settled_find_endpointsFree up to 50 calls/day per client (a pass allows 1,000). Live endpoints matching every word of q (in the URL, name, tags or description), best match first, then by quality, price, latency or payers; filter by network and max price; each with payability and delivery verification. Use when: you need an x402 endpoint for a capability and want candidates that are live, payable and, where possible, proven to deliver. Not for: verifying one known URL (settled_check). After: run settled_check or settled_preflight on the one you pick before paying.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "settled_find_endpoints"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | One to four words every result must match in its URL, name, tags or description, e.g. weather forecast or gift cards; filler words (api, x402, endpoint) are ignored | |
| pass | No | Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header | |
| sort | No | Order of results: quality (default), price, latency or payers | |
| limit | No | How many endpoints to return, 1-50 (default 20) | |
| status | No | Only endpoints with this status; live (default) or any for every status | |
| network | No | Only endpoints on this network, as a CAIP-2 id, e.g. eip155:8453 for Base | |
| max_price | No | Highest price per call in USD, e.g. 0.01 | |
| payer_token | No | A Settled payer token (x4t_…, from POST /x401/token with your payer record): the free tier then follows your wallet, 300 a day, through any gateway |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of endpoints returned | |
| error | No | Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it | |
| items | No | Ranked endpoints, each with payability and delivery status | |
| filters | No | The filters applied | |
| attestation | No | EIP-191 signature over the answer; verify it with settled_verify or any EVM library | |
| attested_at | No | When Settled signed this answer (ISO 8601) | |
| generated_at | No | When this list was built |