{"uid":"cap_ypD5tg94YoyXH01dT17Ts","slug":"x402stock-xyz-6fa78a1e","name":"x402stock Unified Snapshot (Multi-Ticker)","description":"Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request. From x402stock, a market & economic data API (x402, USDC).","url":"https://x402stock.xyz/api/v1/unified-snapshot","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","required":["tickers"],"properties":{"tickers":{"type":"string","minLength":1}},"additionalProperties":false}},"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"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"source":{"type":"string","const":"x402stock"},"tickers":{"type":"array","items":{"type":"object","required":["ticker","name","market_status","price","change","change_percent","day","previous_close","updated"],"properties":{"day":{"anyOf":[{"type":"object","required":["open","high","low","close","volume","vwap"],"properties":{"low":{"anyOf":[{"type":"number"},{"type":"null"}]},"high":{"anyOf":[{"type":"number"},{"type":"null"}]},"open":{"anyOf":[{"type":"number"},{"type":"null"}]},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticker":{"type":"string"},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"previous_close":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-05-29T20:00:00.000Z","count":1,"source":"x402stock","tickers":[{"day":{"low":305.02,"high":310.94,"open":309.625,"vwap":307.97,"close":307.51,"volume":26924621},"name":"Apple Inc.","price":307.44,"change":-4.62,"ticker":"AAPL","updated":"2026-05-29T19:58:00.000Z","market_status":"open","change_percent":-1.48,"previous_close":312.06}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"tickers":"AAPL,MSFT,NVDA,TSLA,META"}},"output":{"type":"object"}},"response":{"as_of":"2026-06-02T04:33:12.897Z","count":5,"source":"x402stock","tickers":[{"day":{"low":305.02,"high":310.94,"open":309.625,"vwap":307.4113,"close":306.31,"volume":48849614},"name":"Apple Inc.","price":305.3988,"change":-6.66,"ticker":"AAPL","updated":"2026-06-02T00:15:01.636Z","market_status":"closed","change_percent":-2.13,"previous_close":312.06},{"day":{"low":458.27,"high":466.32,"open":464.84,"vwap":461.5527,"close":460.52,"volume":53628650},"name":"Microsoft Corp","price":452.39,"change":2.15,"ticker":"MSFT","updated":"2026-06-02T00:15:01.299Z","market_status":"closed","change_percent":0.478,"previous_close":450.24},{"day":{"low":215.7,"high":224.87,"open":215.73,"vwap":221.4919,"close":224.36,"volume":213845423},"name":"Nvidia Corp","price":223.92,"change":12.78,"ticker":"NVDA","updated":"2026-06-02T00:15:01.542Z","market_status":"closed","change_percent":6.053,"previous_close":211.14},{"day":{"low":415.43,"high":429.6,"open":427.49,"vwap":420.4891,"close":415.88,"volume":44937690},"name":"Tesla, Inc. Common Stock","price":413.5507,"change":-22.2,"ticker":"TSLA","updated":"2026-06-02T00:15:01.992Z","market_status":"closed","change_percent":-5.09,"previous_close":435.79},{"day":{"low":599.53,"high":635.7499,"open":630.4,"vwap":609.3833,"close":600.47,"volume":29138764},"name":"Meta Platforms, Inc. Class A Common Stock","price":600.61,"change":-31.9,"ticker":"META","updated":"2026-06-02T00:15:01.151Z","market_status":"closed","change_percent":-5.04,"previous_close":632.51}]}},"exampleRequest":{"tickers":"AAPL,MSFT,NVDA,TSLA,META"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.80","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ln5-0a0HSyTCLk5vp4k97","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real-time snapshot of price, day OHLCV, VWAP, change, and market session for up to 250 US-listed tickers in a single request.","exampleAgentPrompt":"Pull a live snapshot for AAPL, MSFT, NVDA, TSLA, and META — I want current price, today's open/high/low/close/volume, VWAP, day change and percent change, previous close, and what market session each is in.","exampleUseCases":null,"resultDescription":"A JSON object with a source label, as_of timestamp, and count, plus an array of per-ticker objects each containing: ticker symbol, company name, market status (pre/regular/post/closed), current price, day change and percent change, day OHLCV (open, high, low, close, volume) with VWAP, previous close, and last updated time. Null values are returned for fields unavailable outside market hours.","failureModes":["Missing or empty tickers parameter returns a 400 error","Invalid or unrecognized ticker symbols may return null price fields","Exceeding 250 tickers per request may result in a 400 or truncated response","Payment not included or insufficient USDC triggers a 402 Payment Required response","Service downtime or upstream data feed issues may return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need to price multiple US-listed tickers (up to 250) in a single API call — ideal for watchlist snapshots, portfolio valuation, or batch price checks. Prefer it over single-ticker endpoints when you have 2 or more symbols to avoid multiple round-trips and costs. Choose it when you need comprehensive intraday data (OHLCV + VWAP + change + market session) for each symbol simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1724,"lastUsedAt":"2026-06-10T14:20:23.775Z","lastSuccessfullyRanAt":"2026-06-10T03:06:16.900Z","lastHealthCheckAt":"2026-09-13T06:41:20.482Z","isFirstParty":false}