# ECB Currency Rates Converter

> ECB Currency Rates Converter is a paid API for AI agents from onchaincheck.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Converts an amount between two currencies using the European Central Bank daily reference rate, returning the rate, converted amount, and rate date.

## Facts

- Endpoint: GET https://onchaincheck.dev/fx/convert?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-currency-rates-converter-ae6de72f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FAjlandAT2PTfVDD2Kw7V

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 ecb-currency-rates-converter-ae6de72f
```

Example prompt: What's 250 US dollars in Canadian dollars at the ECB's official rate? Use today's rate.

## When to prefer this

Choose this endpoint when you need an authoritative, neutral official exchange rate from the European Central Bank rather than a commercial bank or broker rate. Ideal for compliance, accounting, invoicing, or regulatory contexts where the ECB daily reference rate is specifically required. Supports historical rate lookups by date, making it suitable for auditing past transactions.

## Known failure modes

- Invalid ISO 4217 currency code returns an error (e.g. unsupported or misspelled currency)
- Date falls on a weekend or ECB holiday when no rate was published — may return nearest available date or an error
- Amount is not a valid positive number — schema validation failure
- Requested date is in the future — no ECB rate available
- ECB data source (frankfurter.dev) is temporarily unavailable — upstream dependency failure

## How this service works

Convert an amount between two currencies at the European Central Bank daily reference rate, latest or for a past date, returning the rate used, the result, and the rate date.

## Output

A JSON object containing: the source currency (from), target currency (to), the original amount, the ECB reference rate used, the converted result, the date of the rate used, and a source attribution string crediting the European Central Bank via frankfurter.dev.

## 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",
      "amount"
     ],
     "properties": {
      "to": {
       "type": "string",
       "pattern": "^[A-Za-z]{3}$",
       "description": "ISO 4217 target currency"
      },
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Past date YYYY-MM-DD; latest if omitted"
      },
      "from": {
       "type": "string",
       "pattern": "^[A-Za-z]{3}$",
       "description": "ISO 4217 source currency"
      },
      "amount": {
       "type": "string",
       "pattern": "^\\d+(\\.\\d+)?$",
       "description": "Amount in the source currency"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "CAD",
  "date": "2026-10-22",
  "from": "USD",
  "rate": 1.4034,
  "amount": 250,
  "result": 350.85,
  "source": "European Central Bank reference rates via frankfurter.dev"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-currency-rates-converter-ae6de72f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchaincheck.dev](https://www.zero.xyz/host/onchaincheck.dev/llms.txt)