# Basebuilder2 Stocks – Forex Time Series

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

Returns historical time-series exchange rate data for a currency pair over a specified date range

## Facts

- Endpoint: POST https://bbx-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/basebuilder2-stocks-forex-time-series-968b0e91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K2DX2D0tB4BOzaFoE7QJO

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 basebuilder2-stocks-forex-time-series-968b0e91 -d '<json body>'
```

Example prompt: Can you pull the daily EUR/USD exchange rate time series for the past 3 months so I can analyze the trend?

## When to prefer this

Choose this endpoint when you need structured historical forex exchange rate time-series data for analysis, backtesting, charting, or financial modeling. It is a paid, on-demand endpoint suited for agents that require reliable FX history without managing their own data pipeline. Prefer it over general financial APIs when operating in a crypto-payment (x402/USDC) context or when integrating with other Basebuilder Stocks endpoints on the same hub.

## Known failure modes

- Invalid or unsupported currency pair returns an error
- Date range too large or out of supported historical bounds
- Malformed date format in request body
- Missing required fields such as currency symbols or date range
- Payment not processed or insufficient USDC balance (402 error)
- Rate-limit or quota exceeded on paid tier

## How this service works

BaseBuilder Stocks API hub - 21 paid endpoints

## Output

Returns a structured time-series array of exchange rate data points for the requested currency pair and date range, typically including timestamps and rate values (open, high, low, close) at the specified interval.

## More

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