# ScrapeMole Quotes: OHLCV Price History

> ScrapeMole Quotes: OHLCV Price History is a paid API for AI agents from quotes.scrapemole.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-18).

Returns historical OHLCV candlestick bars for a given ticker symbol over a specified time range and interval

## Facts

- Endpoint: GET https://quotes.scrapemole.workers.dev/v1/history?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-quotes-ohlcv-price-history-29e885bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TuFvcIjAYTbQCIa-UARIp

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 scrapemole-quotes-ohlcv-price-history-29e885bb
```

Example prompt: Pull the daily OHLCV price history for AAPL over the last 3 months so I can analyze how it's been trending.

## When to prefer this

Choose this endpoint when you need structured OHLCV candlestick data for stocks, ETFs, indices, FX pairs, or crypto over a defined lookback period — especially for charting, backtesting, or trend analysis. It requires no API key or account, charges only on successful responses ($0.002 USDC), and supports flexible intervals from 5-minute intraday to monthly bars. Prefer this over real-time quote endpoints when you need historical depth rather than a current snapshot.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error
- Requested interval incompatible with range (e.g. 5m bars over 5 years) may return an error or be auto-adjusted
- limit parameter outside 1-2000 range returns validation error
- Network or upstream Yahoo Finance outage results in failure with no charge
- Payment failure or insufficient USDC balance blocks the request before execution

## How this service works

Pay-per-call market data for agents: live-ish stock, ETF, index, FX and crypto quotes (price, change, day range, 52-week range, volume), batch quotes for up to 10 symbols, OHLCV price history, ticker search, and CoinGecko crypto prices with market cap and 24h change. Public market data only, no keys, no accounts. USDC via x402; failed calls are never charged.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://quotes.scrapemole.workers.dev/terms

## Output

Returns a JSON object with an array of OHLCV bars (each containing open, high, low, close, adjusted close, volume, and UTC timestamp), plus metadata including symbol, currency, interval, range, total bar count, data source (Yahoo Finance), and the period return percentage.

## 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",
     "required": [
      "symbol"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "default": "500",
       "description": "Max bars, most recent kept (1-2000)."
      },
      "range": {
       "enum": [
        "1d",
        "5d",
        "1mo",
        "3mo",
        "6mo",
        "ytd",
        "1y",
        "2y",
        "5y",
        "10y",
        "max"
       ],
       "type": "string",
       "default": "1mo",
       "description": "Lookback range."
      },
      "symbol": {
       "type": "string",
       "examples": [
        "AAPL"
       ],
       "description": "Yahoo-style ticker."
      },
      "interval": {
       "enum": [
        "5m",
        "15m",
        "30m",
        "1h",
        "1d",
        "1wk",
        "1mo"
       ],
       "type": "string",
       "description": "Bar size; default depends on range (1d->5m, 5d->30m, 1mo-1y->1d, 2y/5y->1wk, 10y/max->1mo)."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bars": [
   {
    "c": 340.97,
    "h": 342.63,
    "l": 337.6,
    "o": 336.82,
    "t": "2026-10-12T13:30:00.000Z",
    "v": 25796997,
    "adjClose": 340.97
   }
  ],
  "count": 21,
  "range": "1mo",
  "source": "Yahoo Finance",
  "symbol": "AAPL",
  "currency": "USD",
  "interval": "1d",
  "periodReturnPercent": 4.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-quotes-ohlcv-price-history-29e885bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quotes.scrapemole.workers.dev](https://www.zero.xyz/host/quotes.scrapemole.workers.dev/llms.txt)
