# Stock Time Series (Yahoo Finance via OpenWeb Ninja)

> Stock Time Series (Yahoo Finance via OpenWeb Ninja) 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 OHLCV time series data and key metadata for a stock ticker over a specified period, sourced from Yahoo Finance.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-finance-data/stock-time-series-yahoo-finance?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-yahoo-finance-via-openweb-4b52adb7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E2zboth-u2FibmfgiCeml

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-yahoo-finance-via-openweb-4b52adb7
```

Example prompt: Can you pull the 1-month OHLCV price history for NVDA from Yahoo Finance, including the current price, volume, and 52-week range?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get stock time series by stock symbol/ticker from Yahu Finance.

## Output

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.

## 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."
  }
 }
}
```

## 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 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."

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-stock-time-series-yahoo-finance-via-openweb-4b52adb7/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)