# finance.toonhaus.dev Stock Price History (OHLCV Candles)

> finance.toonhaus.dev Stock Price History (OHLCV Candles) is a paid API for AI agents from finance.toonhaus.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15, last successful call 2026-06-19).

Returns OHLCV (Open, High, Low, Close, Volume) candlestick price history for a given stock symbol

## Facts

- Endpoint: GET https://finance.toonhaus.dev/api/stock/price-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-19
- Success rate: 100% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finance-toonhaus-dev-e8b368f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tVITJ5hvmYyXyMwLzBqiG

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 finance-toonhaus-dev-e8b368f3
```

Example prompt: Can you pull up the OHLCV candlestick price history for AAPL for the past 3 months so I can see how the stock has been moving?

## When to prefer this

Use this endpoint when you need structured OHLCV candlestick price history for a stock, particularly for technical analysis, charting, or backtesting. Prefer this over alternatives when working within the finance.toonhaus.dev ecosystem alongside other endpoints like analyst targets, options chains, or earnings dates for a holistic stock research workflow.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty dataset
- Missing required query parameters (e.g. ticker) results in a 400 error
- Requesting data for a non-trading period may return no candles
- Rate limiting or payment failure via x402 protocol may return 402
- Very long date ranges may return partial data or timeout

## How this service works

OHLCV candles

## Output

Returns an array of OHLCV candlestick records for the requested stock, each containing open, high, low, close prices and trading volume for each time interval (e.g. daily candles). Useful for charting, technical analysis, and backtesting trading strategies.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ticker": "AAPL"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finance-toonhaus-dev-e8b368f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finance.toonhaus.dev](https://www.zero.xyz/host/finance.toonhaus.dev/llms.txt)