{"uid":"cap_GuZhqrXCQCyIzprmCx1H0","slug":"agents-openwebninja-com-stock-time-series-5bc51fdb","name":"Stock Time Series","description":"Get stock time series and key news events for the following periods:  \n  1 day, 5 days, 1 month, 6 months, year-to-date, 1 year, 5 years and all times (max).  \n  In addition, the endpoints returns the key news events that affected the stock prices  in the specified period.  \n  Supports all stock types: stock, index, mutual fund and futures.","url":"https://agents.openwebninja.com/realtime-finance-data/stock-time-series?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)."},"language":{"type":"string","default":"en","description":"The language to use for the results, specified as a 2-letter language code - see ISO 639-1."}}},"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 data"},"symbol":{"type":"string","description":"Stock ticker symbol"},"key_events":{"type":"array","items":{"type":"string"},"description":"Significant market events relevant to this asset over the requested period. Empty when no events are reported."},"time_series":{"type":"object","description":"Historical price data keyed by timestamp. Each value is a price snapshot at that timestamp.","additionalProperties":{"type":"object","properties":{"price":{"type":"number","description":"Price at this timestamp."},"change":{"type":"number","description":"Absolute change from the previous close at this timestamp."},"volume":{"type":"integer","description":"Traded volume during this interval."},"change_percent":{"type":"number","description":"Percent change from the previous close at this timestamp."}}}},"interval_sec":{"type":"integer","description":"Time interval between data points in seconds"},"change_percent":{"type":"number","description":"Percentage price change from previous close"},"previous_close":{"type":"number","description":"Previous closing price"},"utc_offset_sec":{"type":"integer","description":"UTC offset in seconds for the exchange timezone"},"last_update_utc":{"type":"string","description":"Timestamp of last price update in UTC"},"pre_or_post_market":{"type":"number","description":"Pre-market or post-market price"},"pre_or_post_market_change":{"type":"number","description":"Price change in pre/post market trading"},"pre_or_post_market_change_percent":{"type":"number","description":"Percentage price change in pre/post market trading"}}},"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_NbeKg0cc09tnO7qQIcXNk","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 historical price time series and key news events for a stock, index, mutual fund, or futures contract over a specified period.","exampleAgentPrompt":"Pull up the 1-year price time series for NVDA, including any key news events that moved the stock, so I can see how it's trended.","exampleUseCases":[{"title":"Tracking stock performance over time","prompt":"Show me the 6-month price history for Tesla (TSLA) along with any major news events that affected the stock during that period."},{"title":"Year-to-date portfolio review","prompt":"Get the year-to-date price time series for Microsoft (MSFT) so I can see how it's performed since January."},{"title":"Intraday trading reference","prompt":"What does AAPL's price look like today — give me the 1-day time series with price, volume, and change data."}],"resultDescription":"Returns a JSON object with the stock's current price, price change, change percent, previous close, pre/post market prices, a timestamped time series of historical prices (with price, change, volume, and change percent per interval), a list of key news events relevant to the period, the time interval between data points in seconds, and the UTC offset for the exchange timezone.","failureModes":["Invalid or unknown ticker symbol returns an error or empty data","Unsupported period value results in a bad request error","Missing required symbol parameter returns a validation error","Requested data outside market hours may return incomplete intraday series","Rate limit or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Choose this endpoint when you need historical OHLC-style price snapshots combined with contextual news events for a specific stock, index, mutual fund, or futures contract over standard periods (1D to MAX). It is especially useful when you want both the quantitative price series and qualitative news context in a single call, and when you need pre/post market data alongside regular session prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:30.095Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-stock-time-series-5bc51fdb"}