{"uid":"cap_E0xwuM2n_YMQ6HjmC6SEY","slug":"x402stock-compare-multi-stock-7f42ab1b","name":"x402stock Compare Multi-Stock","description":"Compare 2 to 3 US-listed stocks side by side (peer or watchlist comparisons). Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (1 to 3 symbols). Returns price and day change, market cap, P/E, EPS, revenue, gross and net margins, and dividend yield per ticker. Built for multiple stocks — for a single stock, `/api/v1/quote/{ticker}` is cheaper. From x402stock","url":"https://x402stock.vercel.app/api/v1/compare","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","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"tickers":{"type":"string"}},"additionalProperties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","count","tickers","rows"],"properties":{"note":{"type":"string"},"rows":{"type":"array","items":{"type":"object","required":["ticker","name","price","change_percent","market_cap","pe_ratio","eps","revenue","gross_margin_percent","net_margin_percent","dividend_yield_percent","available"],"properties":{"eps":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticker":{"type":"string"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"available":{"type":"string"},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"gross_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"dividend_yield_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"as_of":{"type":"string"},"count":{"type":"number"},"source":{"type":"string","const":"x402stock"},"tickers":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_T04G3lV-I0jH2RBi7yuFw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches side-by-side fundamental and price data for 1–3 US-listed stocks in a single call, returning price, day change, market cap, P/E, EPS, revenue, margins, and dividend yield per ticker.","exampleAgentPrompt":"Compare AAPL, MSFT, and NVDA side by side — I want to see their price, P/E ratio, EPS, revenue, gross and net margins, and dividend yield all at once.","exampleUseCases":[{"title":"Tech stock peer comparison","prompt":"Can you compare AAPL, MSFT, and NVDA side by side? I want to see their P/E ratios, EPS, gross margins, and market caps so I can decide which looks most attractive."},{"title":"Dividend yield watchlist check","prompt":"Show me the dividend yield, net margin, and current price for JNJ, PFE, and MRK — I'm building a dividend-focused watchlist and want to compare them."},{"title":"Sector benchmark before earnings","prompt":"Before AMD reports earnings, can you pull a quick comparison of AMD vs INTC vs QCOM covering revenue, EPS, P/E, and market cap?"}],"resultDescription":"Returns a JSON object with a rows array where each entry corresponds to one ticker and includes: ticker symbol, company name, current price, day change percent, market cap, P/E ratio, EPS, trailing revenue, gross margin percent, net margin percent, dividend yield percent, and an availability flag. Also includes source attribution, timestamp (as_of), and count of tickers returned.","failureModes":["Invalid or unrecognized ticker symbol returns null values or missing rows","More than 3 tickers passed may be rejected or truncated","Network timeout on Vercel cold start causing delayed response","Stale or missing data for thinly traded or recently delisted stocks","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to compare 2–3 US stocks simultaneously on both price and fundamental metrics in a single API call. It is purpose-built for peer or watchlist comparisons and returns a comprehensive set of financial data per ticker. For a single stock, the cheaper /api/v1/quote/{ticker} endpoint is preferred. For more than 3 tickers, a different bulk data source should be used.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:45:17.026Z","isFirstParty":false}