# x402.shizu.me FX Rates

> x402.shizu.me FX Rates is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-16).

Returns ECB reference foreign-exchange rates for 30+ fiat currencies, supporting a base currency, optional symbol filtering, and historical dates back to 1999.

## Facts

- Endpoint: GET https://x402.shizu.me/fx
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-shizu-me-fx-rates-fa7c4e16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_36nPAWL_9czK7zyhYsRVa

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 x402-shizu-me-fx-rates-fa7c4e16
```

Example prompt: What are today's ECB reference exchange rates for EUR, GBP, and JPY relative to USD? Also pull the same rates for 2020-01-15 so I can compare.

## When to prefer this

Use this endpoint when you need reliable ECB-sourced fiat currency exchange rates, especially for EUR-centric or multi-currency international pricing, historical rate lookups back to 1999, or lightweight FX monitoring without needing real-time tick data. Prefer over crypto-exchange rate endpoints when dealing purely with fiat currencies.

## Known failure modes

- Invalid base currency code returns an error or empty rates
- Invalid date format or out-of-range date (before 1999) returns an error
- Requested symbol not found in ECB dataset returns missing key or error
- Network or upstream ECB data unavailability returns 5xx error
- Payment failure (x402) prevents access to the endpoint

## How this service works

Foreign-exchange rates for 30+ fiat currencies (ECB reference data). Query: base (3-letter code, default USD), symbols (optional comma list, e.g. EUR,GBP,JPY), date (optional YYYY-MM-DD for historical rates back to 1999). Returns {base, date, rates}. Use for currency conversion, international pricing, and FX monitoring.

## Output

A JSON object with three fields: 'base' (the base currency code), 'date' (the effective date of the rates), and 'rates' (an object mapping each requested or all available currency codes to their exchange rate relative to the base currency).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "base",
      "symbols"
     ],
     "properties": {
      "base": {
       "type": "string"
      },
      "symbols": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "date": "2026-07-07",
  "rates": {
   "EUR": 0.851,
   "GBP": 0.734,
   "JPY": 144.1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-shizu-me-fx-rates-fa7c4e16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)