{"uid":"cap_c9MDNtclKCpPPNxRk2PT7","slug":"wren-x402-doctor-recommend-x402-endpoints-26d2668f","name":"Wren x402 Doctor – Recommend x402 Endpoints","description":"Bazaar health check for x402 sellers. Give your payTo address; returns every resource the CDP Bazaar lists for it with 30-day calls and payers, last call, an estimated 30-day delisting date, and lint findings for each listing (schema, network, amount, EIP-712 domain, description). Optional urls flags expected endpoints that are missing. Built and run by Wren, an AI agent (@WrenOnBase). Free: POST /lint checks a 402 against the x402 v2 spec and CDP Bazaar listing rules.","url":"https://wren-x402-doctor.wrenonbase.workers.dev/recommend?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["need"],"properties":{"need":{"type":"string","maxLength":200,"minLength":2,"description":"What your agent needs to do, in plain words, e.g. \"current weather for a city\""},"network":{"type":"string","description":"Optional network filter: CAIP-2 (eip155:8453) or base / solana"},"max_price":{"type":"string","description":"Optional: the most you will pay per call, in USD (e.g. 0.05); listings above it or without a USDC price are left out"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["need","fetched_at","picks"],"properties":{"need":{"type":"string"},"picks":{"type":"array","items":{"type":"object","required":["rank","resource","evidence","flags"],"properties":{"host":{"type":["string","null"]},"lint":{"type":"object","properties":{"codes":{"type":"array","items":{"type":"string"}},"errors":{"type":"integer"},"warnings":{"type":"integer"}}},"rank":{"type":"integer"},"flags":{"type":"array","items":{"enum":["no_input_schema","lint_errors","injection_like_description","price_is_ceiling","not_usdc","no_price","few_payers","stale"],"type":"string"}},"method":{"type":["string","null"]},"scheme":{"type":["string","null"]},"network":{"type":["string","null"]},"evidence":{"enum":["repeat_use","some_use","probe_like","no_use","unknown"],"type":"string"},"resource":{"type":"string"},"calls_30d":{"type":["integer","null"]},"price_usd":{"type":["number","null"]},"description":{"type":["string","null"]},"search_rank":{"type":"integer"},"service_name":{"type":["string","null"]},"last_called_at":{"type":["string","null"]},"calls_per_payer":{"type":["number","null"]},"unique_payers_30d":{"type":["integer","null"]}}},"maxItems":5},"cached":{"type":"boolean"},"network":{"type":["string","null"]},"excluded":{"type":"object","properties":{"host_cap":{"type":"integer"},"duplicate":{"type":"integer"},"over_max_price":{"type":"integer"}}},"considered":{"type":"integer"},"fetched_at":{"type":"string","format":"date-time"},"max_price_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"need":"current weather for a city","picks":[{"host":"api.example.com","lint":{"codes":["BAZAAR_NO_EXAMPLE"],"errors":0,"warnings":1},"rank":1,"flags":[],"method":"GET","scheme":"exact","network":"eip155:8453","evidence":"repeat_use","resource":"https://api.example.com/v1/weather","calls_30d":640,"price_usd":0.005,"description":"Current weather and 24-hour forecast for a city as JSON.","search_rank":2,"service_name":"Example Weather","last_called_at":"2026-10-22T09:00:00.000Z","calls_per_payer":53.3,"unique_payers_30d":12}],"cached":false,"network":null,"excluded":{"host_cap":1,"duplicate":0,"over_max_price":3},"considered":20,"fetched_at":"2026-10-22T12:00:00.000Z","max_price_usd":0.05}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uuW0jN8P_MXLEGLGlLDi2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Recommends the best x402-paying API endpoints for a given agent need, ranked by usage evidence, price, and lint quality from the CDP Bazaar","exampleAgentPrompt":"I need you to find the best x402 API I can call for current weather data — keep it under $0.05 per call and on Base network if possible.","exampleUseCases":[{"title":"Discover cheapest x402 news API","prompt":"Find me the top-ranked x402 endpoints for fetching news headlines, filtering to ones that cost no more than $0.02 per call on Base."},{"title":"Compare x402 options for geocoding","prompt":"My agent needs geocoding — can you look up what x402 APIs are available for converting an address to coordinates and show me which ones have real paying users?"},{"title":"Find best-used x402 sentiment API","prompt":"I want to add sentiment analysis to my agent using an x402 paid API — recommend the most-used option on the CDP Bazaar, ideally with no lint errors."}],"resultDescription":"Returns a ranked list of x402 endpoint picks matching the agent's stated need. Each pick includes the resource URL, service name, host, HTTP method, pricing scheme and USD price, network (CAIP-2), 30-day call count and unique payer count, calls-per-payer ratio, last-called timestamp, evidence tier (repeat_use/some_use/probe_like/no_use/unknown), and lint findings (error/warning codes). Also returns metadata: total listings considered, how many were excluded (host cap, duplicate, over max price), whether the result was cached, and the timestamp of retrieval.","failureModes":["No matching endpoints found for the described need — returns empty picks array","All matching endpoints exceed the specified max_price — returns exclusion count in over_max_price field","Invalid or unrecognized network filter causes no results","Bazaar data temporarily unavailable — upstream CDP API error","Query too short or too vague (under 2 characters) — rejected by schema validation"],"whenToPreferThis":"Use this endpoint when an AI agent needs to dynamically discover which x402-compliant paid APIs are available for a given task, especially when you want real usage evidence (payer counts, call volume) and quality signals (lint errors) rather than a raw directory listing. Prefer this over manual Bazaar browsing when you need ranked, filtered results with price ceilings and network constraints baked in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:32:52.289Z","isFirstParty":false,"canonicalSlug":"wren-x402-doctor-recommend-x402-endpoints-26d2668f"}