{"uid":"cap_TofUU90iAYeMjr3RgpkpQ","slug":"x402-dev-tools-discovery-document-generator-00336fbf","name":"x402 Dev Tools – Discovery Document Generator","description":"Generates the discovery documents directories and agents read for a list of paid endpoints (up to 100): an OpenAPI 3.1 document with x-payment-info prices and examples, the /.well-known/x402 resource list and an llms.txt, in the shape x402scan and the CDP Bazaar index.","url":"https://dev.kagurazaka.dev/v1/discovery?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string"},"origin":{"type":"string","description":"the https origin the API is served from"},"category":{"type":"string","description":"default API"},"guidance":{"type":"string","description":"how an agent should call the API"},"endpoints":{"type":"array","description":"each {method: GET|POST, path, price_usd, summary, description, tags, input_example, input_schema, output_example}"},"description":{"type":"string"}}},"responseSchema":{"type":"json","example":{"openapi":{"info":{"title":"Weather API"},"paths":{},"openapi":"3.1.0"},"llms_txt":"# Weather API\n\n> Current weather for any city.\n...","well_known":{"version":1,"resources":["https://api.example.com/v1/weather"]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VhjS3ynkp8UIMhTqCeqYz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates OpenAPI 3.1, /.well-known/x402, and llms.txt discovery documents for a list of paid x402 API endpoints","exampleAgentPrompt":"Generate the full x402 discovery bundle for my weather API at https://api.weatherco.com — it has one GET endpoint /v1/weather at $0.001, takes a city name, returns temperature and conditions. I need the OpenAPI 3.1 doc with x-payment-info, the /.well-known/x402 resource list, and the llms.txt.","exampleUseCases":[{"title":"Bootstrapping a new paid API's discoverability","prompt":"I just launched a paid API at https://api.myfinance.dev — it has two POST endpoints: /v1/quote at $0.002 and /v1/portfolio at $0.005. Can you generate the OpenAPI 3.1 doc with x402 payment extensions, the /.well-known/x402 file, and an llms.txt so x402scan and the CDP Bazaar can index it?"},{"title":"Publishing multi-endpoint agent marketplace listing","prompt":"I need to list my image generation API on the CDP Bazaar and x402scan. The API lives at https://api.imagestudio.io and has three endpoints: POST /v1/generate at $0.01, POST /v1/upscale at $0.005, and GET /v1/status at $0. Please produce all the x402 discovery documents — OpenAPI with pricing, well-known resource list, and llms.txt."},{"title":"Refreshing discovery docs after adding new endpoints","prompt":"My API at https://api.dataenrich.co added two new paid endpoints: POST /v1/enrich at $0.003 and POST /v1/validate at $0.001. Regenerate the OpenAPI 3.1 spec with x-payment-info, the /.well-known/x402 JSON, and the llms.txt so agents can find the updated pricing and schemas."}],"resultDescription":"Returns a JSON object containing three discovery artifacts: (1) a complete OpenAPI 3.1 document with x-payment-info extensions listing prices and examples for each endpoint, (2) a /.well-known/x402 JSON resource list with versioned endpoint URLs, and (3) an llms.txt file in the format expected by x402scan and the CDP Bazaar agent index.","failureModes":["Missing or invalid origin URL returns validation error","Endpoint list exceeding 100 items rejected","Malformed endpoint objects missing required fields like method or path cause partial or failed generation","Invalid price_usd values (negative or non-numeric) may cause schema errors","Unreachable or non-HTTPS origin may fail validation","Payment of $0.003 USDC required per call; insufficient payment results in 402 response"],"whenToPreferThis":"Use this endpoint when you need to produce all three x402 discovery artifacts (OpenAPI, /.well-known/x402, llms.txt) in one call, formatted specifically for x402scan and CDP Bazaar indexing. Prefer it over manually writing OpenAPI specs when you want automatic x-payment-info extension injection and agent-readable output. Ideal for API sellers onboarding to the x402 ecosystem who want immediate discoverability without hand-crafting multiple document formats.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:32:35.277Z","isFirstParty":false,"canonicalSlug":"x402-dev-tools-discovery-document-generator-00336fbf"}