# Stock OHLCV History

> Stock OHLCV History is a paid API for AI agents from x402-stock-indicators.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns historical OHLCV candlestick bar data for any US stock ticker at configurable resolutions from 1-minute intraday to monthly, over a specified date range.

## Facts

- Endpoint: GET https://x402-stock-indicators.vercel.app/history/:ticker
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stock-ohlcv-history-549e3714
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-CfHI69309CPZDKZcSVT3

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 stock-ohlcv-history-549e3714
```

Example prompt: Pull the daily OHLCV candlestick bars for TSLA from 2024-01-01 to 2024-12-31 — I need it for a backtest.

## When to prefer this

Use this endpoint when you need historical OHLCV price bars for a US-listed equity at any resolution from 1-minute intraday to monthly, especially for backtesting trading strategies, rendering price charts, or performing technical trend analysis. Prefer this over general market data APIs when you need flexible bar sizes (e.g. 5-minute, 15-minute, 90-minute) and a simple REST call with per-use micropayment pricing.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error or empty result
- Unsupported multiplier/timespan combination returns an error (e.g. 2-hour bars are not supported)
- Date range too large for the requested resolution may return truncated or error response
- Future dates or invalid date formats return an error
- Payment failure via x402 protocol blocks the request

## How this service works

Historical OHLCV/candlestick bars for any US stock ticker over any date range — 1-minute intraday up to monthly at precise multipliers (1/2/5/15/30/60/90-minute, 1-hour, 1/5-day, 1-week, 1/3-month), from real Yahoo Finance data. Supports backtesting, charting, and multi-timeframe analysis. $0.01/call.

## Output

A time series of OHLCV (open, high, low, close, volume) candlestick bars for the requested ticker and date range at the specified bar resolution, sourced from Yahoo Finance data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL, TSLA, MSFT"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "multiplier",
      "timespan",
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date",
       "description": "End date, e.g. 2026-07-01"
      },
      "from": {
       "type": "string",
       "format": "date",
       "description": "Start date, e.g. 2026-01-01"
      },
      "timespan": {
       "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
       ],
       "type": "string"
      },
      "multiplier": {
       "type": "integer",
       "description": "Bar size multiplier. Supported per timespan: minute(1,2,5,15,30,60,90), hour(1), day(1,5), week(1), month(1,3)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stock-ohlcv-history-549e3714/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-stock-indicators.vercel.app](https://www.zero.xyz/host/x402-stock-indicators.vercel.app/llms.txt)