# Orbit Econ Data: FX History (ECB)

> Orbit Econ Data: FX History (ECB) is a paid API for AI agents from orbit-econ.orbit-builder.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Returns a daily ECB reference-rate time series for a currency pair over a date range (up to 1 year), including summary statistics like min, max, mean, and % change.

## Facts

- Endpoint: GET https://orbit-econ.orbit-builder.workers.dev/v1/fx-history?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orbit-econ-data-fx-history-ecb-fd9c1eea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iWIxmOEgAXeNCCaX8Nyac

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 orbit-econ-data-fx-history-ecb-fd9c1eea
```

Example prompt: Can you pull the ECB daily exchange rate history for EUR against USD from September 1 to October 31 this year, and tell me the min, max, mean, and overall percentage change?

## When to prefer this

Choose this endpoint when you need authoritative ECB reference-rate time series data for historical FX analysis, trend reporting, or statistical summaries (min/max/mean/change) over a specific date window up to one year. It is ideal for finance dashboards, compliance reporting, or any workflow that requires official ECB business-day rates rather than real-time market prices. Prefer it over spot-rate endpoints when historical trend or summary statistics are the primary need.

## Known failure modes

- Unsupported currency symbol returns an error — ECB covers only ~30 fiat currencies
- Date range exceeding 1 year may be rejected or truncated
- Weekends and public holidays have no ECB fixing and are absent from the series
- Invalid date format (non-YYYY-MM-DD) causes a bad request error
- Omitting the required symbol parameter without relying on default example input returns an error

## How this service works

Economic and country data for agents: European Central Bank FX reference rates, currency conversion and rate history (via Frankfurter), country reference facts for 250 countries, and the latest World Bank macro indicators (GDP, growth, inflation, population, unemployment…). Open data with attribution, fetched at call time. $0.001 per call. By orbit-builder.

## Output

A JSON object containing the base and target currency codes, the requested date range, a daily series of business-day ECB reference rates (date + rate), plus summary statistics: first rate, last rate, minimum, maximum, mean, number of data points, and percentage change over the period.

## 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": [
      "symbol"
     ],
     "properties": {
      "end": {
       "type": "string",
       "description": "YYYY-MM-DD (default today)"
      },
      "base": {
       "type": "string",
       "description": "ISO 4217 base (default USD)"
      },
      "start": {
       "type": "string",
       "description": "YYYY-MM-DD (default 30 days ago)"
      },
      "symbol": {
       "type": "string",
       "description": "target currency"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "end": "2026-10-23",
  "max": 0.8961,
  "min": 0.8822,
  "base": "USD",
  "last": 0.8934,
  "mean": 0.8901,
  "first": 0.8851,
  "start": "2026-09-23",
  "points": 22,
  "series": [
   {
    "date": "2026-09-23",
    "rate": 0.8851
   }
  ],
  "symbol": "EUR",
  "change_pct": 0.94
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbit-econ-data-fx-history-ecb-fd9c1eea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orbit-econ.orbit-builder.workers.dev](https://www.zero.xyz/host/orbit-econ.orbit-builder.workers.dev/llms.txt)