Why is my x402 endpoint broken
Why is my x402 endpoint broken? Diagnose and debug an x402 payment endpoint (or MCP server) when payments fail: checks the 402 challenge, accepts[] (network, payTo, amount, asset), resource URL, Solana settlement readiness, which wallets and agents can pay, B…
by x402-doctor.onrender.com · discovered, not yet claimed by its owner · updated 2026-09-29
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Why is my x402 endpoint broken? Diagnose and debug an x402 payment endpoint (or MCP server) when payments fail: checks the 402 challenge, accepts[] (network, payTo, amount, asset), resource URL, Solana settlement readiness, which wallets and agents can pay, Bazaar/OpenAPI discovery and the browser paywall. Returns every check with a fix hint. Read-only: never pays.
Tags: x402 · developer-tools · diagnostics · debug · payments · bazaar
Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/38096.jsonfor the price and payment options. - Pay. Call
GET https://x402-doctor.onrender.com/api/v1/diagnose. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.01 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Solana
- Calls (30d)
- 4 · 3 unique payers (third-party data from the public x402 Bazaar)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.01 | 0x6B0F4651eD42893ab58139938175E4a69f175F25 | 300s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.01 | ATWJ82T8nRdQwZnaysB68N5EpaSvLRsQP4h6eWmaJBH9 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x6B0F4651eD42893ab58139938175E4a69f175F25",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "ATWJ82T8nRdQwZnaysB68N5EpaSvLRsQP4h6eWmaJBH9",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"challenge": {
"type": [
"object",
"null"
]
},
"checks": {
"items": {
"properties": {
"group": {
"enum": [
"challenge",
"accepts",
"resource",
"settlement",
"wallets",
"discovery",
"browser"
],
"type": "string"
},
"hint": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"status": {
"enum": [
"pass",
"warn",
"fail",
"info",
"skip"
],
"type": "string"
}
},
"required": [
"id",
"status",
"message"
],
"type": "object"
},
"type": "array"
},
"method": {
"enum": [
"GET",
"POST",
null
],
"type": [
"string",
"null"
]
},
"overall": {
"enum": [
"pass",
"warn",
"fail"
],
"type": "string"
},
"url": {
"type": "string"
},
"wallets": {
"description": "Which wallets can pay: per wallet, the networks where payment works (yes) and where it fails, with the reason (no).",
"items": {
"properties": {
"agent": {
"type": "boolean"
},
"no": {
"items": {
"properties": {
"network": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"wallet": {
"type": "string"
},
"yes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"url",
"overall",
"checks"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"challenge": {},
"checks": [
{
"group": "challenge",
"hint": "string",
"id": "string",
"message": "string",
"status": "pass"
}
],
"method": "GET",
"overall": "pass",
"url": "string",
"wallets": [
{
"agent": true,
"no": [
{
"network": "string",
"reason": "string"
}
],
"wallet": "string",
"yes": [
"string"
]
}
]
},
"type": "string"
}Examples
curl "https://x402-doctor.onrender.com/api/v1/diagnose"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://x402-doctor.onrender.com/api/v1/diagnose");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://x402-doctor.onrender.com/api/v1/diagnose")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- x402-doctor.onrender.com
- Endpoint
- https://x402-doctor.onrender.com/api/v1/diagnose
- Machine-readable
/resources/38096.json