Peek at an endpoint
settled_peekFree, rate-limited. Coarse status and quality score for one x402 endpoint URL, from the index only (no fresh probe). Use when: you only need a quick yes/no on whether Settled knows the URL and its last status. Not for: deciding whether to pay — use settled_check (free, fuller) or settled_preflight (paid, fresh). If the URL is unknown, call settled_submit, then check again later.
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_peek"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Full URL of the x402 endpoint, e.g. https://api.example.com/search |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The endpoint | |
| 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 | |
| detail | No | Where to get the full check | |
| status | No | Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid | |
| quality | No | Quality score 0-100 | |
| 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) | |
| last_probe_at | No | When Settled last probed it | |
| seller_claimed | No | Whether the seller has claimed it |