Small requests.
Explicit evidence.
Buy one dated provider observation for one supported site. You control payment signing in your own compatible x402 client.
For a manual browser-wallet test, use the single-purchase checkout. It checks the exact charge and shows the result and settlement receipt.
1. Check coverage
GET /v1/watchlistUse a supported id whose purchase_available is true. Availability changes as observations age and collection succeeds or fails.
2. Request an observation
GET /v1/providers?site=canlisAn unpaid eligible request receives HTTP 402 with a PAYMENT-REQUIRED header. It specifies $0.05 USDC (50,000 atomic units) on Base, chain identifier eip155:8453. Inspect the challenge before authorizing anything.
Your x402-compatible client signs the requested payment and retries with PAYMENT-SIGNATURE. A normal browser visit or plain curl command does not complete payment. SignalWharf never asks you to enter a seed phrase or private key on this website.
3. Read the result
A successful result includes observation (provider URLs, source, timestamp, method), latest_collection (including recent failure), freshness, change_candidates, and caveats. The free real sample shows the current response shape.
Responses
| Status | Meaning |
|---|---|
| 200 | Dated observation returned, or a free endpoint succeeded. |
| 400 | Missing or unsupported site. A bare discovery probe is supported without payment signing. |
| 402 | A valid x402 payment is required. Inspect the header; no payment is sent merely by receiving it. |
| 422 | No recognized provider evidence. No payment is requested. |
| 503 | Observation missing, older than 48 hours, or service unavailable. Data availability is checked before the payment step. |
Evidence and limitations
Matches come from recognized provider hostnames in public homepage link, form, script, or iframe URLs. Gift-only paths, script text, comments, inert templates, and lookalike hostnames are excluded. Query strings and fragments are omitted from saved URL evidence. Raw pages are not retained; hashes identify content but cannot reconstruct it.
A provider URL is not verification of a contract, actual booking availability, or a completed vendor switch. A failed collection preserves the prior successful observation and reports the new error. Unverified candidates are supplied for review.
Machine references
OpenAPI · Agent instructions · x402 discovery · Service status
Questions or failed fulfillment? Contact signalwharf@gmail.com with the endpoint, approximate time, and transaction hash if applicable. Do not send wallet secrets.