x402 Doctor

Free: does this x402 endpoint work for a paying agent? Returns pass, warn or fail with the number of problems and the top three. Limited to 10 calls per hour. For every check use x402_diagnose ($0.01); for code changes x402_fix ($0.05); before paying someone else's endpoint x402_preflight ($0.001).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid ($0.01 USDC via x402 on Base or Solana): diagnose an x402 endpoint the way a paying agent would, without paying it: the 402 challenge format, every accepts[] option, the resource URL, Solana settlement readiness, which wallets can pay, Bazaar/OpenAPI discovery and the browser paywall. Returns every check with pass/warn/fail and a fix hint. Same as GET /api/v1/diagnose. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid ($0.001 USDC via x402 on Base or Solana): call this before your agent pays an x402 endpoint. Returns go, caution or no_go, the recommended payment option, and why: payment would fail, over your budget (max_usd), price above what is advertised, not HTTPS, unknown token, its 30-day track record. Never pays the endpoint. Same as GET /api/v1/preflight. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    },
    "max_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Your budget per call in USD, e.g. 0.05"
    },
    "network": {
      "type": "string",
      "description": "CAIP-2 network you want to pay on, e.g. eip155:8453"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid ($0.05 USDC via x402 on Base or Solana): diagnoses your x402 endpoint, then returns per problem the concrete change as code for your stack (express, next, hono, node, python, generic), filled in with your own payTo, amount, network and route. Same as GET /api/v1/fix. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    },
    "stack": {
      "type": "string",
      "enum": [
        "express",
        "next",
        "hono",
        "node",
        "python",
        "generic"
      ],
      "description": "Your server stack (default: detected)"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid ($0.005 USDC via x402 on Base or Solana): the pre-payment check for up to 10 x402 endpoints at once. Per endpoint go, caution or no_go, the recommended payment option and why, plus totals. For marketplaces and agents that weigh several services. Never pays the endpoints. Same as GET /api/v1/preflight/batch. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 10,
      "description": "The x402 endpoints to check (public http(s) URLs), at most 10"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    },
    "max_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Your budget per call in USD, e.g. 0.05"
    },
    "network": {
      "type": "string",
      "description": "CAIP-2 network you want to pay on, e.g. eip155:8453"
    }
  },
  "required": [
    "urls"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid ($0.01 USDC via x402 on Base or Solana): for expensive calls. The pre-payment verdict (go, caution or no_go) plus the full diagnosis, the 30-day history per day, how reliable the seller's other endpoints are and whether the endpoint moved domains. Never pays the endpoint. Same as GET /api/v1/preflight/deep. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ],
      "description": "HTTP method of the paid route (default: GET, then POST)"
    },
    "max_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Your budget per call in USD, e.g. 0.5"
    },
    "network": {
      "type": "string",
      "description": "CAIP-2 network you want to pay on, e.g. eip155:8453"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report a bug, a missing feature or anything else about this service, in a structured way. Free. A person reads every report; nothing is run or changed automatically.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "bug",
        "feature",
        "other"
      ],
      "description": "bug, feature (something missing) or other"
    },
    "message": {
      "type": "string",
      "description": "What happened or what you need"
    },
    "endpoint": {
      "type": "string",
      "description": "Optional: the route or tool it is about, e.g. /v1/token"
    },
    "contact": {
      "type": "string",
      "description": "Optional: how to reach you about it"
    }
  },
  "required": [
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}