{"uid":"cap_yRE4KL6Zh37aydRQuIjGt","slug":"x402-api-example-doctor-75c8ab39","name":"x402 API Example Doctor","description":"Seller-facing schema/example doctor: compares an x402 resource to top-earning examples and returns exact missing request/response examples, listing copy, schema patches, and a measurable polish gate. Price 0.08 USDC on Base via x402. Free preview: https://x402-market-intel-mcp.mtree.workers.dev/preview/api_example_doctor?source=x402_manifest. Demo: https://x402-market-intel-mcp.mtree.workers.dev/demo/api_example_doctor. Contact: https://x402-market-intel-mcp.mtree.workers.dev/contact.","url":"https://x402-market-intel-mcp.mtree.workers.dev/v1/x402/api_example_doctor","method":"POST","headers":{},"bodySchema":{"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":{"domain":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"input_example":{"type":"object"},"output_example":{"type":"object"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"limit":10,"query":"artificial intelligence API","category":"technology"},"response":{"ok":true,"target":{"domain":null,"resource":null},"patches":[{"field":"input_schema","action":"add_json_schema_for_required_request_body"},{"field":"output_schema","action":"add_json_schema_for_machine_usable_response"},{"field":"input_example","action":"add_minimal_copyable_request_example"},{"field":"output_example","action":"add_realistic_response_example_with_verdict_or_result"},{"field":"description","action":"rewrite_as_specific_agent_job_not_generic_api_summary"}],"verdict":"fix_examples_before_listing","freshness":{"source":"request body","observed_at":"2026-06-12T04:10:06.000Z"},"generated_at":"2026-06-12T04:10:06.000Z","patch_payload":{"listing_copy":"paid x402 endpoint: send one specific input, receive a machine-usable verdict/result with evidence, freshness, and the next action an agent can execute.","x402_402_body_example":{"error":"x402_payment_required","price":"$0.08","method":"POST","pay_to":"0x1664530DC2A1CA350B1dbaD1Fc1F1a70c90fe4de","network":"eip155:8453","demo_url":"https://example.com/demo","resource":"https://example.com/v1/paid"},"bazaar_extension_patch":{"extensions":{"bazaar":{"info":{"input":{"body":{"resource":"https://example.com/v1/paid","budget_usdc":0.25}},"output":{"example":{"ok":true,"score":82,"verdict":"use_with_cap","evidence":[{"check":"live_402","status":"pass"}],"next_action":"pay once under cap, then measure result quality"}}},"schema":{"inputSchema":{"type":"object","required":["resource"],"properties":{"resource":{"type":"string"},"budget_usdc":{"type":"number"}}},"outputSchema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"score":{"type":"number"},"verdict":{"type":"string"},"evidence":{"type":"array"},"next_action":{"type":"string"}}}},"category":"technology","keywords":["x402","paid api","agent verdict","artificial","intelligence","api"],"discoverable":true}}},"openapi_operation_patch":{"/v1/paid":{"post":{"summary":"paid x402 endpoint: one input, one verdict/result","responses":{"200":{"content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"score":{"type":"number"},"verdict":{"type":"string"},"evidence":{"type":"array"},"next_action":{"type":"string"}}},"example":{"ok":true,"score":82,"verdict":"use_with_cap","evidence":[{"check":"live_402","status":"pass"}],"next_action":"pay once under cap, then measure result quality"}}},"description":"Paid x402 answer"},"402":{"description":"x402 Payment Required"}},"description":"paid x402 endpoint: send one specific request and receive a machine-usable verdict/result with evidence, next action, and freshness.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["resource"],"properties":{"resource":{"type":"string"},"budget_usdc":{"type":"number"}}},"example":{"resource":"https://example.com/v1/paid","budget_usdc":0.25}}},"required":true},"x-payment-info":{"asset":"USDC","payTo":"0x1664530DC2A1CA350B1dbaD1Fc1F1a70c90fe4de","amount":"80000","network":"eip155:8453","protocol":"x402","resource":"https://example.com/v1/paid"}}}}},"product_shape":"one_listing_in_copy_paste_schema_example_patch_out","buyer_decision":{"reason":"missing input_schema, output_schema, input_example, output_example, description","decision":"fix_examples_before_listing","expected_next_move":"apply patch_payload, re-register once, then capture readback"},"found_in_graph":false,"topdog_pattern":{"pricing_shape":"low repeat utility or explicit high-ticket fulfillment","request_shape":"one narrow object","metadata_shape":"schema plus request/response examples","response_shape":"concrete score/verdict/result"},"current_examples":{"input_schema":null,"input_example":null,"output_schema":null,"output_example":null},"execution_policy":{"stop_conditions":["unpaid route does not return 402","requestBody schema missing","input/output examples disappear","payTo/amount/resource mismatch"],"measurement_gate":"fresh registry readback plus one preview or paid call with source=api_example_doctor","apply_once_then_measure":true},"measurement_gate":"fresh registry readback plus one preview or paid call with source=api_example_doctor","recommended_action":"patch examples/schema, then re-register and run listing_rank_doctor","rewritten_listing_copy":"paid x402 endpoint: send one specific input, receive a machine-usable verdict/result with evidence, freshness, and the next action an agent can execute."}},"exampleRequest":{"limit":10,"query":"artificial intelligence API","category":"technology"},"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2tDn33TVkpc9zA4t8SZr0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes an x402 resource against top-earning examples and returns missing request/response examples, listing copy improvements, schema patches, and a measurable quality gate for sellers.","exampleAgentPrompt":"Look at my x402 API at https://myservice.example.com/v1/summarize and compare it against top-earning examples — tell me exactly which request/response examples I'm missing, what listing copy to fix, and what schema patches I need to pass the polish gate.","exampleUseCases":null,"resultDescription":"Returns a structured report containing: specific missing request/response examples to add, rewritten or improved listing copy, concrete schema patches (diffs), and a measurable polish gate assessment indicating what remains before the resource meets top-earner quality standards.","failureModes":["Invalid or unreachable x402 resource URL returns an error with no analysis","Malformed schema input may result in partial analysis with warnings","Payment failure (0.08 USDC on Base) results in 402 response before processing begins","Resource with insufficient metadata may return incomplete recommendations"],"whenToPreferThis":"Use this endpoint when you are an x402 API seller wanting to benchmark your listing against top-earning resources and receive actionable, specific improvements — especially when you need concrete example payloads, schema fixes, and listing copy rather than general keyword or category-level advice. Prefer this over keyword visibility or gap reports when the goal is polishing a specific existing resource rather than discovering new opportunities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:44.661Z","isFirstParty":false}