# x402stock Candlestick Frames (OHLCV Historical Bars)

> x402stock Candlestick Frames (OHLCV Historical Bars) is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.02/call, status unknown (last checked 2026-10-27).

Returns historical OHLCV candlestick frame data for US stocks, ETFs, forex, or crypto tickers, paid per request in USDC via x402.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/frames?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-candlestick-frames-ohlcv-historical-bars-6bc23afa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QNE57a_UtPReTFGkIwzXK

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 x402stock-candlestick-frames-ohlcv-historical-bars-6bc23afa
```

Example prompt: Pull the historical daily candlestick frames for AAPL — I need the open, high, low, close, and volume bars for the past 30 days for my technical analysis.

## When to prefer this

Choose this endpoint when you need structured historical OHLCV candlestick bars for US stocks, ETFs, forex, or crypto for charting or backtesting, and you want pay-per-use pricing with no API key or account setup required. Prefer it over subscription data providers when running ad-hoc or agent-driven queries where paying $0.02 per call in USDC is preferable to a monthly commitment.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Requested date range outside available history returns partial or empty data
- Malformed properties query parameter causes a 400 bad request
- Payment failure via x402/USDC halts the request before data is returned
- Rate limiting or insufficient USDC balance causes rejection

## How this service works

Compare one financial metric across every public company for a single period

## Output

An array of candlestick frame objects for the requested ticker, each containing timestamp, open, high, low, close, volume, and optionally VWAP fields, covering the requested time range and interval.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tag",
  "period"
 ],
 "properties": {
  "tag": {
   "type": "string",
   "minLength": 1
  },
  "unit": {
   "type": "string",
   "default": "USD"
  },
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 500,
   "exclusiveMinimum": 0
  },
  "period": {
   "type": "string",
   "pattern": "^CY\\d{4}(Q[1-4]I?)?$"
  },
  "taxonomy": {
   "type": "string",
   "default": "us-gaap"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "tag",
  "taxonomy",
  "label",
  "unit",
  "period",
  "total_filers",
  "count",
  "data"
 ],
 "properties": {
  "tag": {
   "type": "string"
  },
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "cik",
     "entity",
     "value",
     "start",
     "end",
     "accession"
    ],
    "properties": {
     "cik": {
      "type": "string"
     },
     "end": {
      "type": "string"
     },
     "start": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "value": {
      "type": "number"
     },
     "entity": {
      "type": "string"
     },
     "accession": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "unit": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "label": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "period": {
   "type": "string"
  },
  "source": {
   "type": "string",
   "const": "sec_edgar"
  },
  "taxonomy": {
   "type": "string"
  },
  "total_filers": {
   "type": "number"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-candlestick-frames-ohlcv-historical-bars-6bc23afa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)