# Blockrun US Stock OHLC History – GLD

> Blockrun US Stock OHLC History – GLD 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-15).

Returns historical OHLC (open/high/low/close/volume) bar data for GLD (SPDR Gold Shares ETF) at configurable resolutions from 1-minute to monthly.

## Facts

- Endpoint: GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/history/GLD
- Price: $0.002/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-history-gld-3edeb352
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A7yrio5MOcsa78MtyEbe6

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-gld-3edeb352
```

Example prompt: Can you pull the daily OHLC bars for GLD from January 1, 2025 to March 31, 2025 so I can chart the gold ETF's price trend?

## When to prefer this

Use this endpoint when you need structured OHLC candlestick/bar data for the GLD (SPDR Gold Shares) ETF specifically over a defined historical time window, especially for charting, backtesting, or technical analysis. Prefer this over the realtime GLD price endpoint when historical depth across multiple bars is needed rather than a single current price.

## Known failure modes

- Invalid or missing 'from'/'to' timestamps returns a 400 error
- 'from' timestamp after 'to' timestamp may return empty bars array or error
- Requesting data outside of market hours without a session filter may yield sparse results
- Invalid resolution value not in enum returns validation error
- Network or service unavailability returns 5xx error
- Very large date ranges may time out or return partial data

## How this service works

US Stock OHLC bars for GLD @ D

## Output

Returns an array of OHLC bar objects for GLD, each containing bar start time (Unix seconds), open, high, low, close prices, and volume, along with metadata including symbol, resolution, and data 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-gld-3edeb352/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)