{"uid":"cap_iXA5OtJODVI54wT28Qso2","slug":"list-smith-v1-fix-x402-route-discovery-repair-758b6187","name":"list-smith /v1/fix — x402 Route Discovery Repair","description":"Repair one x402 route's Bazaar discovery metadata in one call. Send a resource URL and one real sample output; get the defect report plus a complete discovery package — full output schema inferred from the sample, a sub-500-char description with a use-when sentence, OpenAPI and well-known snippets, paste-in instructions — that ships only after passing both x402 SDK validators. Use this when your listing is hollow, invalid, or invisible in the Bazaar.","url":"https://list-smith-production.up.railway.app/v1/fix?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["full","compact"],"type":"string","description":"Optional response mode, default 'full'. 'full' returns the complete package (extension with meta-schema, OpenAPI + well-known snippets, instructions). 'compact' returns the repaired fields only (description, extension info, changes) in a smaller response; the package is validated the same way in both modes."},"name":{"type":"string","description":"Optional display name for the generated description; derived from the URL when omitted."},"category":{"type":"string","description":"Optional category (e.g. token-risk, search, data, media, monitoring) used to phrase the description's use-when sentence."},"resource_url":{"type":"string","description":"Full URL of the x402 resource to repair, e.g. https://service.example.com/v1/endpoint"},"sample_output":{"description":"One real response body from the endpoint (required). The repaired output schema is inferred from this sample only — nothing is invented."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["resource_url","graded_at","ok","failure","score_before","defects","package","notes"],"properties":{"ok":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}},"defects":{"type":"array","items":{"type":"object","required":["name","severity","detail"],"properties":{"name":{"type":"string"},"detail":{"type":"string"},"severity":{"enum":["critical","major","minor"],"type":"string"}}}},"failure":{"type":["string","null"],"description":"Why no package was shipped, when ok is false — an unvalidatable package is never shipped broken"},"package":{"type":["object","null"],"required":["inferred_from","description","extension","openapi_snippet","well_known_snippet","instructions","validation"],"properties":{"extension":{"type":"object","description":"The repaired Bazaar discovery extension (passed both SDK validators)"},"validation":{"type":"object","required":["consistency_valid","spec_valid"],"properties":{"spec_valid":{"type":"boolean"},"consistency_valid":{"type":"boolean"}}},"description":{"type":"string","description":"Under 500 chars, with a use-when sentence"},"instructions":{"type":"string"},"inferred_from":{"type":"string","const":"single_sample"},"openapi_snippet":{"type":"object"},"well_known_snippet":{"type":"object"}}},"graded_at":{"type":"string"},"resource_url":{"type":"string"},"score_before":{"type":["integer","null"],"description":"The /v1/grade score of the listing as found"}}},"example":{"ok":true,"notes":["inferred_from: single_sample — the output schema was inferred from the one sample supplied; review it before shipping, especially arrays (element schemas are merged) and any field whose real type varies."],"defects":[{"name":"hollow output schema (example only, no typed schema)","detail":"info.output carries only type/example — the hollow shape 87.8% of listings ship. No field is typed, so a buyer cannot validate a response.","severity":"major"}],"failure":null,"package":{"extension":{"info":{"input":{"body":{"thing_id":"abc"},"type":"http","method":"POST","bodyType":"json"},"output":{"type":"json","schema":{"type":"object","required":["verdict","score"],"properties":{"score":{"type":"integer"},"verdict":{"type":"string"}}},"example":{"score":12,"verdict":"OK"}}},"schema":{"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","required":["thing_id"],"properties":{"thing_id":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object","required":["verdict","score"],"properties":{"score":{"type":"integer"},"verdict":{"type":"string"}}}}}}}},"validation":{"spec_valid":true,"consistency_valid":true},"description":"Target Thing — returns verdict, score. Use when you need structured data inside an agent workflow. $0.02 per call in USDC on Base via x402.","instructions":"How to ship this package (standard x402 middleware, e.g. the Python/TS x402 SDKs):\n\n1. Set your route's description to package.description (it is under 500 characters,\n   so CDP-facilitator payments will not be rejected for length), e.g.:\n       RouteConfig(description=<package.description>, extensions={\"bazaar\": <package.extension>})\n2. Attach package.extension as the route's Bazaar discovery extension:\n       extensions={\"bazaar\": package[\"extension\"]} on the same route config.\n   The extension passed validate_discovery_extension and\n   validate_discovery_extension_spec at generation time.\n3. Replace the resource entry in your /.well-known/x402 manifest with\n   package.well_known_snippet, and merge package.openapi_snippet.paths into\n   your OpenAPI document.\n4. Keep the manifest accepts IDENTICAL to your live 402 challenge — directory\n   validators read the two against each other and reject mismatches.\n5. Metadata alone never lists you: settle one real payment through the CDP\n   facilitator (CDP Bazaar / Agentic.Market) or the PayAI facilitator (PayAI\n   index) and that index catalogs this route; re-settle at least every ~30 days\n   or the listing ages out.","inferred_from":"single_sample","openapi_snippet":{"paths":{"/v1/thing":{"post":{"summary":"Target Thing — returns verdict, score","responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["verdict","score"],"properties":{"score":{"type":"integer"},"verdict":{"type":"string"}}},"example":{"score":12,"verdict":"OK"}}},"description":"Success"},"402":{"description":"Payment required — x402 challenge; extensions.bazaar carries the discovery extension from this package."}},"description":"Target Thing — returns verdict, score. Use when you need structured data inside an agent workflow. $0.02 per call in USDC on Base via x402.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["thing_id"],"properties":{"thing_id":{"type":"string"}}},"example":{"thing_id":"abc"}}},"required":true}}}},"openapi":"3.0.3"},"well_known_snippet":{"price":"$0.02","method":"POST","scheme":"exact","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x1111111111111111111111111111111111111111","amount":"20000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300}],"mimeType":"application/json","resource":"https://target.example.com/v1/thing","description":"Target Thing — returns verdict, score. Use when you need structured data inside an agent workflow. $0.02 per call in USDC on Base via x402.","inputSchema":{"type":"object","required":["thing_id"],"properties":{"thing_id":{"type":"string"}}},"outputSchema":{"type":"object","required":["verdict","score"],"properties":{"score":{"type":"integer"},"verdict":{"type":"string"}}}}},"graded_at":"2026-10-21T21:38:16.624678+00:00","resource_url":"https://target.example.com/v1/thing","score_before":88}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tVI5DhQfW-0_awpAofY5f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits and fully repairs an x402 route's Bazaar discovery metadata, returning a validated discovery package (schema, description, OpenAPI snippet, instructions) inferred from a real sample output.","exampleAgentPrompt":"My x402 route at https://myservice.example.com/v1/analyze is invisible in Bazaar — can you repair its discovery metadata? The category is 'data' and here's a real sample response body from it: {\"risk_score\": 0.87, \"label\": \"high\", \"token\": \"0xabc\"}","exampleUseCases":[{"title":"Fix hollow listing for data API","prompt":"My x402 data endpoint at https://riskcheck.example.com/v1/score has a hollow listing in Bazaar with no typed output schema. Here's a real sample output it returns: {\"score\": 0.73, \"verdict\": \"safe\", \"checked_at\": \"2024-01-15T10:00:00Z\"}. Can you repair the discovery metadata for it? Category is 'token-risk'."},{"title":"Make invisible search route discoverable","prompt":"My x402 search route at https://searchapi.example.com/v1/query isn't showing up in agentic marketplaces at all — the listing is basically empty. The category is 'search'. Here's a sample response it gives back: {\"results\": [{\"title\": \"Example\", \"url\": \"https://example.com\", \"snippet\": \"Sample result\"}], \"total\": 42}. Please fix the Bazaar discovery package for it."},{"title":"Repair invalid monitoring endpoint listing","prompt":"I've got an x402 monitoring endpoint at https://uptime.example.com/v1/status that has invalid discovery metadata failing the SDK validators. Category is 'monitoring', and a real sample output looks like: {\"status\": \"up\", \"latency_ms\": 120, \"checked_at\": \"2024-01-15T09:55:00Z\", \"incidents\": []}. Can you generate a complete, validated discovery package for it?"}],"resultDescription":"A JSON object containing: a boolean ok flag, a pre-repair score, an array of defect objects (each with name, severity, and detail), a failure reason if the package could not be produced, and — when ok is true — a full discovery package including the inferred output schema extension (validated by both x402 SDK validators), a sub-500-char description with a use-when sentence, an OpenAPI snippet, a well-known snippet, and paste-in instructions. Also includes notes about inference caveats.","failureModes":["Invalid or unreachable resource_url — failure field set, no package shipped","Sample output is unparseable or empty — cannot infer schema, ok=false","Package fails both x402 SDK validators — endpoint refuses to ship broken package, failure explains why","Missing required sample_output field — request rejected","Endpoint cannot infer sufficient schema from a single sample with high variance types"],"whenToPreferThis":"Use this endpoint (rather than the sibling /v1/grade diagnosis-only endpoint) when you want both the diagnosis AND a ready-to-paste, validator-approved discovery package in a single call. Ideal when your x402 listing is confirmed hollow, invalid, or invisible in Bazaar and you want immediate remediation rather than just a report. The $0.50 USDC cost is justified by receiving a complete, pre-validated package you can ship immediately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:14.306Z","isFirstParty":false,"canonicalSlug":"list-smith-v1-fix-x402-route-discovery-repair-758b6187"}