# Eckari ECB FX Reference Rate

> Eckari ECB FX Reference Rate is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns the official European Central Bank euro foreign exchange reference rate for a currency pair, either the latest fix or any date within the last 90 days

## Facts

- Endpoint: GET https://api.eckari.com/v1/fx/reference-rate?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/eckari-ecb-fx-reference-rate-61d19dd6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8cS1yrR_mzlOsyl_XDL5T

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 eckari-ecb-fx-reference-rate-61d19dd6
```

Example prompt: What is the official ECB euro reference rate for EUR to USD today? I need the verified daily fix for an invoice I'm issuing.

## When to prefer this

Use this endpoint when you need an authoritative, verifiable, official exchange rate that both parties to a contract, invoice, or accounting entry can independently confirm against the ECB — not for live tradable rates or high-frequency pricing. Prefer this over market rate APIs when regulatory compliance, auditability, or official reporting is required. Ideal for EUR-centric accounting, EU cross-border invoicing, and any workflow where the rate source must be the ECB daily fix.

## Known failure modes

- Requested currency not in ECB reference rate list for that date — endpoint may return an error or empty result
- Date outside the 90-day window — request rejected
- Date is a weekend or TARGET closing day — the latest prior fix is returned with a note field explaining the substitution
- ECB has not yet published the fix for the current day (before ~16:00 CET) — prior day fix returned with a note
- Malformed ISO 4217 currency code (not exactly 3 letters) — validation error from schema
- Non-TARGET working day requested — fallback rate returned transparently

## How this service works

European Central Bank euro foreign exchange reference rate for a pair - the official daily fix used for accounting, invoicing and reporting - latest or any date in the last 90 days. The ECB publishes EUR/XXX only, so inverse and cross rates are computed from the same fix and named in rate_derivation. One fix per TARGET working day, not a tradable market rate. Use when: Convert or report an amount at an official daily rate both sides of a contract can verify against the ECB.

## Output

A JSON object containing the exchange rate (as a string decimal), the base and quote currency codes, the date the rate applies to, whether the rate was directly published by the ECB or derived as an inverse or cross rate, the published ECB pairs used in the calculation, an optional note explaining if the returned date differs from the requested date (e.g. weekend or TARGET closing day), and metadata including source, version, and freshness indicator.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "base",
      "quote"
     ],
     "properties": {
      "base": {
       "type": "string",
       "pattern": "^[A-Za-z]{3}$",
       "description": "ISO 4217 code of the base currency. EUR is always available; other currencies must be in the ECB reference rate list for the selected date."
      },
      "date": {
       "type": "string",
       "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
       "description": "Optional ISO calendar date (YYYY-MM-DD) within the last 90 days. When the ECB published no fix on that date (a TARGET closing day), the latest prior fix is returned with a note."
      },
      "quote": {
       "type": "string",
       "pattern": "^[A-Za-z]{3}$",
       "description": "ISO 4217 code of the quote currency. EUR is always available; other currencies must be in the ECB reference rate list for the selected date."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "base": "EUR",
   "note": "no ECB fix published for today yet (weekend, TARGET closing day, or before the ~16:00 CET publication); the latest published fix is returned",
   "rate": "1.159300",
   "quote": "USD",
   "rate_date": "2026-08-17",
   "rate_kind": "reference",
   "rate_derivation": "published",
   "published_pairs_used": [
    "EUR/USD"
   ]
  },
  "meta": {
   "source": "ecb_fx",
   "version": "2.1.0",
   "freshness": "near_live",
   "capability": "fx.reference_rate"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-ecb-fx-reference-rate-61d19dd6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)