# Gapup Historical Price Series

> Gapup Historical Price Series is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Retrieves historical OHLCV price data and derived metrics for stocks, ETFs, crypto, futures, and indices over configurable look-back periods and bar intervals via Yahoo Finance.

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/historical_price_series
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-historical-price-series-a524e4c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wij5HqMatv68JQOUn5WlW

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 gapup-historical-price-series-a524e4c3 -d '<json body>'
```

Example prompt: Pull daily adjusted close prices, volume, and returns for AAPL over the last 2 years so I can run a backtest.

## When to prefer this

Use this endpoint when you need structured historical OHLCV time-series data for equities, ETFs, indices, crypto, or futures across global exchanges. It supports wide look-back windows (up to max) and multiple bar intervals (daily, weekly, monthly), making it ideal for backtesting, charting, volatility analysis, and quantitative research. Prefer it over real-time quote endpoints when you need a historical series rather than a snapshot.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Unsupported interval/period combination may return an error
- Yahoo Finance data unavailability for certain tickers or date ranges returns empty series
- Network timeout for very long series; use async=true to avoid client timeout
- Authentication failure (missing or invalid Bearer token) returns 401

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A JSON object containing the tool name and a result payload with historical price bars for the requested ticker. Each bar includes open, high, low, close, and volume fields, plus optional derived metrics like daily returns and rolling volatility, covering the full requested look-back period at the specified interval. Prices are split- and dividend-adjusted by default.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "period": {
   "enum": [
    "1mo",
    "3mo",
    "6mo",
    "1y",
    "2y",
    "5y",
    "10y",
    "max"
   ],
   "type": "string",
   "description": "Look-back period. Default: 1y."
  },
  "ticker": {
   "type": "string",
   "description": "Yahoo Finance ticker symbol. Examples: AAPL (US stock), SAP.DE (Frankfurt), 7203.T (Tokyo), BTC-USD (Bitcoin), GC=F (gold futures), ^GSPC (S&P 500)."
  },
  "metrics": {
   "type": "array",
   "items": {
    "enum": [
     "open",
     "high",
     "low",
     "close",
     "volume",
     "returns",
     "volatility"
    ],
    "type": "string"
   },
   "description": "Subset of fields to include (informational — all fields always returned)."
  },
  "adjusted": {
   "type": "boolean",
   "description": "Adjust close prices for dividends and splits. Default: true."
  },
  "interval": {
   "enum": [
    "1d",
    "1wk",
    "1mo"
   ],
   "type": "string",
   "description": "Bar interval. Default: 1d (daily)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "historical_price_series",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-historical-price-series-a524e4c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)