{"uid":"cap_pLWDaTBgeo-L8GlYLccdJ","slug":"agents-x402stock-xyz-x402stock-options-ohlcv-historical-bars-49100778","name":"x402stock Options OHLCV Historical Bars","description":"Historical OHLCV price bars for one option contract over any date range. Pass the option contract ticker in the path (e.g. O:AAPL260620C00150000) and tune ?multiplier=, ?timespan=minute|hour|day|week|month, ?from= and ?to= (optional; default to the trailing year), ?adjusted=, ?sort=, and ?limit=. Use for backtesting or charting a single option's price history. From x402stock","url":"https://agents.x402stock.xyz/api/v1/options-aggregates/{contract}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["contract"],"properties":{"to":{"type":"string","default":"2026-07-31","minLength":1},"from":{"type":"string","default":"2025-07-31","minLength":1},"sort":{"enum":["asc","desc"],"type":"string","default":"asc"},"limit":{"type":"integer","default":5000,"maximum":50000,"exclusiveMinimum":0},"adjusted":{"type":"boolean","default":true},"contract":{"type":"string","description":"Option contract ticker (OCC/Polygon format), e.g. O:AAPL260620C00150000."},"timespan":{"enum":["minute","hour","day","week","month","quarter","year"],"type":"string","default":"day"},"multiplier":{"type":"integer","default":1,"maximum":50000,"exclusiveMinimum":0}}},"responseSchema":{"type":"object","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},"example":null,"exampleRequest":null,"tags":[],"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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i0ZRWkFiJZ1oHhQoKKUGZ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV price bars for a single options contract over a specified date range at configurable timespans and multipliers.","exampleAgentPrompt":"Pull daily OHLCV bars for the AAPL June 2026 $150 call option (ticker O:AAPL260620C00150000) from January 1 2025 to June 30 2025, sorted ascending, up to 5000 bars.","exampleUseCases":[{"title":"Options backtesting strategy research","prompt":"Get me daily OHLCV price bars for the SPY December 2025 $580 put (O:SPY251219P00580000) for the entire year 2025 so I can backtest a simple put-buying strategy."},{"title":"Charting a recent options trade","prompt":"I bought the TSLA March 2026 $300 call last month — can you pull hourly OHLCV bars for O:TSLA260320C00300000 from June 1 2025 to today so I can chart how it's moved?"},{"title":"Analyzing options volume around earnings","prompt":"Fetch minute-level OHLCV data for the NVDA August 2025 $130 call (O:NVDA250815C00130000) for the two weeks around August 2025 earnings — I want to see how volume and price spiked."}],"resultDescription":"A JSON object containing the option contract ticker, an array of OHLCV bars (each with open, high, low, close, volume, VWAP, trade count, and timestamp), the total bar count, adjustment status, and an as_of timestamp indicating data freshness. The source field confirms data origin as x402stock.","failureModes":["Invalid or malformed contract ticker (e.g. missing O: prefix) returns an error or empty result","Date range with no trading data for the contract (expired or not yet active) returns zero bars","Exceeding the limit of 50000 bars silently truncates or returns an error","Invalid timespan enum value returns a validation error","from date after to date returns an error or empty dataset","Payment failure (insufficient USDC balance) results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need historical price bar data for a specific, named options contract in OCC/Polygon format. It is ideal for backtesting single-contract options strategies, charting price history, or analyzing volume patterns around events. Prefer this over stock OHLCV endpoints when the asset is specifically an options contract, and over options snapshot endpoints when you need a time series rather than current state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:44:12.672Z","isFirstParty":false}