Agent Readiness Check
Does your x402 endpoint return a challenge buyers can read?
If an unpaid request to your paid API does not come back as HTTP 402 with a parseable x402 challenge, agents cannot pay you and directories cannot list you. This test makes that unpaid request from outside your network and tells you what a buyer sees.
Run it
GET https://trademypage.com/check.php?domain=your-api.com&probe=/your/paid/path
Price: 0.01 USDC on Solana mainnet, paid with x402. The first, unpaid call returns our own 402 challenge; any x402 client that pays Solana USDC retries it with payment and receives the JSON report. Retrying the same paid request returns the same report with no second charge. If your domain cannot be reached at all, no report is produced and the payment is not settled.
What you get back
The x402_probe part of the report, for one unpaid GET to your path:
status and is_402: the HTTP status your path returned.
payment_required_header: whether the PAYMENT-REQUIRED header (x402 v2) was present.
parsed: whether the challenge decoded as JSON, from the header or else the body.
x402_version, accepts_count and up to 10 offers (scheme and network), so you can see which chains a buyer is offered.
"x402_probe": {
"status": 402, "error": null, "is_402": true,
"payment_required_header": true, "parsed": true,
"x402_version": 2, "accepts_count": 1,
"offers": [{"scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}]
}
The same report also covers HTTPS and redirects, /llms.txt, /.well-known/agent-card.json and robots.txt rules for 11 AI crawlers, which is how many agents find a service before they ever call it. Field meanings are in the report guide.
Common failures it shows
- The path answers 400 or 401 when a required parameter is missing, instead of 402, so directory validators see no challenge.
- The 402 has no
PAYMENT-REQUIRED header and no JSON body with accepts.
- A CDN or firewall in front of the API blocks outside callers, shown as an error or a non-402 status.
- The challenge parses but offers no network your buyers use.
Limits
The probe sends one unpaid GET to a path on the same domain you name. It does not pay your endpoint, so it cannot show that settlement or delivery works. It reports observations, not a certification. Private and internal addresses are refused.
OpenAPI · llms.txt · Terms of Service