x402station.io API reference

Seller check

Seller check for one host: can stock v1 and v2 x402 clients pay your live 402 on Base, does the gate's price / network / asset / payTo match your catalog listing and Coinbase's discovery entry, is each endpoint in Coinbase's index (CDP Bazaar), 7-day liveness per endpoint, and what changed since your last check. Every finding has a code, a severity and a concrete fix.

This HTML page is served by GET /api/v1/diagnose. The paid API operation remains POST /api/v1/diagnose.

Signature
POST /api/v1/diagnose
Pricing
$0.05 USDC (one free check per host every 30 days)
Settlement
x402 v2 · exact · Base mainnet USDC
Canonical
https://x402station.io/api/v1/diagnose

x402 challenge example

HTTP/1.1 402 Payment Required
payment-required: <base64 PaymentRequiredResponse>
www-authenticate: x402
content-type: application/json; charset=utf-8

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402station.io/api/v1/diagnose",
    "description": "Seller check"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "USDC",
      "amount": "50000",
      "payTo": "0x4053338C7cB38624C0bc23c900F78Cf8470b4E38",
      "maxTimeoutSeconds": 300
    }
  ]
}

Request body

{
  "host": "api.example.com"
}

Success response

{
  "ok": false,
  "host": "api.example.com",
  "free_first_check": true,
  "summary": {
    "endpoints": 18,
    "listed_in_agentic_market": true,
    "coinbase_index": "15 of 18 endpoints are in Coinbase's index (CDP Bazaar); not indexed: https://api.example.com/v1/a, https://api.example.com/v1/b, https://api.example.com/v1/c.",
    "in_coinbase_index": {
      "yes": 15,
      "no": 3
    },
    "live": {
      "checked": 5,
      "v2_payable": 4,
      "v1_payable": 0,
      "unreachable": 0
    },
    "findings": {
      "critical": 1,
      "warn": 3,
      "info": 6
    }
  },
  "since_last_check": null,
  "first_check": true,
  "findings": [
    {
      "code": "v2_clients_cannot_pay",
      "severity": "warn",
      "endpoint": "https://api.example.com/v1/report",
      "detail": "Stock v2 clients (@x402/fetch, @x402/core) read the PAYMENT-REQUIRED header and cannot pay it: the v2 challenge names the network \"base\"; v2 clients match the CAIP-2 id \"eip155:8453\". Legacy v1 clients pay through the JSON body.",
      "fix": "Use network \"eip155:8453\" in v2 challenges (\"base\" is the v1 name)."
    }
  ]
}

Error codes

statusmeaning
400Malformed JSON body or invalid host.
402Payment required. The JSON body's free_first_check says why this request was not free. Decode payment-required, sign x402, retry.
404Host not in the catalog. Not charged.
409The same payment header is already being answered. Not charged; wait for the first answer.
503Query timeout, or all live-check slots busy (error live_checks_busy, Retry-After). Not charged; safe to retry.

Notes

Machine-readable links