# x402 Wallet Funding Readiness Doctor (GET)

> x402 Wallet Funding Readiness Doctor (GET) is a paid API for AI agents from gpt55.558686.xyz, paid per call via x402, $0.006/call, status down (last checked 2026-10-12).

Diagnoses buyer-side gaps preventing a valid X-PAYMENT header from being created for an x402 quote, checking wallet address, USDC balance, spend cap, quote field matching, and client signing capability via GET parameters.

## Facts

- Endpoint: POST https://gpt55.558686.xyz/v1/tools/x402-wallet-funding-readiness-doctor?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-wallet-funding-readiness-doctor-get-3ef4bb52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kgA_8suF9e32FCinsxPIG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-wallet-funding-readiness-doctor-get-3ef4bb52 -d '<json body>'
```

Example prompt: Can you run the x402 wallet readiness doctor on my wallet 0xAbC123...def for a quote at https://api.example.com/paid-resource that costs 0.005 USDC on Base, with a max spend cap of 0.01 USDC, and tell me if my wallet can sign typed data and supports same-request retry?

## When to prefer this

Use this endpoint when an AI agent or wallet needs to pre-flight check all buyer-side conditions before attempting an x402 payment — especially when debugging why a payment header cannot be constructed. Prefer this over generic wallet balance checkers because it covers the full x402 quote-to-header pipeline including typed-data signing, spend caps, and quote field matching in a single deterministic call that never touches private keys or sends actual payments.

## Known failure modes

- Missing required 'input' or 'method' fields returns a 400 validation error
- Invalid wallet address format detected and flagged in diagnosis
- Quote URL unreachable or returns non-402 response — cannot inspect live quote
- Amount or network mismatch detected between provided params and actual quote
- Timeout if the target quote endpoint takes longer than 15000ms to respond
- Boolean fields like can_sign_typed_data provided as unrecognized string values

## Output

Returns a structured readiness report with an overall ok/fail status, plus per-check results covering wallet address validity, USDC balance sufficiency, spend cap adequacy, quote field matching (amount, payTo, network, asset), official x402 client readiness, typed-data signing capability, and same-request retry support — without ever sending a payment or requiring private keys.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 2048,
       "minLength": 1
      },
      "body": {
       "type": "object",
       "additionalProperties": true
      },
      "method": {
       "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
       ],
       "type": "string"
      },
      "endpoint": {
       "type": "string",
       "maxLength": 2048,
       "minLength": 1
      },
      "max_usdc": {
       "type": "number",
       "maximum": 100,
       "minimum": 0.000001
      },
      "resource": {
       "type": "string",
       "maxLength": 2048,
       "minLength": 1
      },
      "timeout_ms": {
       "type": "integer",
       "maximum": 15000,
       "minimum": 1000
      },
      "amount_usdc": {
       "type": "number",
       "minimum": 0
      },
      "usdc_balance": {
       "type": "number",
       "minimum": 0
      },
      "amount_atomic": {
       "type": "string",
       "maxLength": 80
      },
      "expectedAsset": {
       "type": "string",
       "maxLength": 120
      },
      "expectedPayTo": {
       "type": "string",
       "maxLength": 80
      },
      "max_price_usd": {
       "type": "number",
       "maximum": 100,
       "minimum": 0.000001
      },
      "walletAddress": {
       "type": "string",
       "maxLength": 80
      },
      "available_usdc": {
       "type": "number",
       "minimum": 0
      },
      "expected_asset": {
       "type": "string",
       "maxLength": 120
      },
      "usdc_available": {
       "type": "number",
       "minimum": 0
      },
      "wallet_address": {
       "type": "string",
       "maxLength": 80
      },
      "expectedNetwork": {
       "type": "string",
       "maxLength": 80
      },
      "expected_pay_to": {
       "type": "string",
       "maxLength": 80
      },
      "expected_network": {
       "type": "string",
       "maxLength": 80
      },
      "quote_amount_usd": {
       "type": "number",
       "minimum": 0
      },
      "has_payment_client": {
       "type": [
        "boolean",
        "string"
       ]
      },
      "native_balance_eth": {
       "type": "number",
       "minimum": 0
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-wallet-funding-readiness-doctor-get-3ef4bb52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gpt55.558686.xyz](https://www.zero.xyz/host/gpt55.558686.xyz/llms.txt)