# finanz.halowerk.com FX Snapshot

> finanz.halowerk.com FX Snapshot is a paid API for AI agents from finanz.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns ECB reference rates for one or more currency pairs against a base currency, optionally with a comparison date to compute percentage changes, marking cross rates through EUR as derived.

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/fx-snapshot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finanz-halowerk-com-fx-snapshot-57ae8194
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-Cs079Xr-g0LStKT_gMn4

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 finanz-halowerk-com-fx-snapshot-57ae8194 -d '<json body>'
```

Example prompt: What are today's ECB reference rates for USD, GBP, and JPY against EUR, and how have they changed in percent compared to last Monday?

## When to prefer this

Choose this endpoint when you need official ECB reference rates (not mid-market or broker rates) for one or more currency pairs, especially when you also want a built-in percentage-change calculation between two dates without making a second API call. It is ideal for compliance or reporting contexts that require ECB-sourced data, and for deriving cross rates between non-EUR pairs in a single request.

## Known failure modes

- Unsupported or misspelled currency code returns an error or missing entry
- Dates falling on ECB non-publication days (weekends, holidays) may return no rate
- Comparison date equal to value date yields 0% change but no error
- Network or upstream frankfurter.dev outage returns a 5xx error
- Requesting a very old historical date beyond the ECB data archive may return empty results

## How this service works

Returns European Central Bank reference rates through frankfurter.dev: one base currency against the symbols you name, each with the value date the rate belongs to. Optionally a comparison date is fetched too and the change per currency is computed in percent, so a move is visible without a second call. Cross rates between two non-euro currencies are derived through the base and marked as derived.

## Output

Returns a JSON object with the base currency, one or more target currency rates each labeled with their ECB value date, and optionally percentage change values if a comparison date was requested. Cross rates between two non-euro currencies are flagged as derived (computed through EUR as the intermediary).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "base": {
   "type": "string",
   "default": "EUR",
   "maxLength": 3,
   "minLength": 3,
   "description": "Base currency, three letters, e.g. EUR, USD, CHF."
  },
  "date": {
   "type": "string",
   "maxLength": 10,
   "description": "Value date as YYYY-MM-DD. Latest working day if omitted."
  },
  "amount": {
   "type": "number",
   "minimum": 0,
   "description": "Convert this amount into every target currency."
  },
  "symbols": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 3,
    "minLength": 3
   },
   "maxItems": 30,
   "description": "Target currencies. All available if omitted."
  },
  "compare_date": {
   "type": "string",
   "maxLength": 10,
   "description": "Second date; the change per currency is computed against it."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finanz-halowerk-com-fx-snapshot-57ae8194/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)