Agents & Protocols

x402 Seller: Get Paid and Listed in Bazaar

Recommended

Diagnoses why an HTTP API sold over x402 v2 cannot be paid by standard buyer agents or never appears in the Coinbase CDP Bazaar catalog, using an ordered checklist and a decision tree over the pasted 402 response, headers and symptoms. Names the exact field that is wrong or missing and how to prove the fix. Use when asked to check an x402 seller, fix an unpayable 402 endpoint, find out why a resource is not listed in Bazaar, or why a settled payment does not show up.

x402 Seller: Get Paid and Listed in Bazaar is a SKILL.md that diagnoses why an HTTP API sold over x402 v2 cannot be paid by standard buyer agents or never appears in the Coinbase CDP Bazaar catalog, using an ordered checklist and a decision tree over the pasted 402 response, headers and symptoms; an agent buys it once for $0.10 over x402.

Tested 2026-09-30No code, no hidden instructionsv1.0.2 · 14.0 KB · perpetual license

Not for

Building a seller from scratch, guaranteeing a Bazaar listing, or proving live behaviour: it reads pasted 402 responses and symptoms only, never calls your endpoint.

Tested, honestly

Tested 2026-09-30 with a strong and a weak model.

With and without the skill

Results with and without the skill, for Sonnet and Haiku
SonnetHaiku
withwithoutwithwithout
Named the planted defect6/62/66/60/6

One run per model and case. Without the skill Sonnet missed the exact field to fix in four cases: the missing extra, where extensions.bazaar goes, the test network and the 30-day delisting. Haiku missed all six, including the missing header and the UTF-8 decoding.

Same cases and the same checks with and without the skill. The cases are ours, written around what the skill is for; with a handful of cases, a difference of one or two is within noise.

SonnetStrong model, Claude Sonnet
Named the planted defect in all 6 cases in every run (missing PAYMENT-REQUIRED header, missing extra, extensions placed inside accepts[0], test network plus x402.org facilitator, UTF-8 versus atob decoding, the 30-day delisting), also found a second defect where present, wrote the German case in German, and never promised a listing. Sometimes adds cautious extra remarks (a placeholder address, the missing bazaar block on a body that never claimed one).
HaikuWeak model, Claude Haiku
Named the planted defect in 6 of 6 cases on the second run. On the first run it missed the missing extra field entirely and reported only a masked placeholder wallet address as the defect; a rule to tick every field and treat placeholders as redaction fixed that in the next run. Still breaks the no-code-block rule (shows a small JSON snippet), quotes the skill file back to the reader, and once used up to 9,000 tokens on one case. Weaker on the German case wording (verdict line not in the requested form). Slightly over-promises timing of a listing (says it should appear within minutes to hours).

Full test summary

Example

Our own test text, before and after the skill ran. Excerpts only.

English · claude-sonnet-5-5

Before

Unpaid GET https://api.example-shop.dev/v1/report Response status: 402 Response headers: content-type: application/json cache-control: no-store x-powered-by: hono Response body: {"x402Version":2,"error":"Payment required","resource":{"url":"https://api.example-shop.dev/v1/report","description":"Daily…

After

Verdict: Defects found I read only the pasted text and did not call the endpoint. **Step 1: `PAYMENT-REQUIRED` header missing (most likely cause)** - Seen: the response headers you pasted are `content-type`, `cache-control` and `x-powered-by`. There is no `PAYMENT-REQUIRED` header.…

German · claude-sonnet-5-5

Before

Beschreibung: Der 402 ist korrekt (PAYMENT-REQUIRED-Header identisch mit dem Body, extra vorhanden, extensions.bazaar auf oberster Ebene mit info und schema, Netzwerk eip155:8453). Die letzte Abrechnung ueber den CDP-Facilitator war vor 40 Tagen, seitdem hat niemand gekauft. Vorher war die Ressource im Bazaar gelistet, jetzt liefert die Suche nach meiner Domain nichts.

