{"uid":"cap_KRQoHI0yYMF-PCsDYRYs6","slug":"agents-x402stock-xyz-x402stock-ticker-snapshot-a2b377c4","name":"x402stock Ticker Snapshot","description":"Returns a full ticker snapshot including last quote, last trade, OHLC, and prev close.","url":"https://agents.x402stock.xyz/api/v1/snapshot/{ticker}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","properties":{"day":{"type":"object","required":["open","high","low","close","volume"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"}},"additionalProperties":false},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"last_quote":{"type":"object","required":["bid_price","bid_size","ask_price","ask_size","timestamp"],"properties":{"ask_size":{"type":"number"},"bid_size":{"type":"number"},"ask_price":{"type":"number"},"bid_price":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"last_trade":{"type":"object","required":["price","size","exchange_id","timestamp","conditions"],"properties":{"size":{"type":"number"},"price":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"conditions":{"type":"array","items":{"type":"number"}},"exchange_id":{"type":"number"}},"additionalProperties":false},"previous_day":{"type":"object","required":["open","high","low","close","volume"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"}},"additionalProperties":false},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"last_minute_bar":{"type":"object","required":["open","high","low","close","volume","vwap","timestamp"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"trade_count":{"type":"number"},"accumulated_volume":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UW1ZT8hE2ITwfaBwUu2vP","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns a single-call real-time snapshot of a US stock ticker including last quote, last trade, today's OHLC/volume/VWAP, previous-day OHLC, and price change vs previous close.","exampleAgentPrompt":"What's the current snapshot for AAPL — last trade price, today's OHLC and VWAP, and how much it's up or down vs yesterday's close?","exampleUseCases":[{"title":"Real-time portfolio price check","prompt":"Can you pull the current price and today's change for TSLA, NVDA, and MSFT so I can see how my portfolio is doing right now?"},{"title":"Pre-trade bid-ask spread review","prompt":"Before I place an order, what's the current bid and ask for SPY and how wide is the spread?"},{"title":"Daily market open briefing","prompt":"Give me a quick morning snapshot of QQQ — yesterday's close, today's open, current price, and percent change so far."}],"resultDescription":"A JSON object containing: the ticker symbol, data source, and an 'as_of' timestamp. The 'data' field includes: last_quote (bid/ask price and size), last_trade (price, size, exchange ID, timestamp, conditions), day (open/high/low/close/volume/VWAP for today), previous_day (open/high/low/close/volume/VWAP), last_minute_bar (OHLCV + VWAP + trade count + accumulated volume for the most recent minute), change (absolute price change vs previous close), and change_percent.","failureModes":["Invalid or unknown ticker symbol returns an error or empty data","Ticker not US-listed may return no data","Market closed hours may return stale or null last_quote/last_trade timestamps","Payment failure via x402/USDC results in 402 response and no data","Truncated response schema may omit some optional fields if data is unavailable"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive real-time snapshot of a single US-listed stock in one call — covering quote, trade, OHLC, VWAP, and day-over-day change — without needing an API key. Ideal for agents that need to pay per-use in USDC and want all essential market state for a ticker in a single round-trip rather than calling separate quote, trade, and bar endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-10-01T01:40:28.522Z","lastSuccessfullyRanAt":"2026-10-01T01:40:28.522Z","lastHealthCheckAt":"2026-10-11T06:45:50.685Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-x402stock-ticker-snapshot-a2b377c4"}