Check an x402 endpoint
settled_checkFree: 25 calls/day per address, 300 with a payer record (free, keyed to your wallet), no daily cap with a pass. Check an x402 endpoint before paying it, from Settled’s index (cached up to 5 min): status, payability, latency, parsed price/network/payTo, payee on-chain history, the scout’s last real purchase, paying agents’ reports, seller claim, quality breakdown and risk flags, with a recommendation (pay, caution, avoid or unknown) and its reasons. Use when: deciding whether to call an endpoint, and for routine re-checks. Not for: a fresh probe right now (settled_preflight) or searching (settled_find_endpoints). If status is unknown, call settled_submit; after paying, call settled_report.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "settled_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Full URL of the x402 endpoint, e.g. https://api.example.com/search | |
| pass | No | Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header | |
| force | No | true to probe now instead of using the 5-minute cache; needs a pass | |
| 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 |
|---|---|---|---|
| url | No | The endpoint | |
| asset | No | Asset of the cheapest option | |
| 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 | |
| flags | No | Risk flags | |
| payee | No | Whether the payTo has on-chain history | |
| cached | No | Whether this came from Settled's 5-minute cache | |
| pay_to | No | The payTo Settled's probe sees; compare it with the quote you are about to pay | |
| scheme | No | Payment scheme, e.g. exact | |
| status | No | Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid | |
| network | No | Network of the cheapest option (CAIP-2) | |
| onchain | No | Settlements and unique payers over the last 30 days | |
| quality | No | Quality score breakdown | |
| reasons | No | Why, one line each; the first positive one is the scout's receipt when there is one | |
| reports | No | Paying agents' reports | |
| evidence | No | The grade of the evidence and the receipt line first: grade purchased (Settled paid this endpoint and compared what came back with the listing; receipt has the amount, day, bytes, listing verdict and Base transaction) or observed (live probes, payTo history and agent reports only; the scout buys and the ledger reads on Base, so an endpoint on another network is observed only) | |
| verifier | No | The verdict in the x402 Foundation Domain Discovery working group’s draft verifier schema: verdict (true|false|inconclusive), a reason code from its closed set, evidence (none|terms|probe|purchase; purchase_by verifier when Settled bought), the quote’s digest, and an attestation with the key URL, a signed record URL, the two domains compared, valid_until and the relationship disclosure; method_digest pins the method document (/verifier-method.md) | |
| price_usd | No | Price per call in USD (cheapest option) | |
| checked_at | No | When this answer was built | |
| first_seen | No | When Settled first saw it | |
| last_ok_at | No | When it last answered with a valid quote | |
| latency_ms | No | Latency of the latest probe | |
| payability | No | Payability verdict and the verb that pays | |
| 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) | |
| description | No | The listing's description | |
| network_name | No | Readable network name | |
| seller_claim | No | The seller's claim and profile, if claimed | |
| service_name | No | The listing's service name | |
| x402_version | No | x402 version of the quote | |
| last_probe_at | No | When Settled last probed it | |
| seller_alerts | No | Only when the caller's payer record is the claimed wallet: that seller's own Seller Watch alerts (down_now, new_24h, latest, feed) | |
| recommendation | No | pay, caution, avoid or unknown: avoid means money at risk (sanctioned or clone-farm payee, a purchase that did not deliver, a honeypot, agents' reports); caution includes an endpoint Settled could not get a quote from, which your own 402 outweighs (compare its payTo with pay_to); unknown means no quote on record and nothing against it | |
| delivery_receipt | No | The scout's last purchase, with its settlement transaction and checks (when the scout has bought it) | |
| http_status_last | No | HTTP status of the latest probe | |
| last_delivery_at | No | When the scout last bought it | |
| delivery_verified | No | Whether a real payment by Settled's scout came back with content |