# Stock Time Series > Stock Time Series is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14). Returns historical price time series and key news events for a stock, index, mutual fund, or futures contract over a specified period. ## Facts - Endpoint: GET https://agents.openwebninja.com/realtime-finance-data/stock-time-series?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: agents.openwebninja.com - Website: https://agents.openwebninja.com - Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-stock-time-series-5bc51fdb - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GuZhqrXCQCyIzprmCx1H0 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-openwebninja-com-stock-time-series-5bc51fdb ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works Get stock time series and key news events for the following periods: 1 day, 5 days, 1 month, 6 months, year-to-date, 1 year, 5 years and all times (max). In addition, the endpoints returns the key news events that affected the stock prices in the specified period. Supports all stock types: stock, index, mutual fund and futures. ## Output 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. ## Request schema (JSON Schema) ```json { "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." } } } ``` ## Response schema (JSON Schema) ```json { "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 mark … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-stock-time-series-5bc51fdb/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)