DEVELOPER GUIDE

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/watchlist

Use 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=canlis

An 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

StatusMeaning
200Dated observation returned, or a free endpoint succeeded.
400Missing or unsupported site. A bare discovery probe is supported without payment signing.
402A valid x402 payment is required. Inspect the header; no payment is sent merely by receiving it.
422No recognized provider evidence. No payment is requested.
503Observation 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.