X

x402-listing-doctor · Listing Doctor

by x402-listing-doctor

POSTBase

$0.25

per call · USD Coin on Base

Why is my x402 service not listed — or listed but never paid? Send your endpoint URL; we fetch your 402 envelope, run the exact SDK validation the CDP facilitator runs, check catalog presence, and return per-check pass/fail with concrete fix hints. Includes two undocumented traps we verified against the live facilitator: a buyer must echo your bazaar extension into the settle payload, and a description over 500 characters makes the facilitator reject every payment. Deterministic, no LLM.

Endpoint

POST https://x402-store.dgdb.workers.dev/v1/listing-doctor

7

Calls / 30d

1

Unique payers / 30d

Sep 10

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://x402-store.dgdb.workers.dev/v1/listing-doctor", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "method": "POST",
    "resource_url": "https://your-shop.example.com/v1/your-endpoint"
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://x402-store.dgdb.workers.dev/v1/listing-doctor" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","resource_url":"https://your-shop.example.com/v1/your-endpoint"}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "checks": [
    {
      "id": "returns_402",
      "message": "402 Payment Required",
      "status": "pass"
    },
    {
      "id": "bazaar_extension_present",
      "message": "extensions.bazaar present",
      "status": "pass"
    },
    {
      "id": "facilitator_extraction",
      "message": "extractDiscoveryInfo OK (same function CDP runs)",
      "status": "pass"
    },
    {
      "id": "listed_in_catalog",
      "message": "not in catalog snapshot 20260612 (25403 items)",
      "status": "warn"
    }
  ],
  "how_to_get_listed": [
    "1. ...",
    "2. KEY: buyer must echo the bazaar extension into the settle payload ...",
    "3. ..."
  ],
  "overall": "listable_pending_settle",
  "url": "https://your-shop.example.com/v1/your-endpoint"
}

Payment details

Pay to0xd617a7145ca56e3ed58d639f9dec6999b22441ee
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Developer Tools and the homepage with a featured placement.

Get featured →

More from x402-listing-doctor & similar services