{"uid":"cap_E2zboth-u2FibmfgiCeml","slug":"agents-openwebninja-com-stock-time-series-yahoo-finance-via-openweb-4b52adb7","name":"Stock Time Series (Yahoo Finance via OpenWeb Ninja)","description":"Get stock time series by stock symbol/ticker from Yahu Finance.","url":"https://agents.openwebninja.com/realtime-finance-data/stock-time-series-yahoo-finance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["symbol"],"properties":{"period":{"type":"string","description":"Period for which to return time series and key events.  \n\n  **Periods:**  \n  `1D - 1 day`  \n  `5D - 5 days`  \n  `1M - 1 month`  \n  `6M - 6 months`  \n  `YTD - year-to-date`  \n  `1Y - 1 year`  \n  `5Y - 5 years`  \n  `MAX - all times` "},"symbol":{"type":"string","description":"Stock symbol / ticker."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","description":"Type of financial instrument"},"price":{"type":"number","description":"Current trading price"},"change":{"type":"number","description":"Price change from previous close"},"period":{"type":"string","description":"Time period covered by the time series"},"symbol":{"type":"string","description":"Ticker symbol of the asset"},"volume":{"type":"integer","description":"Trading volume for the day"},"day_low":{"type":"number","description":"Lowest price of the day"},"currency":{"type":"string","description":"Currency of the price values"},"day_high":{"type":"number","description":"Highest price of the day"},"exchange":{"type":"string","description":"Stock exchange where traded"},"interval":{"type":"string","description":"Time interval between data points"},"year_low":{"type":"number","description":"52-week low price"},"year_high":{"type":"number","description":"52-week high price"},"time_series":{"type":"array","items":{"type":"object","properties":{"low":{"type":"number","description":"Lowest price during this interval."},"high":{"type":"number","description":"Highest price during this interval."},"open":{"type":"number","description":"Open price for this interval."},"close":{"type":"number","description":"Close price for this interval."},"change":{"type":"number","description":"Absolute price change during this interval."},"volume":{"type":"integer","description":"Traded volume during this interval."},"datetime":{"type":"string","description":"Timestamp of the data point, in the exchange's local timezone."},"change_percent":{"type":"number","description":"Percent price change during this interval."}}},"description":"OHLCV data points for the requested period and interval."},"change_percent":{"type":"number","description":"Percentage price change"},"previous_close":{"type":"number","description":"Previous closing price"},"exchange_timezone":{"type":"string","description":"Exchange timezone name"},"full_exchange_name":{"type":"string","description":"Full name of the exchange"},"exchange_timezone_short":{"type":"string","description":"Abbreviated timezone name"},"exchange_timezone_utc_offset_sec":{"type":"integer","description":"UTC offset in seconds"}}},"status":{"type":"string","description":"Status of the API response"},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_lAlzpXT4L6RzylWHKTciU","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns OHLCV time series data and key metadata for a stock ticker over a specified period, sourced from Yahoo Finance.","exampleAgentPrompt":"Can you pull the 1-month OHLCV price history for NVDA from Yahoo Finance, including the current price, volume, and 52-week range?","exampleUseCases":[{"title":"Portfolio performance review","prompt":"Show me the year-to-date price history for Apple stock, including daily opens, closes, and volume — I want to see how it's trended so far this year."},{"title":"Earnings momentum analysis","prompt":"Fetch the 5-day OHLCV time series for Tesla (TSLA) so I can see how the stock moved around its recent earnings report."},{"title":"Long-term investment research","prompt":"Pull the 5-year historical price data for the S&P 500 ETF with ticker SPY from Yahoo Finance, including the 52-week high and low."}],"resultDescription":"Returns a structured object with the ticker's current price, price change and percent change, trading volume, day high/low, 52-week high/low, exchange, currency, and an array of OHLCV data points (open, high, low, close, volume, change, change_percent, datetime) for the requested period at an appropriate interval.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty data","Yahoo Finance data unavailable or rate-limited causing a proxy error","Invalid period string returns a validation error","Delisted or OTC stocks may have incomplete or missing time series data","Network timeout from the upstream Yahoo Finance source"],"whenToPreferThis":"Choose this endpoint when you need historical OHLCV candlestick data for a stock ticker sourced specifically from Yahoo Finance, especially when you need flexible period granularity from 1 day to all-time, and want current price metadata (volume, 52-week range, exchange info) bundled with the time series in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:03.778Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-stock-time-series-yahoo-finance-via-openweb-4b52adb7"}