# Historical Forex Rate Lookup (ECB via Frankfurter)

> Historical Forex Rate Lookup (ECB via Frankfurter) is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Returns historical foreign exchange rates for a specific date using European Central Bank data going back to 1999

## Facts

- Endpoint: GET https://api.x402node.dev/finance/forex-hist
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-48b0da98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3FklQ3TCdHZf8TumoNoKk

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 api-x402node-dev-48b0da98
```

Example prompt: What was the EUR to USD exchange rate on March 8, 2022? I need it for an accounting reconciliation.

## When to prefer this

Use this endpoint when you need a point-in-time historical forex rate for a specific past date, especially for back-testing, audit trails, accounting reconciliation, or financial reporting. It covers ECB data from 1999 onward, making it ideal for long-range historical lookups without needing your own API key or a premium data subscription.

## Known failure modes

- Date before 1999 — ECB data not available that far back
- Invalid currency code — unsupported or misspelled ISO 4217 code
- Weekend or market holiday — ECB may not have a rate; endpoint may return nearest available date or error
- Malformed date format — incorrect date string format
- Network or upstream Frankfurter API outage

## How this service works

x402node — precise, deterministic developer and data tools for AI agents. Chain data, parsing, crypto, conversion. Pay-per-call over x402, settled in USDC on Base.

## Output

Returns the historical exchange rate for the requested currency pair on the specified date, sourced from ECB data via Frankfurter, covering dates back to 1999. Includes the rate value, the base and target currencies, and the date.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Target format (required)"
      },
      "date": {
       "type": "string",
       "description": "Date YYYY-MM-DD (optional)"
      },
      "from": {
       "type": "string",
       "description": "Source format (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-48b0da98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)
