# EU Agent Utils – ECB FX Rate Converter

> EU Agent Utils – ECB FX Rate Converter is a paid API for AI agents from eu-agent-utils.frcompanycheck.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Converts a currency amount between any two ISO 4217 currencies using official ECB euro reference rates, optionally for a specific historical date.

## Facts

- Endpoint: GET https://eu-agent-utils.frcompanycheck.workers.dev/v1/fx/convert?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-agent-utils-ecb-fx-rate-converter-71f390be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xkVoVxyLL5IU34-oTvIkH

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 eu-agent-utils-ecb-fx-rate-converter-71f390be
```

Example prompt: Convert 750 USD to EUR using the official ECB reference rate for 2024-11-15.

## When to prefer this

Prefer this endpoint when you need deterministic, officially-sourced ECB euro reference rates for European financial calculations, auditing, invoicing, or compliance — especially when you want no account or API key setup overhead and pay per call in USDC. Choose over open market rate APIs when regulatory or accounting accuracy from the ECB source is required.

## Known failure modes

- Unsupported or non-ECB-quoted currency pair returns an error (e.g. exotic currencies not tracked by ECB)
- Date outside ECB data availability (future dates or very old dates) returns an error
- Missing required 'from' or 'to' query parameters returns a validation error
- Errors are not charged — payment only occurs on successful responses

## How this service works

Cheap, deterministic utilities for AI agents, paid per call in USDC with x402 (no account, no API key): ECB euro reference FX rates and conversion, IANA time-zone conversion with explicit DST handling, European public holidays and working-day calculator (FR incl. Alsace-Moselle, BE, LU, DE, AT, IT, ES, PT), offline IBAN validation, and SIREN/SIRET and EU VAT number check-digit validation. Errors are never charged.

## Output

Returns a JSON object with the source currency, target currency, date of the rates used, the ECB reference rate, the input amount, the converted result, and the full ECB rates-vs-EUR table used for the computation.

## 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",
       "example": "EUR",
       "description": "Target currency (ISO 4217)"
      },
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD, optional"
      },
      "from": {
       "type": "string",
       "example": "USD",
       "description": "Source currency (ISO 4217)"
      },
      "amount": {
       "type": "number",
       "example": 100,
       "description": "Amount, default 1"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "EUR",
  "date": "2026-10-09",
  "from": "USD",
  "rate": 0.89237908,
  "amount": 100,
  "result": 89.237908,
  "ecb_rates_vs_eur": {
   "EUR": 1,
   "USD": 1.1206
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-agent-utils-ecb-fx-rate-converter-71f390be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eu-agent-utils.frcompanycheck.workers.dev](https://www.zero.xyz/host/eu-agent-utils.frcompanycheck.workers.dev/llms.txt)