# BlockRun US Stock OHLC Historical Bars

> BlockRun US Stock OHLC Historical Bars 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).

Returns OHLC (Open, High, Low, Close, Volume) bar history for a US-listed stock ticker over a specified time window and resolution

## Facts

- Endpoint: GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/history/BABA
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-us-stock-ohlc-historical-bars-53ea4409
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eqxX_3n3_UnZKCZEJ4aEE

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-historical-bars-53ea4409
```

Example prompt: Pull daily OHLC bars for BABA from January 1 2024 to June 30 2024 using the BlockRun stock history API — I need the open, high, low, close, and volume for each day.

## When to prefer this

Use this endpoint when you need structured OHLC candlestick bar history for a US-listed equity (NYSE/Nasdaq/AMEX) with flexible resolution from 1-minute to monthly, sourced from Pyth Network. Prefer this over real-time price endpoints when you need historical time-series data for charting, backtesting, or trend analysis.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error
- from/to timestamps out of range or reversed returns empty bars array or error
- Unsupported resolution value returns a validation error
- Missing required query parameters (from, to) returns a 400-level error
- Payment not attached or insufficient USDC balance triggers a 402 Payment Required response

## How this service works

US Stock OHLC bars for BABA @ D

## Output

Returns a JSON object containing an array of OHLC bar objects, each with timestamp (Unix seconds), open, high, low, close, and volume fields, along with the symbol, resolution, source (pyth), and the effective from/to window.

## 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-historical-bars-53ea4409/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)