# EU Agent Utils – ECB FX Rates (x402)

> EU Agent Utils – ECB FX Rates (x402) 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).

Returns ECB euro reference exchange rates for a given date and optional currency filter, paid per call in USDC via x402

## Facts

- Endpoint: GET https://eu-agent-utils.frcompanycheck.workers.dev/v1/fx/latest?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-rates-x402-6472640e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_twZdHRRX_5yNQJaDu5MU3

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-rates-x402-6472640e
```

Example prompt: What are today's official ECB euro reference rates for USD, GBP, and JPY?

## When to prefer this

Use this endpoint when you need official, authoritative ECB euro reference rates without setting up an API account or key, especially for European accounting, invoicing, or compliance use cases where ECB rates are the accepted standard. Prefer this over commercial FX APIs when auditability and ECB provenance matter, and when you want deterministic, pay-per-call pricing via x402 with no subscription.

## Known failure modes

- Date out of range (older than 90 days) — falls back to previous valid publication day rather than erroring
- Invalid currency code in 'symbols' — may return empty rates map or error
- Weekend/holiday date — falls back to the most recent prior ECB publication day
- Network or worker timeout — no charge on error

## 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

A JSON object containing the base currency (default EUR), the ECB publication date, a map of currency codes to their exchange rates, an ECB source attribution string, and a boolean indicating whether rates are derived rather than directly published.

## 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",
     "properties": {
      "base": {
       "type": "string",
       "example": "EUR",
       "pattern": "^[A-Za-z]{3}$",
       "description": "Base currency (ISO 4217), default EUR"
      },
      "date": {
       "type": "string",
       "example": "",
       "description": "YYYY-MM-DD (last 90 days; falls back to the previous publication day)"
      },
      "symbols": {
       "type": "string",
       "example": "USD,GBP,JPY",
       "description": "Comma-separated currencies to return (default all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "EUR",
  "date": "2026-10-09",
  "rates": {
   "GBP": 0.84763,
   "JPY": 177.34,
   "USD": 1.1206
  },
  "source": "Source: ECB statistics ...",
  "derived": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-agent-utils-ecb-fx-rates-x402-6472640e/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)
