# Orbit Econ Data – ECB Foreign Exchange Rates

> Orbit Econ Data – ECB Foreign Exchange Rates 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-30).

Returns the latest or historical ECB foreign-exchange reference rates for ~30 major currencies against a specified base currency

## Facts

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

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-ecb-foreign-exchange-rates-d5175347
```

Example prompt: Can you pull the latest ECB foreign exchange reference rates with USD as the base currency, and show me the rates for EUR, GBP, JPY, and CNY?

## When to prefer this

Choose this endpoint when you need official ECB foreign-exchange reference rates for major fiat currencies, either the latest or for a specific historical date back to 1999. It is ideal for financial reporting, invoice reconciliation, and compliance use cases that require authoritative central-bank rates. It does not cover cryptocurrencies or exotic currencies not in the ECB set — use a dedicated crypto or exotic FX provider for those.

## Known failure modes

- Unsupported base currency returns an error — only ECB-covered currencies (~30 majors) are valid
- Date before 1999-01-04 returns an error — ECB data only goes back to that date
- Weekend or holiday date may return the previous business day's rates or an error
- Invalid ISO 4217 currency code in symbols param returns an error or is silently omitted
- No ECB data for a specific date (e.g. holiday) may fall back to nearest available date

## 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 currency code, the rate date (YYYY-MM-DD), and a map of target currency codes to their exchange rates relative to the base — e.g. {"base":"USD","date":"2026-10-23","rates":{"EUR":0.893,"GBP":0.771,"JPY":151.2}}

## 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": {
       "type": "string",
       "description": "ISO 4217 base (default USD)"
      },
      "date": {
       "type": "string",
       "description": "optional YYYY-MM-DD (from 1999-01-04)"
      },
      "symbols": {
       "type": "string",
       "description": "comma-separated targets (default all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "date": "2026-10-23",
  "rates": {
   "CNY": 7.12,
   "EUR": 0.89342,
   "GBP": 0.7712,
   "JPY": 151.2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbit-econ-data-ecb-foreign-exchange-rates-d5175347/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)