After

Verdict: Defects found (Ursache benannt: 30-Tage-Regel, kein Fehler im 402 selbst) **Schritt 11: Zeit seit der letzten Abrechnung** - Seen: "Die letzte Abrechnung über den CDP-Facilitator war vor 40 Tagen, seitdem hat niemand gekauft." - Why it matters: Der Katalog nimmt eine Ressource etwa 30 Tage nach der letzten Abrechnung für genau diese Ressource wieder heraus. 40 Tage liegen darüber.…

What is in the file

  • Hard rules
  • What a correct seller looks like
  • The checklist, cheapest and most common first
  • Decision tree from the symptom
  • How to prove each repair
  • Output format
  • Examples of the judgement

Languages

Any language. Tried in: English, German.

License

Perpetual, non-exclusive; use and modify for yourself incl. paid work; no resale or republishing. Holder: Georgi Kalchev, aiskills402.com. Full terms.

Versions

Current version 1.0.2, updated 2026-10-04. Whoever bought an earlier version gets new ones free through the same re-download token.

  1. v1.0.2 · 2026-10-04

    - Test summary: the same cases with and without the skill, per model, now shown next to the verdicts, including where the skill made no difference. The skill file itself is unchanged.

  2. v1.0.1 · 2026-10-03

    - Licence section: the note telling the agent to skip it now reads "ignore it while you work" instead of "ignore it while rewriting text", which was written for one skill and read oddly in the others. The skill's own instructions are unchanged.

  3. v1.0.0 · 2026-09-30

    - First release: ordered checklist and symptom decision tree for x402 v2 sellers whose endpoint is not payable or not listed in the CDP Bazaar; never promises listing.

FAQ

What defects does it find?

In our test set it named the planted fault in every case: a missing payment-required header, a missing extra field, discovery data placed inside the wrong object, a test network paired with the wrong facilitator, a decoding mistake with non-ASCII text, and a listing dropped after 30 days without a settlement.

Will it get my API into the catalog?

No, and it says so. Listing depends on the catalog's own rules, which can change, and on a real settled payment. The skill finds what blocks a listing and how to prove each fix, but it never promises a listing or a timing.

Does it call my endpoint?

No. It reads the 402 response, headers and symptoms you paste and works through an ordered checklist. Anything that needs live behaviour, such as settlement history or edge settings, you have to check yourself, and the skill tells you which check.

Read more

Share

Read this page as Markdown: /skills/x402-seller.md.

  • x402 Buyer: Pay Safely from an Agent Wallet

    Agents & Protocols

    SKILL.md · v1.0.4 · 9.4 KB

    Decision rules for an AI agent that holds a wallet and receives an HTTP 402 payment request (x402 v2). Decides SIGN, REFUSE or ASK the human before any money moves, and says how to verify the delivery and retry without paying twice. Use when an agent is about to pay over x402, gets a 402 response, must check a seller's payment terms, or a paid request failed and it is unsure whether to pay again.

    $0.05once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 30 Sep 2026

  • Code Review

    Code & Engineering

    SKILL.md · v1.0.4 · 6.0 KB

    Reviews a code change (a diff or a changed file pasted as text) and reports real problems ranked by severity — correctness bugs, security holes, data loss, missing error handling, edge cases, resource leaks — each with location, reason and a concrete fix in words. Use when asked to review code, a diff or a pull request, check a change for bugs, or find security problems in a snippet.

    $0.01once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 30 Sep 2026

