{"uid":"cap_hVyNTBMh6ZcupdBrv3q99","slug":"x402-market-buy-advisor-c4438b07","name":"x402 Market Buy Advisor","description":"24 paid x402 infrastructure APIs for AI agent fleets: buy advisor, audition coach, guard, proxy, MPP, attestations, and pipeline orchestration.","url":"https://x402-agent-suite-production.up.railway.app/api/market/buy-advisor","method":"POST","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","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","ok","allowed","summary","intent","checkedAt","recommendation","quotes","policy"],"properties":{"ok":{"type":"boolean"},"intent":{"type":"string"},"policy":{"type":"object","required":["evaluated","allowed","summary"],"properties":{"allowed":{"type":"boolean"},"summary":{"type":"string"},"evaluated":{"type":"boolean"}}},"quotes":{"type":"array","items":{"type":"object","required":["rank","name","allInCostUsdc","requiresPayment"],"properties":{"name":{"type":"string"},"rank":{"type":"number"},"allInCostUsdc":{"type":"number"},"requiresPayment":{"type":"boolean"}}}},"status":{"type":"string"},"allowed":{"type":"boolean"},"summary":{"type":"string"},"checkedAt":{"type":"string"},"recommendation":{"type":"object","required":["action","url","network","allInCostUsdc","confidence","rationale"],"properties":{"url":{"type":"string"},"action":{"type":"string"},"network":{"type":"string"},"rationale":{"type":"string"},"confidence":{"type":"number"},"allInCostUsdc":{"type":"number"}}}}}}}}},"responseSchema":{"type":"json","example":{"quotes":[{"name":"Example API","rank":1,"allInCostUsdc":0.05}],"recommendation":{"action":"pay_external","confidence":0.85}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F6G6Lxlhu0wpXpcL9osig","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates a planned API purchase request and returns ranked quotes plus a buy/skip recommendation with confidence score for AI agents spending USDC on x402 markets.","exampleAgentPrompt":"Before my agent pays for that x402 GET call to the weather endpoint, check the buy advisor — get me ranked quotes and tell me if it should pay or skip, including the all-in USDC cost and confidence level.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: a list of ranked quotes (provider name, rank, all-in cost in USDC, whether payment is required), a top recommendation (action like 'pay_external', URL, network, all-in cost, confidence score 0–1, rationale), a policy evaluation (allowed boolean, summary), and a status/summary string with a checkedAt timestamp.","failureModes":["Missing required 'input.type' or 'input.method' fields returns validation error","Unsupported HTTP method (POST/PUT/PATCH) rejected by enum constraint","No quotes available if target endpoint is unreachable or not listed on x402 markets","Payment of $0.08 USDC required before response is returned; missing payment returns 402","Low confidence recommendation if market data is sparse or stale"],"whenToPreferThis":"Use this endpoint when an AI agent needs to make a cost-aware purchasing decision before executing a paid x402 API call — particularly when comparing multiple providers, enforcing spend policies, or maximizing confidence that the payment is justified. Prefer over blind payment when budget management or policy compliance matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:47.995Z","isFirstParty":false}