# Blockrun US Stock OHLC History - USO

> Blockrun US Stock OHLC History - USO is a paid API for AI agents from blockrun-web-vbsbhh7lea-uc.a.run.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns historical OHLC (Open/High/Low/Close/Volume) bar data for USO (United States Oil Fund ETF) at configurable resolutions

## Facts

- Endpoint: GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/history/USO
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-us-stock-ohlc-history-uso-b5794f32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_no996g1J3GoQwYpweO1hg

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-uso-b5794f32
```

Example prompt: Can you pull the daily OHLC bars for USO from January 1, 2024 to March 31, 2024? I want to see the open, high, low, close, and volume for each day.

## When to prefer this

Use this endpoint when you need historical candlestick/OHLC bar data specifically for USO (United States Oil Fund ETF) at any supported resolution (minute, hourly, daily, weekly, monthly). Prefer this over realtime price endpoints when you need historical ranges for charting, backtesting, or trend analysis. Data is sourced from Pyth Network. Choose a sibling endpoint for other tickers like AAPL or NVDA.

## Known failure modes

- Missing required 'from' or 'to' query parameters returns a 400 error
- Invalid resolution enum value (not in 1/5/15/60/240/D/W/M) returns a 400 error
- Date range with no trading data (e.g. holiday/weekend with minute resolution) may return empty bars array
- Payment not provided or insufficient USDC returns 402 Payment Required
- Future date range returns empty or partial bars
- Very large date ranges at minute resolution may time out or return incomplete data

## How this service works

US Stock OHLC bars for USO @ D

## Output

An array of OHLC bar objects each containing Unix timestamp (t), open (o), high (h), low (l), close (c), and volume (v) for USO at the requested resolution, along with metadata fields: symbol, resolution, from, to, and source (pyth).

## 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-uso-b5794f32/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)