More in Agents & Protocols

  • Recommended

    x402 Listing Review: Catalogs, Scanners, Buyers

    Agents & Protocols

    SKILL.md · v1.1.0 · 15.4 KB

    Reviews how a paid HTTP resource sold over x402 is advertised to catalogs, scanners and buyer agents, and how the seller's own scripts read those catalogs back, from pasted 402 bodies, OpenAPI documents, discovery files, liveness guard code, catalog presence check scripts and buyer alerts. Flags a tiered tariff advertised as one row (a comparison bot reads the structured amount, not the description), one liveness clock for several catalog rows that are dropped one by one, a price above the standard buyer client's default cap with no note where agents read before buying, a discovery file the scanner no longer parses, a bearer scheme the scanner's indexer does not recognise by name, a scanner record that was never re-crawled after a fix, a presence check that reads only one of the two response field names or has no control that must return zero, a first buyer that is a crawler paying hundreds of sellers, and discovery endpoints that read the database on every crawl. Each finding has a fixed code, the place, the reason and a fix, then one verdict. Use for an x402 listing review, to check x402 discovery or Bazaar catalog presence code before trusting it, or to audit how a paid API is listed and read.

    $0.05once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 29 Oct 2026

  • Retry Backoff Review

    Agents & Protocols

    SKILL.md · v1.0.0 · 6.0 KB

    Reviews ONE piece of retry code, or a written retry design for an agent or a service client, and lists only the five mistakes that turn a failure into an outage or a double write, one line each with a fixed code, the place, why it hurts and the fix - or exactly No findings. It catches waits that grow without a random part, a loop with no limit on tries or on total time, a POST repeated with no idempotency key, a 429 or 503 answer whose Retry-After header is never read, and retries on client errors that cannot change. It leaves out the safe look-alikes, such as a GET retried with a cap and jitter, a retry set of 408, 429 and server errors only, and a wait taken straight from Retry-After. Use to review the retry loop of an API client, to audit how an agent calls tools that fail, or before shipping a client to production.

    $0.01once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 26 Oct 2026

  • Recommended

    Windows UTF-8 Request Body: curl and PowerShell

    Agents & Protocols

    SKILL.md · v1.0.0 · 13.7 KB

    Sends request text with Cyrillic, accented letters, em dashes, typographic quotes, apostrophes or the euro sign from Windows so that it reaches the server byte for byte. The curl that ships with Git for Windows converts text given on its command line to the ANSI code page, and Windows PowerShell 5.1 sends a string body without UTF-8, writes files in the ANSI code page, as UTF-16 or with a BOM, strips the quotes from JSON it hands to a program, ends strings at typographic quotes and runs Invoke-WebRequest when you type curl. The server still answers 200 and the page later shows � or ?. The body goes into a UTF-8 file without a BOM that curl reads itself, or into a script, or Invoke-RestMethod gets charset=utf-8 in -ContentType; the record is read back and compared with the source, and text that was already sent broken is fixed through an edit route, or the person is asked before anything is submitted twice. Use when an agent or a script on Windows posts JSON or form data with curl, Invoke-RestMethod or another command-line tool from Git Bash or PowerShell, or when text sent from Windows arrives as �, question marks, mojibake or with a BOM.

    $0.05once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 25 Oct 2026

  • MCP Tool Schema: Definitions from API Docs

    Agents & Protocols

    SKILL.md · v1.1.1 · 10.2 KB

    Writes the MCP tool definition for one API operation - name, description, inputSchema and annotations - as the JSON a server returns from tools/list. The schema takes exactly the parameters the operation takes - required ones listed, defaults stated, exact enums, integer amounts, date formats, ranges, string and array limits, either-or parameters that refuse a call with both or neither - and refuses unknown ones. Credentials never become parameters, text in the API docs that speaks to the assistant stays out of the description, one tool does one operation, and every tool gets a title and all four annotations as explicit true or false (reads, safe repeats, destructive writes, open world), as the MCP specification of 2025-11-25 and the Claude and ChatGPT directories expect. Use when asked to write, review or fix an MCP tool definition, a tool schema or an inputSchema, or to turn an API endpoint, an OpenAPI operation or a function signature into an MCP tool.

    $0.03once

    • x402
    • USDC
    • Base
    Get skill

    Tested with Sonnet and Haiku, 23 Oct 2026