{"uid":"cap_-4VhUv9Z8PA74nFIQiQQ_","slug":"x402stock-xyz-84621029","name":"x402stock.xyz OHLCV Aggregates","description":"The stock price history endpoint. Returns historical OHLCV bars at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Use for price history, charting, backtesting, and trend analysis over any date range. 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/aggregates/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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["multiplier","timespan","from","to","adjusted","sort","limit"],"properties":{"to":{"type":"string","default":"2026-09-15","minLength":1},"from":{"type":"string","default":"2025-09-15","minLength":1},"sort":{"enum":["asc","desc"],"type":"string","default":"asc"},"limit":{"type":"integer","default":5000,"maximum":50000,"exclusiveMinimum":0},"adjusted":{"type":"boolean","default":true},"timespan":{"enum":["minute","hour","day","week","month","quarter","year"],"type":"string","default":"day"},"multiplier":{"type":"integer","default":1,"maximum":50000,"exclusiveMinimum":0}},"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":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["bars","count"],"properties":{"bars":{"type":"array","items":{"type":"object","required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"type":"number"},"volume":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"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":{"to":"2024-03-31","from":"2024-01-01","sort":"asc","limit":500,"adjusted":true,"timespan":"day","multiplier":1}}},"response":{"data":{"bars":[{"low":183.885,"high":188.44,"open":187.15,"vwap":185.9465,"close":185.64,"volume":81964874,"timestamp":"2024-01-02T05:00:00.000Z","trade_count":1008871},{"low":183.43,"high":185.88,"open":184.22,"vwap":184.3226,"close":184.25,"volume":58414460,"timestamp":"2024-01-03T05:00:00.000Z","trade_count":656853},{"low":180.88,"high":183.0872,"open":182.15,"vwap":182.0183,"close":181.91,"volume":71878670,"timestamp":"2024-01-04T05:00:00.000Z","trade_count":712692},{"low":180.17,"high":182.76,"open":181.99,"vwap":181.474,"close":181.18,"volume":62371161,"timestamp":"2024-01-05T05:00:00.000Z","trade_count":682334},{"low":181.5,"high":185.6,"open":182.085,"vwap":184.3702,"close":185.56,"volume":59144470,"timestamp":"2024-01-08T05:00:00.000Z","trade_count":669173},{"low":182.73,"high":185.15,"open":183.92,"vwap":184.3706,"close":185.14,"volume":42841809,"timestamp":"2024-01-09T05:00:00.000Z","trade_count":538180},{"low":183.92,"high":186.4,"open":184.35,"vwap":185.2509,"close":186.19,"volume":46192908,"timestamp":"2024-01-10T05:00:00.000Z","trade_count":554777},{"low":183.62,"high":187.05,"open":186.54,"vwap":185.0604,"close":185.59,"volume":49128408,"timestamp":"2024-01-11T05:00:00.000Z","trade_count":584008},{"low":185.19,"high":186.74,"open":186.06,"vwap":185.8199,"close":185.92,"volume":40477782,"timestamp":"2024-01-12T05:00:00.000Z","trade_count":477050},{"low":180.934,"high":184.26,"open":182.16,"vwap":182.8866,"close":183.63,"volume":65076641,"timestamp":"2024-01-16T05:00:00.000Z","trade_count":767281},{"low":180.3,"high":182.93,"open":181.27,"vwap":181.9201,"close":182.68,"volume":47317433,"timestamp":"2024-01-17T05:00:00.000Z","trade_count":594632},{"low":185.83,"high":189.14,"open":186.09,"vwap":187.9358,"close":188.63,"volume":77722754,"timestamp":"2024-01-18T05:00:00.000Z","trade_count":787233},{"low":188.82,"high":191.95,"open":189.33,"vwap":190.6149,"close":191.56,"volume":68887985,"timestamp":"2024-01-19T05:00:00.000Z","trade_count":682663},{"low":192.26,"high":195.33,"open":192.3,"vwap":193.9891,"close":193.89,"volume":60131852,"timestamp":"2024-01-22T05:00:00.000Z","trade_count":718107},{"low":193.8299,"high":195.75,"open":195.02,"vwap":194.8203,"close":195.18,"volume":42355590,"timestamp":"2024-01-23T05:00:00.000Z","trade_count":533093},{"low":194.34,"high":196.38,"open":195.42,"vwap":195.2063,"close":194.5,"volume":53631316,"timestamp":"2024-01-24T05:00:00.000Z","trade_count":594714},{"low":193.1125,"high":196.2675,"open":195.22,"vwap":194.7337,"close":194.17,"volume":54822126,"timestamp":"2024-01-25T05:00:00.000Z","trade_count":644526},{"low":191.94,"high":194.76,"open":194.27,"vwap":193.1207,"close":192.42,"volume":44587111,"timestamp":"2024-01-26T05:00:00.000Z","trade_count":534165},{"low":189.58,"high":192.2,"open":192.01,"vwap":191.2954,"close":191.73,"volume":47145622,"timestamp":"2024-01-29T05:00:00.000Z","trade_count":599513},{"low":187.47,"high":191.8,"open":190.94,"vwap":188.7927,"close":188.04,"volume":55836970,"timestamp":"2024-01-30T05:00:00.000Z","trade_count":690705},{"low":184.35,"high":187.095,"open":187.04,"vwap":185.3525,"close":184.4,"volume":55467803,"timestamp":"2024-01-31T05:00:00.000Z","trade_count":679844},{"low":183.82,"high":186.95,"open":183.985,"vwap":185.5688,"close":186.86,"volume":64885408,"timestamp":"2024-02-01T05:00:00.000Z","trade_count":820977},{"low":179.25,"high":187.33,"open":179.86,"vwap":184.744,"close":185.85,"volume":102527680,"timestamp":"2024-02-02T05:00:00.000Z","trade_count":1108465},{"low":185.84,"high":189.25,"open":188.15,"vwap":187.6824,"close":187.68,"volume":69654320,"timestamp":"2024-02-05T05:00:00.000Z","trade_count":804748},{"low":186.7695,"high":189.31,"open":186.86,"vwap":188.4788,"close":189.3,"volume":43490759,"timestamp":"2024-02-06T05:00:00.000Z","trade_count":530825},{"low":188.61,"high":191.05,"open":190.64,"vwap":189.3803,"close":189.41,"volume":53438955,"timestamp":"2024-02-07T05:00:00.000Z","trade_count":596088},{"low":187.35,"high":189.535,"open":189.385,"vwap":188.3032,"close":188.32,"volume":40962046,"timestamp":"2024-02-08T05:00:00.000Z","trade_count":521464},{"low":188,"high":189.99,"open":188.65,"vwap":189.0056,"close":188.85,"volume":45155216,"timestamp":"2024-02-09T05:00:00.000Z","trade_count":544714},{"low":186.79,"high":188.67,"open":188.415,"vwap":187.5914,"close":187.15,"volume":41781934,"timestamp":"2024-02-12T05:00:00.000Z","trade_count":585515},{"low":183.5128,"high":186.21,"open":185.77,"vwap":185.0421,"close":185.04,"volume":56529529,"timestamp":"2024-02-13T05:00:00.000Z","trade_count":644015},{"low":182.44,"high":185.53,"open":185.32,"vwap":183.6207,"close":184.15,"volume":54617917,"timestamp":"2024-02-14T05:00:00.000Z","trade_count":679072},{"low":181.35,"high":184.49,"open":183.55,"vwap":182.8487,"close":183.86,"volume":65434496,"timestamp":"2024-02-15T05:00:00.000Z","trade_count":756083},{"low":181.665,"high":184.85,"open":183.42,"vwap":182.7317,"close":182.31,"volume":49752465,"timestamp":"2024-02-16T05:00:00.000Z","trade_count":611770},{"low":180,"high":182.43,"open":181.79,"vwap":181.1005,"close":181.56,"volume":53574453,"timestamp":"2024-02-20T05:00:00.000Z","trade_count":712335},{"low":180.66,"high":182.8888,"open":181.94,"vwap":181.9941,"close":182.32,"volume":41496371,"timestamp":"2024-02-21T05:00:00.000Z","trade_count":522492},{"low":182.46,"high":184.955,"open":183.48,"vwap":183.8372,"close":184.37,"volume":52284192,"timestamp":"2024-02-22T05:00:00.000Z","trade_count":613892},{"low":182.23,"high":185.04,"open":185.01,"vwap":182.9876,"close":182.52,"volume":44926677,"timestamp":"2024-02-23T05:00:00.000Z","trade_count":549250},{"low":180.65,"high":182.76,"open":182.24,"vwap":181.3213,"close":181.16,"volume":40867421,"timestamp":"2024-02-26T05:00:00.000Z","trade_count":615639},{"low":179.56,"high":183.9225,"open":181.1,"vwap":181.8192,"close":182.63,"volume":54318851,"timestamp":"2024-02-27T05:00:00.000Z","trade_count":669751},{"low":180.13,"high":183.12,"open":182.51,"vwap":181.1915,"close":181.42,"volume":48943139,"timestamp":"2024-02-28T05:00:00.000Z","trade_count":596442},{"low":179.53,"high":182.57,"open":181.27,"vwap":180.6781,"close":180.75,"volume":136682597,"timestamp":"2024-02-29T05:00:00.000Z","trade_count":813073},{"low":177.38,"high":180.53,"open":179.55,"vwap":179.0322,"close":179.66,"volume":73450582,"timestamp":"2024-03-01T05:00:00.000Z","trade_count":911077},{"low":173.79,"high":176.9,"open":176.15,"vwap":174.8938,"close":175.1,"volume":81505451,"timestamp":"2024-03-04T05:00:00.000Z","trade_count":1167166},{"low":169.62,"high":172.04,"open":170.76,"vwap":170.3234,"close":170.12,"volume":94702355,"timestamp":"2024-03-05T05:00:00.000Z","trade_count":1108820},{"low":168.68,"high":171.24,"open":171.06,"vwap":169.5506,"close":169.12,"volume":68568907,"timestamp":"2024-03-06T05:00:00.000Z","trade_count":896297},{"low":168.49,"high":170.73,"open":169.15,"vwap":169.3619,"close":169,"volume":71763761,"timestamp":"2024-03-07T05:00:00.000Z","trade_count":825405},{"low":168.94,"high":173.7,"open":169,"vwap":171.5322,"close":170.73,"volume":76267041,"timestamp":"2024-03-08T05:00:00.000Z","trade_count":925213},{"low":172.05,"high":174.38,"open":172.94,"vwap":172.9273,"close":172.75,"volume":60139473,"timestamp":"2024-03-11T04:00:00.000Z","trade_count":793618},{"low":171.01,"high":174.03,"open":173.15,"vwap":172.8726,"close":173.23,"volume":59813522,"timestamp":"2024-03-12T04:00:00.000Z","trade_count":735065},{"low":170.76,"high":173.185,"open":172.77,"vwap":171.3457,"close":171.13,"volume":52488692,"timestamp":"2024-03-13T04:00:00.000Z","trade_count":647120},{"low":172.05,"high":174.3078,"open":172.91,"vwap":173.0899,"close":173,"volume":72913507,"timestamp":"2024-03-14T04:00:00.000Z","trade_count":806014},{"low":170.285,"high":172.62,"open":171.17,"vwap":171.8002,"close":172.62,"volume":121752699,"timestamp":"2024-03-15T04:00:00.000Z","trade_count":771387},{"low":173.52,"high":177.71,"open":175.57,"vwap":175.4587,"close":173.72,"volume":75604184,"timestamp":"2024-03-18T04:00:00.000Z","trade_count":866388},{"low":173.03,"high":176.605,"open":174.34,"vwap":175.4779,"close":176.08,"volume":55215244,"timestamp":"2024-03-19T04:00:00.000Z","trade_count":636058},{"low":175.09,"high":178.67,"open":175.72,"vwap":177.2239,"close":178.67,"volume":53423102,"timestamp":"2024-03-20T04:00:00.000Z","trade_count":641653},{"low":170.84,"high":177.49,"open":177.05,"vwap":172.7231,"close":171.37,"volume":106181270,"timestamp":"2024-03-21T04:00:00.000Z","trade_count":1224985},{"low":170.06,"high":173.05,"open":171.76,"vwap":172.0464,"close":172.28,"volume":71146138,"timestamp":"2024-03-22T04:00:00.000Z","trade_count":736378},{"low":169.45,"high":171.94,"open":170.565,"vwap":170.7132,"close":170.85,"volume":54288328,"timestamp":"2024-03-25T04:00:00.000Z","trade_count":727686},{"low":169.58,"high":171.42,"open":170,"vwap":170.323,"close":169.71,"volume":57388449,"timestamp":"2024-03-26T04:00:00.000Z","trade_count":684303},{"low":170.11,"high":173.6,"open":170.41,"vwap":172.5879,"close":173.31,"volume":60263665,"timestamp":"2024-03-27T04:00:00.000Z","trade_count":670629},{"low":170.51,"high":172.23,"open":171.75,"vwap":171.3942,"close":171.48,"volume":65671690,"timestamp":"2024-03-28T04:00:00.000Z","trade_count":648026}],"count":61,"adjusted":true},"as_of":"2026-06-12T03:08:23.002Z","source":"x402stock","ticker":"AAPL"}},"exampleRequest":{"to":"2024-03-31","from":"2024-01-01","sort":"asc","limit":500,"adjusted":true,"timespan":"day","multiplier":1},"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.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"}]},"paymentMethods":[{"uid":"pm_Xh3igjN2FgGg_NCIA6DH4","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 historical OHLCV (open, high, low, close, volume) aggregate bars for a given US equity ticker over a specified date range and timespan.","exampleAgentPrompt":"Can you pull daily adjusted OHLCV bars for AAPL from 2024-01-01 to 2024-03-31, sorted ascending with a limit of 500 bars?","exampleUseCases":[{"title":"Backtest trading strategy with historical data","prompt":"I need to test a momentum strategy on Tesla stock. Can you grab me hourly price bars for TSLA over the last three months so I can see how it would've performed?"},{"title":"Compare volume trends across time periods","prompt":"Pull the daily OHLCV data for the S&P 500 ETF over the past year. I want to analyze which months had the highest trading volumes and spot any unusual activity."},{"title":"Build price chart for investor presentation","prompt":"Get me the adjusted close prices and volume for Microsoft from January through December last year, with weekly bars so I can create a clean chart showing the annual trend."}],"resultDescription":"Returns an object containing the ticker symbol, a data block with an array of OHLCV bars (open, high, low, close, volume, VWAP, trade_count, timestamp), the total bar count, whether the data is adjusted, the data source ('massive'), and the as_of date.","failureModes":["Invalid ticker symbol returns empty or error response","Date range with no trading data (e.g. weekends/holidays only) returns zero bars","Invalid timespan or multiplier value causes validation error","Exceeding limit of 50000 bars returns error","Missing required query parameters (multiplier, timespan, from, to) causes 400-level error","Payment failure (HTTP 402) if USDC payment not included"],"whenToPreferThis":"Use this endpoint when you need historical OHLCV candlestick or bar data for a specific US equity ticker over a custom date range. Prefer it over the end-of-day market snapshot endpoint when you need intraday granularity, multi-day history, or adjusted price series for a single ticker. The x402 micropayment model ($0.02/call) makes it cost-effective for targeted lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:06.647Z","isFirstParty":false}