# BaseBuilder Stocks Forex Time Series

> BaseBuilder Stocks Forex Time Series is a paid API for AI agents from bb-stocks.vercel.app, paid per call via x402, $0.113143/call, status unknown (last checked 2026-09-14).

Returns historical time-series price data for a specified forex currency pair over a given date range

## Facts

- Endpoint: POST https://bb-stocks.vercel.app/api/forex/time-series
- Price: $0.113143/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder-stocks-forex-time-series-60110bd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j33WzuukFuV6aFN0QH1Wg

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 basebuilder-stocks-forex-time-series-60110bd0 -d '<json body>'
```

Example prompt: Can you pull the daily historical price data for EUR/USD from January 1, 2024 to June 30, 2024 using the BaseBuilder Stocks forex time series endpoint?

## When to prefer this

Use this endpoint when you need structured historical OHLCV forex data for backtesting trading strategies, charting currency trends, or performing time-based financial analysis. Prefer this over live/real-time endpoints when historical context is needed rather than current prices.

## Known failure modes

- Invalid or unsupported currency pair returns an error
- Date range out of available historical data bounds
- Missing required parameters (pair, start date, end date) results in 400-level error
- Payment failure (402) if USDC micropayment not provided
- Malformed POST body causes parse error

## How this service works

BaseBuilder Stocks API hub - 21 paid endpoints

## Output

A time-series dataset of OHLCV (open, high, low, close, volume) values for the requested forex currency pair across the specified date range and interval, returned as structured JSON records keyed by timestamp.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder-stocks-forex-time-series-60110bd0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bb-stocks.vercel.app](https://www.zero.xyz/host/bb-stocks.vercel.app/llms.txt)