# The Stall — Forex Historical Rates

> The Stall — Forex Historical Rates is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.059/call, status unknown (last checked 2026-09-13).

Returns historical and current foreign exchange rates from ECB data, with optional time-series ranges and point-in-time currency conversion, paid via USDC on Base mainnet.

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/forex-historical
- Price: $0.059/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-stall-forex-historical-rates-b39928e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WUPEAdRiBRxcdikCcgPDV

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 the-stall-forex-historical-rates-b39928e2
```

Example prompt: What was the exchange rate from USD to EUR, GBP, and JPY on 2023-03-15 according to ECB data? Also convert 1000 USD to EUR at that date's rate.

## When to prefer this

Use this endpoint when you need ECB-sourced historical or current forex rates for up to 30 currencies, especially when you need point-in-time currency conversion or multi-date time-series data. Prefer this over live-ticker APIs when accuracy against ECB reference rates matters (e.g. accounting, reporting, financial analysis). No API key required — just pay $0.005 USDC per call via x402 on Base mainnet.

## Known failure modes

- Date before 1999-01-04 — historical data not available, likely returns an error or empty result
- Weekend or ECB holiday date — ECB does not publish rates on non-business days, may return null or nearest prior date
- Invalid ISO 4217 currency symbol — unrecognized currency codes return an error or are omitted
- Date range exceeding 365 days — may return partial results or an error
- Missing required 'date' parameter — returns a 400-level validation error
- Payment failure or insufficient USDC balance — returns HTTP 402

## How this service works

Historical ECB exchange rates — single date lookup or time-series range. Returns rates for up to 30 major currencies (EUR, GBP, JPY, CAD, CHF, CNY, AUD, KRW, etc.) from 1999-01-04 to present. Free, no key, sourced from Frankfurter/ECB. Use for: tax-date FX rates, historical expense reconciliation, multi-year trend analysis, point-in-time currency conversion. Weekends and holidays return the nearest prior business day. Complements forex-rates (real-time) with retrospective data.

## Output

Returns a JSON object containing exchange rates for the requested currencies relative to the base currency (default USD) on the specified date. For time-series requests, rates are keyed by date. Optionally includes a converted amount when conversion parameters are provided. Data sourced from ECB, available from 1999-01-04 onward.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "base": "USD",
   "date": "2023-03-15",
   "symbols": [
    "EUR",
    "GBP",
    "JPY"
   ]
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-stall-forex-historical-rates-b39928e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)