# Greeneris FX History

> Greeneris FX History is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns historical ECB foreign exchange rates for a date range or single day, with EUR as default base currency

## Facts

- Endpoint: GET https://data.greeneris.io/v1/fx/history
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-fx-history-ff0c5b9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UhuQXsVoh3PWPhszsbOWF

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 greeneris-fx-history-ff0c5b9f
```

Example prompt: Can you pull the ECB historical exchange rates for EUR against USD and GBP from April 1 to April 30, 2026?

## When to prefer this

Use this endpoint when you need official ECB reference exchange rates for historical analysis, accounting reconciliation, or audit trails. Prefer this over commercial FX providers when official EU regulatory data sourcing is required. Ideal for date-range series (up to 366 days) or single-day lookups with up to 12 currency pairs. Pay-per-call with no account required makes it suitable for low-frequency or one-off agent tasks.

## Known failure modes

- Date range exceeds 366 days — request will be rejected
- Invalid currency code returns error or empty rates
- start date before 1999 may return no data
- Single date and start/end range used together — mutually exclusive
- Non-business days return no rate entries (ECB only publishes on business days)
- HTTP 402 returned if payment not provided — machine-readable quote included
- More than 12 symbols requested — exceeds limit

## How this service works

European Central Bank reference exchange rates for any past date or date range (business days since 1999-01-04), via frankfurter.dev. Query: ?date=2026-05-01 for one day, or ?start=2026-05-01&end=2026-05-08 for a daily series (max 366 days), plus ?base=EUR&symbols=USD,GBP (symbols optional -> all). Series responses nest rates by date. Historical data is immutable; served with a 24h cache.

## Output

A JSON object with the base currency, a date-keyed map of daily exchange rates for requested symbols (business days only, since 1999), the data source (ECB reference rates via frankfurter.dev), and the effective start and end dates of the series.

## 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",
     "properties": {
      "end": {
       "type": "string",
       "description": "Series end YYYY-MM-DD (default today, max 366 days after start)"
      },
      "base": {
       "type": "string",
       "default": "EUR",
       "description": "Base currency code"
      },
      "date": {
       "type": "string",
       "description": "Single day YYYY-MM-DD (mutually exclusive with start/end)"
      },
      "start": {
       "type": "string",
       "description": "Series start YYYY-MM-DD"
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated target currencies, max 12 (optional -> all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "EUR",
  "rates": {
   "2026-04-30": {
    "USD": 1.1702
   },
   "2026-05-04": {
    "USD": 1.17
   },
   "2026-05-05": {
    "USD": 1.1686
   }
  },
  "source": "ECB reference rates via frankfurter.dev (business days, since 1999)",
  "end_date": "2026-05-08",
  "start_date": "2026-04-30"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-fx-history-ff0c5b9f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)