{"uid":"cap_JPHh1NkOmLwARzbyF3cQw","slug":"x402-bazaar-rank-seller-endpoint-ec643cc6","name":"x402 Bazaar Rank – Seller Endpoint","description":"Use when an agent needs an x402 seller rank or dossier. Returns Seller dossier by hostname (?host=api.example.com): that seller's x402 routes with 30-day calls and paying wallets, price ladder, networks and market share; without ?host — the top sellers by paying wallets.","url":"https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/seller?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","HEAD"],"type":"string"},"queryParams":{"type":"object","properties":{"host":{"type":"string","description":"seller hostname, e.g. api.example.com; omit for the top sellers by paying wallets"},"limit":{"type":"integer","default":25,"maximum":96,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["generatedAt","host","resources","calls30d","payers30d","callsPerPayer","priceLadderUsd","priceMinUsd","priceMaxUsd","networks","marketShareOfPayers","readByP0","walletsMeasured","matched","demand","routes"],"properties":{"host":{"type":"string"},"demand":{"type":"object","properties":{"note":{"type":"string"},"available":{"type":"boolean"}}},"routes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"network":{"type":"string"},"calls30d":{},"priceUsd":{"type":"number"},"resource":{"type":"string"},"payers30d":{},"verifiedByP0":{"type":"boolean"}}}},"matched":{"type":"number"},"calls30d":{},"networks":{"type":"array","items":{"type":"string"}},"readByP0":{"type":"boolean"},"payers30d":{},"resources":{"type":"number"},"generatedAt":{"type":"string"},"priceMaxUsd":{"type":"number"},"priceMinUsd":{"type":"number"},"callsPerPayer":{},"priceLadderUsd":{"type":"array","items":{"type":"number"}},"walletsMeasured":{"type":"number"},"marketShareOfPayers":{}}}}}}},"responseSchema":{"type":"json","example":{"host":"api.example.com","demand":{"note":"demand figures (calls and paying wallets over 30 days) return after our on-chain measurement is live","available":false},"routes":[{"name":"forecast api","tags":["weather-geo"],"network":"eip155:8453","calls30d":null,"priceUsd":0.01,"resource":"https://api.example.com/forecast","payers30d":null,"verifiedByP0":true}],"matched":1,"calls30d":null,"networks":["eip155:8453"],"readByP0":true,"payers30d":null,"resources":1,"generatedAt":"2026-10-26T12:00:00.000Z","priceMaxUsd":0.01,"priceMinUsd":0.01,"callsPerPayer":null,"priceLadderUsd":[0.01],"walletsMeasured":0,"marketShareOfPayers":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SLp0WROZhJjFI2Sol-nen","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked discovery data for a specific seller (or top sellers) on the x402 service market, including 30-day call volume, paying-wallet counts, and pricing metadata.","exampleAgentPrompt":"Show me the top 10 x402 sellers ranked by paying wallets and call volume over the last 30 days, and include price range info.","exampleUseCases":[{"title":"Discover highest-traffic x402 APIs","prompt":"What are the top 25 x402 API sellers right now, ranked by how many paying wallets they have? I want to see their call volume and price ranges too."},{"title":"Profile a specific x402 seller","prompt":"Pull up the x402 bazaar rank data for api.example.com — I want to see how many calls they got in the last 30 days, how many unique payers, and what routes they expose."},{"title":"Market share analysis for x402 ecosystem","prompt":"Give me a ranked list of x402 sellers with their market share of paying wallets so I can figure out who dominates the ecosystem right now."}],"resultDescription":"A JSON object containing the seller's hostname, their ranked list of routes (with per-route 30-day call count, price, payers, and network), aggregate 30-day calls and payers, price min/max/ladder, calls-per-payer ratio, market share of payers, total matched resources, and a signed receipt with snapshot hash and scoring revision timestamp.","failureModes":["Invalid or unknown seller hostname returns empty or zero-match result","Limit parameter out of range (1–96) returns validation error","Stale snapshot data if the index has not refreshed recently","Network timeout if the Cloudflare Worker is under load","Payment failure ($0.05 USDC) blocks the request before any data is returned"],"whenToPreferThis":"Use this endpoint when you need ranked, real-usage-backed discovery of x402-protocol API sellers — especially when you want on-chain call volume and paying-wallet counts rather than self-declared metadata. Prefer it over generic API directories when the goal is to find high-traction x402 services or to audit a specific seller's market performance with a verifiable snapshot receipt.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-22T12:31:19.274Z","isFirstParty":false,"canonicalSlug":"x402-bazaar-rank-seller-endpoint-ec643cc6"}