# 1gateway FX Rates (ECB Reference)

> 1gateway FX Rates (ECB Reference) is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns official ECB daily FX fixing rates for up to 30 currencies, with percentage change vs prior fixing and optional currency conversion for a specified amount.

## Facts

- Endpoint: GET https://1gateway.dev/v1/fx/rates?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/1gateway-fx-rates-ecb-reference-a8f34bda
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nRHqEd6KMmO1ZcDwmKvjY

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 1gateway-fx-rates-ecb-reference-a8f34bda
```

Example prompt: Can you get me the official ECB fixing rate for USD against KRW and JPY for today, and show me how much 100 USD converts to in each currency?

## When to prefer this

Use this endpoint when you need official, authoritative ECB reference rates — e.g. for financial reporting, audit trails, invoicing, or compliance where a market-rate provider would not be acceptable. It covers 30 major currencies with guaranteed daily ECB fixings and includes percent-change metadata and conversion in a single call, making it more convenient than querying the ECB directly. Not suitable for real-time intraday rates or currencies outside the ECB's 30-currency basket.

## Known failure modes

- Date out of range (beyond ~90 days history) returns an error
- Weekend or holiday dates are silently shifted to the prior TARGET day fixing
- Unsupported currency code in symbols or base returns an error
- Future dates are not supported
- Service unavailable before ~16:00 CET on a TARGET day (rates not yet published)

## How this service works

Use when you need an official daily FX rate or currency conversion (USD, EUR, KRW, JPY, CNY, GBP + 24 more). Input: base (default EUR), optional symbols (comma list), date (YYYY-MM-DD, last ~90 days; weekends use the prior fixing), amount. Output: JSON rates for the fixing date, % change vs prior fixing, converted amounts, raw ECB EUR rates. Source: ECB statistics, updated each TARGET day ~16:00 CET; reference only. Example: ?base=USD&symbols=KRW,JPY&amount=100

## Output

JSON object containing the actual fixing date used, requested currencies and their rates relative to the base, percentage change versus the prior TARGET day fixing, converted amounts if an amount was provided, raw ECB EUR reference rates, full currency names, and attribution notes indicating the ECB as the source.

## 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": [],
     "properties": {
      "base": {
       "enum": [
        "EUR",
        "USD",
        "JPY",
        "KRW",
        "CNY",
        "GBP",
        "AUD",
        "BRL",
        "CAD",
        "CHF",
        "CZK",
        "DKK",
        "HKD",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "ISK",
        "MXN",
        "MYR",
        "NOK",
        "NZD",
        "PHP",
        "PLN",
        "RON",
        "SEK",
        "SGD",
        "THB",
        "TRY",
        "ZAR"
       ],
       "type": "string",
       "default": "EUR",
       "examples": [
        "USD"
       ],
       "description": "Base currency, ISO 4217 (one of the 30 ECB reference currencies; default EUR)"
      },
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "examples": [
        "2026-10-09"
       ],
       "description": "Fixing date YYYY-MM-DD within the last ~90 days (default latest)"
      },
      "amount": {
       "type": "number",
       "minimum": 0,
       "examples": [
        100
       ],
       "description": "Amount in base currency to convert"
      },
      "symbols": {
       "type": "string",
       "pattern": "^[A-Za-z]{3}(,[A-Za-z]{3})*$",
       "examples": [
        "KRW,JPY,EUR"
       ],
       "description": "Comma-separated target currencies (default: all). Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "base",
      "date",
      "requestedDate",
      "previousDate",
      "rates",
      "changePctVsPrevious",
      "derived",
      "ecbEurRates",
      "names",
      "notes",
      "attribution"
     ],
     "properties": {
      "base": {
       "type": "string"
      },
      "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-fx-rates-ecb-reference-a8f34bda/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)