# ECB Reference Rate Currency Converter

> ECB Reference Rate Currency Converter is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Converts a monetary amount between two currencies using the European Central Bank reference rate for today or a specified past date

## Facts

- Endpoint: POST https://twin.unykorn.org/records/fx-convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-reference-rate-currency-converter-72c60456
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yIWr_CFBAAnLS8Vfz6yPF

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-reference-rate-currency-converter-72c60456 -d '<json body>'
```

Example prompt: Convert 2500 USD to EUR using the ECB reference rate from March 10, 2024.

## When to prefer this

Choose this endpoint when you need the official ECB (European Central Bank) reference rate for currency conversion, especially for financial, accounting, or compliance use cases where the ECB rate is the authoritative source. It is particularly valuable for historical conversions on a specific past date. Prefer this over market-rate converters when regulatory or institutional accuracy is required, or when the ECB rate is contractually specified.

## Known failure modes

- Unsupported or invalid 3-letter currency code returns an error — ECB only publishes rates for a subset of currencies
- Future dates or dates before ECB data availability will return an error or empty result
- Weekend or ECB holiday dates may return no rate (ECB does not publish rates on non-business days)
- Amount exceeding 1,000,000,000,000,000 is rejected by schema validation
- Missing required fields (from, to, amount) result in a validation error

## How this service works

Currency conversion at the ECB reference rate (today or a past date) — Genesis402 / UnyKorn Operator Network

## Output

Returns the converted monetary amount computed from the ECB official reference rate for the requested currency pair and date (defaulting to today if no date is provided), along with the exchange rate applied and relevant metadata such as the date used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "to": {
     "type": "string",
     "description": "required 3-letter code"
    },
    "date": {
     "type": "string",
     "description": "optional YYYY-MM-DD"
    },
    "from": {
     "type": "string",
     "description": "required 3-letter code"
    },
    "amount": {
     "type": "number",
     "maximum": 1000000000000000,
     "minimum": 0,
     "description": "required"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "fx-convert",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.001,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-reference-rate-currency-converter-72c60456/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)