{"uid":"cap_SwFr9Zr0IpRmFw1BtGK6O","slug":"x402stock-xyz-d38293f0","name":"x402stock.xyz Stock Snapshot","description":"Single-call snapshot of a ticker's current state: last quote, last trade, today's OHLC + volume + VWAP, previous-day OHLC, today's change vs previous close. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.","url":"https://x402stock.xyz/api/v1/snapshot/AAPL","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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"data":{"day":{"low":289.59,"high":297,"open":293.72,"vwap":294.1141,"close":295.63,"volume":42572456},"change":4.259999999999991,"previous_day":{"low":287.38,"high":294.75,"open":290.74,"vwap":291.412,"close":291.58,"volume":52793266.201966},"change_percent":1.4610055559366182,"last_minute_bar":{"low":295.8,"high":295.85,"open":295.8,"vwap":295.848,"close":295.84,"volume":7332,"timestamp":"2026-06-11T23:59:00.000Z","trade_count":39,"accumulated_volume":42572456}},"as_of":"2026-06-12T00:00:00.000Z","source":"x402stock","ticker":"AAPL"}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w8R0vWZ6Z1iqztxPi01pj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 for a given US equity ticker including OHLCV bars, last trade, last quote, and price change data.","exampleAgentPrompt":"Pull up the current market snapshot for AAPL — I want the latest trade price, bid/ask quote, today's OHLCV, and the percentage change from yesterday.","exampleUseCases":null,"resultDescription":"A JSON object containing the ticker symbol, data source, and as-of timestamp, along with nested objects for: today's OHLCV bar (open, high, low, close, volume, vwap), previous day's OHLCV, last trade (price, size, exchange ID, timestamp, conditions), last quote (bid price, bid size, ask price, ask size, timestamp), last minute bar, and price change/change percent values.","failureModes":["Invalid or unknown ticker symbol returns an error or empty data","Market closed may result in stale or null last trade/quote timestamps","Rate limit exceeded if too many calls are made in rapid succession","Payment failure (x402 protocol) if USDC balance is insufficient — returns 402 status","Truncated or missing fields if data is unavailable for a given ticker on that day"],"whenToPreferThis":"Use this endpoint when you need a comprehensive real-time snapshot of a single US equity ticker, including both OHLCV bars and live trade/quote data in one call. Prefer over alternatives when you need bid/ask spread, last trade conditions, and previous-day comparison data together. Best for agents monitoring individual stocks or answering 'what is this stock doing right now' queries. The x402 micropayment model at $0.01 USDC per call makes it cost-effective for on-demand single-ticker lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-09-02T01:59:00.144Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:44:45.239Z","isFirstParty":false}