# BlockRun US Stock OHLC History

> BlockRun US Stock OHLC History is a paid API for AI agents from blockrun-web-vbsbhh7lea-uc.a.run.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15, last successful call 2026-06-10).

Returns historical OHLC price bars (open, high, low, close, volume) for a US stock ticker at a specified resolution and time window

## Facts

- Endpoint: GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/history/AAPL
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-10
- Success rate: 85% of calls made through Zero
- Activations on Zero: 80
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-us-stock-ohlc-history-4d1849c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-64VvIm5_NkKuMxmVwS5B

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 blockrun-us-stock-ohlc-history-4d1849c3
```

Example prompt: Pull daily OHLC bars for AAPL from January 1 2025 to April 30 2025 — I need the open, high, low, close, and volume for each trading day.

## When to prefer this

Use this endpoint when you need historical candlestick/OHLC bar data for US-listed equities (NYSE, Nasdaq, AMEX) at granularities ranging from 1-minute to monthly, sourced from Pyth. Prefer it for backtesting, charting, or time-series analysis over real-time price endpoints when historical range data is required.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error
- from/to timestamps missing or malformed returns 400
- Requested time window has no trading data (e.g. weekend-only range at daily resolution) returns empty bars array
- Payment of 0.001 USDC not provided results in 402 Payment Required
- Resolution enum value not in allowed set returns validation error

## How this service works

US Stock OHLC bars for AAPL @ D

## Output

An array of OHLC bar objects each containing timestamp (Unix seconds), open, high, low, close, and volume, along with the symbol, resolution, and data source (Pyth). The response covers the requested time window at the chosen bar resolution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "path": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "example": "AAPL",
       "description": "NYSE/Nasdaq/AMEX ticker (AAPL, TSLA, NVDA, CRCL, SPY, …)."
      }
     }
    },
    "query": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "integer",
       "description": "Window end (Unix seconds)."
      },
      "from": {
       "type": "integer",
       "description": "Window start (Unix seconds)."
      },
      "session": {
       "enum": [
        "pre",
        "post",
        "on"
       ],
       "type": "string",
       "description": "Optional US market session."
      },
      "resolution": {
       "enum": [
        "1",
        "5",
        "15",
        "60",
        "240",
        "D",
        "W",
        "M"
       ],
       "type": "string",
       "default": "D",
       "description": "Bar resolution (TradingView convention): 1/5/15/60/240 min, D day, W week, M month."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "symbol",
    "resolution",
    "bars",
    "source"
   ],
   "properties": {
    "to": {
     "type": "integer"
    },
    "bars": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "t",
       "o",
       "h",
       "l",
       "c",
       "v"
      ],
      "properties": {
       "c": {
        "type": "number",
        "description": "Close"
       },
       "h": {
        "type": "number",
        "description": "High"
       },
       "l": {
        "type": "number",
        "description": "Low"
       },
       "o": {
        "type": "number",
        "description": "Open"
       },
       "t": {
        "type": "integer",
        "description": "Bar start (Unix seconds)"
       },
       "v": {
        "type": "number",
        "description": "Volume"
       }
      }
     }
    },
    "from": {
     "type": "integer"
    },
    "source": {
     "type": "string",
     "const": "pyth"
    },
    "symbol": {
     "type": "string",
     "example": "AAPL"
    },
    "resolution": {
     "type": "string",
     "example": "D"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-us-stock-ohlc-history-4d1849c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun-web-vbsbhh7lea-uc.a.run.app](https://www.zero.xyz/host/blockrun-web-vbsbhh7lea-uc.a.run.app/llms.txt)