# euroref European Government Reference Data – Historical Series

> euroref European Government Reference Data – Historical Series is a paid API for AI agents from euroref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns historical time-series data for a specific European government reference value (e.g. central-bank policy rate, VAT rate, minimum wage, or public holidays) for a given country, with official citations and staleness flags.

## Facts

- Endpoint: GET https://euroref.dev/v1/%7Bcountry%7D/%7Bseries%7D/history
- 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/euroref-european-government-reference-data-historical-series-e273315a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NqqM091DFxoLsKxy5yuNx

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 euroref-european-government-reference-data-historical-series-e273315a
```

Example prompt: Can you get me the full history of Germany's ECB policy rate from euroref, with the official citation and effective dates for each value?

## When to prefer this

Choose this endpoint when you need authoritative, citeable European government reference values (ECB rates, VAT, minimum wages, public holidays) for Germany or France, especially when you require an official primary-source citation, an effective date, and a staleness indicator. Prefer it over general web search or LLM knowledge when regulatory compliance, auditability, or up-to-date accuracy is required. It is not suitable for countries beyond Germany and France, or for non-reference data such as GDP, CPI, or market prices.

## Known failure modes

- Unsupported country code returns a 404 or error response
- Unsupported series identifier returns a 404 or error response
- Data may be stale if the official source has not been re-confirmed recently (staleness flag will be true)
- Response may be truncated or incomplete if the upstream official source is inaccessible
- Payment required (HTTP 402) if x402 payment header is not provided

## How this service works

Authoritative European government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Germany (de), France (fr). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.

## Output

A JSON object containing the historical time-series for the requested country/series combination. Each entry includes the numeric value (with unit), effective date, last-confirmed date, a staleness boolean, the series identifier, country code, an official primary-source citation (name and URL), and explanatory notes where applicable. A disclaimer about independence from government is also included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "percent",
  "notes": "STRUCTURAL NOTE: Germany has NO national policy rate. The Deutsche Bundesbank has had no independent monetary-policy competence since 1 January 1999; monetary policy for the euro area is set by the ECB Governing Council under Art. 127-133 TFEU and the ESCB/ECB Statute. The value served is the euro-area-wide ECB deposit facility rate (DFR), which applies identically in all 20 euro-area members, not a German-specific rate. On 11 June 2026 the Governing Council raised all three key rates by 25 basis points with effect from 17 June 2026: deposit facility 2.25%, main refinancing operations (MRO) 2.40%, marginal lending facility 2.65%. This was the first ECB increase since September 2023, reversing part of the eight cuts delivered between June 2024 and June 2025; the ECB cited energy-driven inflation pressure from the Middle East conflict. The DFR is served here because since the 18 March 2024 framework change the ECB steers short-term money-market rates through the DFR and narrowed the MRO-DFR spread to 15bp; the MRO rate (2.40%) remains the headline 'refinancing' rate cited by some sources. No Governing Council monetary-policy meeting fell between 17 June 2026 and the last_confirmed date, so 2.25% is still in force. Note separately that the German statutory Basiszinssatz under Section 247 BGB, published semi-annually by the Bundesbank and used for default interest, is a distinct national figure and is NOT a monetary policy rate. Access: ecb.europa.eu serves the full key-rates table as static HTML and loaded cleanly.",
  "stale": false,
  "value": 2.25,
  "series": "policy-rate",
  "source": {
   "url": "https://www.ecb.europa.eu/press/pr/date/2026/html/ecb.mp260611~4d41bd5e83.en.html",
   "name": "European Central Bank, Monetary policy decisions of the Governing Council, 11 June 2026 (press release ecb.mp260611); Key ECB interest rates statistical table"
  },
  "country": "DE",
  "disclaimer": "Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.",
  "effective_from": "2026-06-17",
  "last_confirmed": "2026-07-20"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-european-government-reference-data-historical-series-e273315a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from euroref.dev](https://www.zero.xyz/host/euroref.dev/llms.txt)