# Currency Exchange Rates (ECB Reference Rates)

> Currency Exchange Rates (ECB Reference Rates) is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns official ECB reference exchange rates for ~35 currencies for today or any historical date since 1999, optionally converting a specific amount from a base currency.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/finance/fx?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/currency-exchange-rates-ecb-reference-rates-855b76f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X5T9J-9zhaHHhFi66Rpiw

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 currency-exchange-rates-ecb-reference-rates-855b76f1
```

Example prompt: What's today's ECB exchange rate for EUR to USD, GBP, and JPY — and can you also tell me how much 2500 EUR would be in each of those currencies?

## When to prefer this

Prefer this endpoint when you need official, authoritative ECB reference rates for fiat currency conversion — especially for financial documents like invoices, salaries, or accounting records where ECB rates are the regulatory standard. Choose this over crypto price feeds for fiat-only conversions. Use when historical rates back to 1999 are needed or when a specific date's rate is required.

## Known failure modes

- Invalid currency code returns an error or omits the currency from results
- Dates before 1999 are out of range and will fail
- Weekend or holiday dates fall back to the previous ECB fixing day — agent should note the actual date returned
- Unsupported currencies not in the ECB ~35-currency basket will be missing from results
- Network timeouts possible as service runs on a shared Render instance

## How this service works

Official ECB reference exchange rates for about 35 currencies (USD, EUR, GBP, JPY, CNY, INR, AED, SAR and more) for today or any date since 1999, from any base currency, with optional amount conversion. Use to convert prices, invoices or salaries between currencies.

## Output

Returns a JSON object containing the base currency, the date of the fixing (adjusted to the last business day if a weekend or holiday), and a map of target currency codes to their exchange rates (and optionally the converted amount if an amount was specified).

## 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": [],
     "properties": {
      "base": {
       "type": "string",
       "description": "Base currency, default USD"
      },
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD (default latest; weekends use the previous fixing)"
      },
      "amount": {
       "type": "number",
       "description": "Amount to convert, default 1"
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated target currencies (default all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/currency-exchange-rates-ecb-reference-rates-855b76f1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)