# Financial Data x402 – Stock Price History

> Financial Data x402 – Stock Price History is a paid API for AI agents from x402-stock-indicators.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns OHLCV (open, high, low, close, volume) price bar history for a stock ticker over a specified date range and timespan granularity, paid per-call via USDC over the x402 protocol.

## Facts

- Endpoint: GET https://x402-stock-indicators.vercel.app/history/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-stock-price-history-c5618b41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cq_NEmfhHtthl2_Pr30cm

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 financial-data-x402-stock-price-history-c5618b41
```

Example prompt: Pull the daily price bars for AAPL from January 1 2026 to July 1 2026 — I need the open, high, low, close, and volume for each day.

## When to prefer this

Choose this endpoint when you need structured OHLCV candlestick history for US equities across flexible timespans (minute through month) without committing to a subscription or managing API keys — ideal for per-call agent workflows, backtesting pipelines, or one-off research queries paid with USDC on Base or Solana via x402.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty bar array
- Date range outside available data returns zero bars or a truncated result
- Unsupported multiplier for a given timespan returns a validation error
- Payment failure or insufficient USDC balance causes a 402 Payment Required response
- Future dates or weekend-only ranges return no trading data
- Malformed date format causes a 400 Bad Request

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

A JSON object containing the ticker symbol, requested date range, timespan and multiplier (interval), an array of OHLCV bars each with open, high, low, close, volume, and timestamp, plus the total bar count and a truncated flag indicating whether the result was capped.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL, TSLA, MSFT"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "multiplier",
      "timespan",
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date",
       "description": "End date, e.g. 2026-07-01"
      },
      "from": {
       "type": "string",
       "format": "date",
       "description": "Start date, e.g. 2026-01-01"
      },
      "timespan": {
       "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
       ],
       "type": "string"
      },
      "multiplier": {
       "type": "integer",
       "description": "Bar size multiplier. Supported per timespan: minute(1,2,5,15,30,60,90), hour(1), day(1,5), week(1), month(1,3)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-07-10",
  "bars": [
   {
    "c": 294.38,
    "h": 296.59,
    "l": 289.2,
    "o": 293.44,
    "t": "2026-07-01T00:00:00-04:00",
    "v": 50164200
   },
   {
    "c": 308.63,
    "h": 309.42,
    "l": 293.68,
    "o": 294.12,
    "t": "2026-07-02T00:00:00-04:00",
    "v": 75352800
   }
  ],
  "from": "2026-07-01",
  "ticker": "AAPL",
  "interval": "1d",
  "timespan": "day",
  "bar_count": 2,
  "truncated": false,
  "multiplier": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-stock-price-history-c5618b41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-stock-indicators.vercel.app](https://www.zero.xyz/host/x402-stock-indicators.vercel.app/llms.txt)