Diagnose your x402 service
Diagnose by x402station.io · for sellers · $0.05 USDC per check · one free check per host every 30 days (daily limit applies)
Buyers run preflight on your endpoints before they pay. Diagnose shows you what they see: whether agents can find and pay your service on Base right now, and what to fix first. One call covers every active endpoint x402station.io tracks on your host (up to 200), with live fetches of up to 5 of them. Each finding carries a code, a severity and a fix.
Can a client pay your 402?
For up to 5 of your endpoints we fetch the unpaid 402 now and run it through stock v2 clients (PAYMENT-REQUIRED header) and legacy v1 clients (JSON body). The answer says whether each can pay it on Base, and why not if they cannot.
Does the gate match your listings?
The live price, network, asset and payTo are compared with the agentic.market catalog row and with Coinbase's discovery entry. Mismatches become findings.
Are you in Coinbase's index?
Per endpoint: in CDP Bazaar or not, with 30-day call counts for those that are, plus whether the host is in the agentic.market catalog we ingest.
How reliable are you for agents?
7-day probe history per endpoint: probe count, uptime (200 or 402 is healthy), 402 vs 200 share, p50 and p99 latency. Flags unreachable and degraded endpoints, slow challenges, endpoints that reject the unpaid request before issuing a 402, and endpoints that never issue one.
Host-level anti-patterns
Wildcard 402 (a 402 on random paths), SPA fallback (a 200 HTML shell on unknown API paths), and the same URL listed under other catalog services.
What changed since last time?
From the second check of a host on, the answer lists new findings, fixed findings, and changes in price, payTo or index status since the previous check.
Price
$0.05 USDC per check, settled on Base through x402. Every host we track gets one free check per 30 days, subject to a daily limit (3 free checks per client address per UTC day, plus a global daily cap): send the request without a payment header. When the free check is used up or paused, the same call answers 402 and you pay $0.05. A free answer may skip the live fetches when the server is busy and then rests on stored evidence only; a paid check never does (it answers 503 instead, uncharged). If the host is not in our catalog the answer is a 404 and you are not charged; a 503 (busy or query timeout) is never charged either, because settlement only runs after a successful answer.
Call it
Body is { "host": "api.example.com" }, or { "url": "https://api.example.com/v1/x" } to check that endpoint live first.
# 1. Free check: no payment header. One per host every 30 days for hosts
# we track, subject to a daily limit. The full answer comes back with HTTP 200.
curl -s -X POST https://x402station.io/api/v1/diagnose \
-H 'content-type: application/json' \
-d '{"host":"api.example.com"}'
# 2. When the free check is used up or paused, the same call answers HTTP 402 and
# you pay $0.05 USDC. The PAYMENT-REQUIRED header carries the x402 challenge (Base);
# the JSON body explains why this request was not free.
# 3. Sign the challenge with an x402 client and retry the identical request
# with the PAYMENT-SIGNATURE header. HTTP 200 returns the full report.From code, any x402 client works. With @x402/fetch:
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
const x402Fetch = wrapFetchWithPaymentFromConfig(fetch, { schemes: [...] });
const res = await x402Fetch("https://x402station.io/api/v1/diagnose", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ host: "api.example.com" }),
});
const report = await res.json(); // { ok, summary, findings, endpoints, ... }There is no dedicated MCP tool or middleware wrapper for diagnose yet; it is a plain x402 endpoint.
What the answer looks like
Example only, shortened; values are made up. Field names follow the live response. Finding codes include no_client_can_pay, listed_price_mismatch, coinbase_pay_to_mismatch, unreachable, not_in_bazaar, wildcard_402; each comes with a fix.
{
"ok": false,
"host": "api.example.com",
"checked_at": "2026-11-20T09:00:00.000Z",
"free_first_check": true,
"summary": {
"endpoints": 18,
"truncated": false,
"listed_in_agentic_market": true,
"coinbase_index": "15 of 18 endpoints are in Coinbase's index (CDP Bazaar); not indexed: …",
"in_coinbase_index": { "yes": 15, "no": 3 },
"healthy_7d": 16,
"live": { "status": "checked", "checked": 5, "v2_payable": 4, "v1_payable": 0, "unreachable": 0 },
"findings": { "critical": 1, "warn": 2, "info": 6 }
},
"since_last_check": null,
"first_check": true,
"findings": [
{
"code": "no_client_can_pay",
"severity": "critical",
"endpoint": "https://api.example.com/v1/translate",
"detail": "The live 402 cannot be paid on Base by a stock client of either generation …",
"fix": "Send the v2 challenge base64-encoded in the PAYMENT-REQUIRED response header …"
}
],
"endpoints": [
{
"url": "https://api.example.com/v1/search",
"in_coinbase_index": true,
"liveness_7d": { "probes": 1204, "uptime_pct": 99.8, "p50_ms": 140, "p99_ms": 880 },
"live_now": { "status": 402, "v2": { "payable_on_base": true }, "v1": { "payable_on_base": false } }
}
]
}