{"uid":"cap_QNE57a_UtPReTFGkIwzXK","slug":"x402stock-candlestick-frames-ohlcv-historical-bars-6bc23afa","name":"x402stock Candlestick Frames (OHLCV Historical Bars)","description":"Compare one financial metric across every public company for a single period","url":"https://agents.x402stock.xyz/api/v1/frames?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["tag","period"],"properties":{"tag":{"type":"string","minLength":1},"unit":{"type":"string","default":"USD"},"limit":{"type":"integer","default":50,"maximum":500,"exclusiveMinimum":0},"period":{"type":"string","pattern":"^CY\\d{4}(Q[1-4]I?)?$"},"taxonomy":{"type":"string","default":"us-gaap"}}},"responseSchema":{"type":"object","required":["source","as_of","tag","taxonomy","label","unit","period","total_filers","count","data"],"properties":{"tag":{"type":"string"},"data":{"type":"array","items":{"type":"object","required":["cik","entity","value","start","end","accession"],"properties":{"cik":{"type":"string"},"end":{"type":"string"},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"entity":{"type":"string"},"accession":{"type":"string"}},"additionalProperties":false}},"unit":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"period":{"type":"string"},"source":{"type":"string","const":"sec_edgar"},"taxonomy":{"type":"string"},"total_filers":{"type":"number"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USD","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.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"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sMP29DJcKmGB97I3cYWPw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_HiruJoANEMrVf8KH6Ui4q","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV candlestick frame data for US stocks, ETFs, forex, or crypto tickers, paid per request in USDC via x402.","exampleAgentPrompt":"Pull the historical daily candlestick frames for AAPL — I need the open, high, low, close, and volume bars for the past 30 days for my technical analysis.","exampleUseCases":[{"title":"Backtesting a trading strategy","prompt":"Get me the daily OHLCV candlestick frames for SPY over the last 90 days so I can backtest my moving average crossover strategy."},{"title":"Crypto price chart analysis","prompt":"Fetch the historical hourly candlestick bars for BTC-USD for the past 7 days — I want to see the open, high, low, close, and volume for each period."},{"title":"ETF technical charting","prompt":"I need the historical daily price frames for QQQ going back 60 days — open, high, low, close, and volume — so I can draw support and resistance levels."}],"resultDescription":"An array of candlestick frame objects for the requested ticker, each containing timestamp, open, high, low, close, volume, and optionally VWAP fields, covering the requested time range and interval.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Requested date range outside available history returns partial or empty data","Malformed properties query parameter causes a 400 bad request","Payment failure via x402/USDC halts the request before data is returned","Rate limiting or insufficient USDC balance causes rejection"],"whenToPreferThis":"Choose this endpoint when you need structured historical OHLCV candlestick bars for US stocks, ETFs, forex, or crypto for charting or backtesting, and you want pay-per-use pricing with no API key or account setup required. Prefer it over subscription data providers when running ad-hoc or agent-driven queries where paying $0.02 per call in USDC is preferable to a monthly commitment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:00:53.398Z","isFirstParty":false,"canonicalSlug":"x402stock-candlestick-frames-ohlcv-historical-bars-6bc23afa"}