{"uid":"cap_X5QCKi52ob7XHrDb1yppr","slug":"x402-buyer-shortlist-tool-0a961af1","name":"x402 Buyer Shortlist Tool","description":"Fetch x402 discovery documents, rank matching resources by advertised price, live-check the cheapest candidates with 402 quote inspection, and return a buyer-ready shortlist with verified amount, scheme, network, payTo, tags, and warnings. This deterministic endpoint does not call an upstream model. GET variant for agents, crawlers, and wallets that prefer query parameters over a JSON body. Pay up to $0.005 per request with x402 USDC on Base.","url":"https://gpt55.558686.xyz/v1/tools/x402-buyer-shortlist","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","anyOf":[{"required":["urls"]},{"required":["origins"]},{"required":["discovery_urls"]}],"properties":{"urls":{"type":"array","items":{"type":"string","maxLength":2048,"minLength":1},"maxItems":10,"minItems":1},"limit":{"type":"integer","maximum":100,"minimum":1},"query":{"type":"string","maxLength":120},"origins":{"type":"array","items":{"type":"string","maxLength":2048,"minLength":1},"maxItems":10,"minItems":1},"max_bytes":{"type":"integer","maximum":1048576,"minimum":4096},"timeout_ms":{"type":"integer","maximum":12000,"minimum":1000},"verify_limit":{"type":"integer","maximum":10,"minimum":1},"discovery_urls":{"type":"array","items":{"type":"string","maxLength":2048,"minLength":1},"maxItems":10,"minItems":1}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ok":{"type":"boolean"},"tool":{"type":"string"},"fetchedAt":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"origins":["https://api.example1.com","https://api.example2.com","https://api.example3.com"],"timeout_ms":5000,"verify_limit":3}}},"response":{"ok":false,"tool":"x402BuyerShortlist","query":null,"warnings":["No valid x402 discovery documents were fetched.","No priced resources were found.","No HTTP resource URLs were available for live quote verification.","No candidate passed live x402 quote verification."],"documents":[{"ok":false,"error":"`url` host could not be resolved","origin":"https://api.example1.com","status":0,"inputUrl":"https://api.example1.com/","serviceName":null,"discoveryUrl":"https://api.example1.com/.well-known/x402","resourceCount":0},{"ok":false,"error":"`url` host could not be resolved","origin":"https://api.example2.com","status":0,"inputUrl":"https://api.example2.com/","serviceName":null,"discoveryUrl":"https://api.example2.com/.well-known/x402","resourceCount":0},{"ok":false,"error":"HTTP 301 non-json","origin":"https://api.example3.com","status":0,"inputUrl":"https://api.example3.com/","serviceName":null,"discoveryUrl":"https://api.example3.com/.well-known/x402","resourceCount":0}],"fetchedAt":"2026-06-12T05:16:13.943Z","shortlist":[],"inputCount":3,"usableCount":0,"candidateCount":0,"validDocuments":0,"cheapestVerified":null,"cheapestAdvertised":null}},"exampleRequest":{"limit":10,"origins":["https://api.example1.com","https://api.example2.com","https://api.example3.com"],"timeout_ms":5000,"verify_limit":3},"tags":["x402"],"displayCostAmount":"0.005","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hUA_8LG1eYk_bTgliB2hC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a live-verified shortlist of x402-compatible buyer endpoints or origins by probing provided URLs, origins, or discovery URLs for x402 payment support.","exampleAgentPrompt":"Can you give me a live-verified shortlist of x402-compatible buyer endpoints from these three origins: https://api.example1.com, https://api.example2.com, and https://api.example3.com — limit to 10 results and use a 5-second timeout?","exampleUseCases":[{"title":"Find cheapest x402-enabled API","prompt":"I have a list of candidate API endpoints and I want to know which ones actually support x402 payments right now — can you probe these URLs for me and return only the verified ones, ranked by their advertised price from cheapest to most expensive?"},{"title":"Route payments to verified endpoints","prompt":"Before my agent makes any micropayments, I need to confirm which of these origins are actually live and x402-compatible. Can you check https://service-a.io, https://service-b.io, and https://service-c.io and give me a buyer-ready shortlist with their payment amounts, networks, and payTo addresses?"},{"title":"Audit x402 support across services","prompt":"I'm building an x402-aware workflow and I have about a dozen candidate service URLs I found in a discovery document — can you probe all of them for x402 USDC support on Base and tell me which ones pass the live check, along with any warnings I should know about?"}],"resultDescription":"Returns a JSON object with an 'ok' boolean, the tool name 'x402BuyerShortlist', a summary string confirming live-verified results, and additional fields describing which of the submitted URLs or origins were confirmed to support x402 payments.","failureModes":["No URLs, origins, or discovery_urls provided — request will fail schema validation","URLs exceed 2048 character limit per item","More than 10 items submitted in any array — rejected by schema","timeout_ms out of range (must be 1000-12000) — validation error","Payment not completed via x402 USDC — 402 response returned, endpoint not called","Submitted URLs are unreachable or return non-x402 responses — empty or partial shortlist returned"],"whenToPreferThis":"Use this endpoint when you need to programmatically discover and verify which of a set of candidate URLs or origins actively support x402 micropayment flows. It is distinct from general URL fetching — it specifically probes for x402 buyer compatibility and returns a curated, live-verified shortlist. Prefer this over manual probing or generic HTTP tools when building x402-aware agent workflows that need to dynamically route payments to verified endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T17:25:21.054Z","isFirstParty":false}