{"uid":"cap_H-5JPozSRNRqsmIFO-vnl","slug":"list-smith-x402-route-grader-12d7c01b","name":"list-smith x402 Route Grader","description":"Grade one x402 route's Bazaar discovery metadata. Returns the diagnosis only: both x402 SDK validator verdicts, the schema-quality score, itemized defects with severities (hollow output schemas, over-500-char descriptions, wrong asset addresses, failed validation), and a 0-100 grade. Use this when you operate an x402 route and want to know exactly what is broken before paying for the repair.","url":"https://list-smith-production.up.railway.app/v1/grade?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"resource_url":{"type":"string","description":"Full URL of the x402 resource to grade, e.g. https://service.example.com/v1/endpoint"},"sample_output":{"description":"Optional: one real response body from the endpoint. When supplied, the grade also checks it against the endpoint's published output schema."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["resource_url","graded_at","reachable","http_status","x402_valid","terms","extension_present","sdk_validation","schema_quality","defects","score","fix_available"],"properties":{"score":{"type":"integer","maximum":100,"minimum":0,"description":"Listing grade: 100 (clean) to 0, from the itemized defects"},"terms":{"type":"object","required":["found","price_usdc","amount_units","network","asset","pay_to","scheme","x402_version"],"properties":{"asset":{"type":["string","null"]},"found":{"type":"boolean"},"pay_to":{"type":["string","null"]},"scheme":{"type":["string","null"]},"network":{"type":["string","null"]},"price_usdc":{"type":["string","null"]},"amount_units":{"type":["string","null"]},"x402_version":{"type":["integer","null"]}}},"defects":{"type":"array","items":{"type":"object","required":["name","severity","detail"],"properties":{"name":{"type":"string"},"detail":{"type":"string"},"severity":{"enum":["critical","major","minor"],"type":"string"}}}},"graded_at":{"type":"string","description":"ISO-8601 timestamp of the probe"},"reachable":{"type":"boolean"},"x402_valid":{"type":"boolean"},"http_status":{"type":["integer","null"]},"resource_url":{"type":"string"},"fix_available":{"type":"boolean","description":"True when the endpoint presents a valid challenge /v1/fix can repair against"},"schema_quality":{"type":"object","required":["extension_present","hollow","score","deductions"],"properties":{"score":{"type":["integer","null"]},"hollow":{"type":["boolean","null"]},"deductions":{"type":"array","items":{"type":"object","required":["name","points","detail"],"properties":{"name":{"type":"string"},"detail":{"type":"string"},"points":{"type":"integer","minimum":0}}}},"extension_present":{"type":"boolean"}}},"sdk_validation":{"type":"object","required":["ran","consistency_valid","spec_valid","errors"],"properties":{"ran":{"type":"boolean","description":"False when there was no extension to validate"},"errors":{"type":"array","items":{"type":"string"}},"spec_valid":{"type":["boolean","null"]},"consistency_valid":{"type":["boolean","null"]}}},"extension_present":{"type":"boolean"}}},"example":{"score":88,"terms":{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","found":true,"pay_to":"0x1111111111111111111111111111111111111111","scheme":"exact","network":"eip155:8453","price_usdc":"$0.02","amount_units":"20000","x402_version":2},"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"}],"graded_at":"2026-10-21T21:38:16.618483+00:00","reachable":true,"x402_valid":true,"http_status":402,"resource_url":"https://target.example.com/v1/thing","fix_available":true,"schema_quality":{"score":55,"hollow":true,"deductions":[{"name":"hollow output (example only, no 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.","points":45}],"extension_present":true},"sdk_validation":{"ran":true,"errors":[],"spec_valid":true,"consistency_valid":true},"extension_present":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XkiPVEZ30IwHZqxVbdyrD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Probes and grades an x402 route's Bazaar discovery metadata, returning a 0-100 score with itemized defects and SDK validator verdicts.","exampleAgentPrompt":"Grade my x402 route at https://service.example.com/v1/endpoint and tell me exactly what's broken — I want the score, every defect with its severity, and whether it's fixable.","exampleUseCases":[{"title":"Pre-listing metadata audit","prompt":"Before I submit my x402 route at https://myapi.example.com/v1/data to Bazaar, can you grade it and show me every defect — hollow schemas, bad asset addresses, description length issues — and the overall score?"},{"title":"Debugging a low Bazaar score","prompt":"My x402 route at https://payments.example.com/v1/reports keeps getting a poor discovery grade — can you run a full diagnosis on it and tell me what's dragging the score down?"},{"title":"Validating SDK compliance with sample output","prompt":"Grade my x402 endpoint at https://api.example.com/v1/prices and check this sample response body against its published output schema: {\"price\": 1.23, \"currency\": \"USD\"} — I need to know if it passes both SDK validators."}],"resultDescription":"Returns a JSON object containing: the 0-100 listing grade, a reachability flag, HTTP status, x402 validity boolean, parsed payment terms (price, network, asset, pay_to, scheme, version), SDK validation results (ran, spec_valid, consistency_valid, errors), schema quality report (score, hollow flag, deductions), an array of itemized defects each with name/severity/detail, a graded_at ISO-8601 timestamp, and a fix_available boolean indicating whether the companion /v1/fix endpoint can repair the route.","failureModes":["Resource URL unreachable: reachable=false, http_status null, score likely 0","No x402 challenge found: x402_valid=false, terms.found=false, SDK validation skipped","Hollow output schema detected: major defect logged, schema_quality.hollow=true, points deducted","Description over 500 chars: minor defect flagged with detail","Wrong or invalid asset address: critical defect with specific address mismatch detail","SDK spec or consistency validation failure: sdk_validation errors array populated","Malformed input URL: HTTP 400 or unreachable result"],"whenToPreferThis":"Choose this endpoint when you operate an x402 route and need a precise, itemized diagnosis of its Bazaar discovery metadata quality before paying for a repair. It is read-only (diagnosis only, no side effects) and returns structured defect data with severities — ideal for automated CI checks or pre-listing audits. Use the sibling /v1/fix endpoint only after reviewing this grade report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:31:48.858Z","isFirstParty":false,"canonicalSlug":"list-smith-x402-route-grader-12d7c01b"}