Frankfurter API (ECB FX)

Name: Frankfurter API (ECB FX)
Creator: Frankfurter API (ECB FX)
License: ecb-attrib-nomodify

Open · redistributedecb-attrib-nomodifyfx

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued

Temporal coverage

1999-01-04 – 2026-06-02

Frequencies

Daily

Licensing & provenance

License: ecb-attrib-nomodify
Required attribution: FX data from the ECB via Frankfurter
Redistribution: Permitted (served here)
Commercial use: Yes
Modification: Restricted

How to cite

European Central Bank euro foreign-exchange reference rates (via the Frankfurter API). Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

Access & mirrors

Download: Select & download frankfurter series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/frankfurter.html
Update cadence: daily
Update strategy: extend by date
Storage layout: Single grouped parquet: data/clean_full/frankfurter/frankfurter_fx_eur.parquet, columns series_key (e.g. 'EURUSD'), obs_date(date32), value(float64), zstd. Entire dataset built in-memory in a dict then written once. No raw dir, no sidecar.

Full description

Full-coverage ingest of Frankfurter (ECB euro foreign-exchange reference rates). Frankfurter serves the ECB daily reference rates with EUR as base. The full daily history runs 1999-01-04..today. We pull the ENTIRE range year-by-year (polite, retried) and union every currency that has EVER appeared -- including currencies the ECB has since stopped publishing (CYP, EEK, GRD, SIT, SKK, ROL, TRL, LTL, LVL, MTL, RUB, ARS, BGN, DZD, HRK, MAD, TWD), not just the ~30 that are currently active. GROUPED storage (anti-bloat): ONE Parquet for the whole source -- data/clean_full/frankfurter/frankfurter_fx_eur.parquet with columns: series_key (e.g. "EURUSD" == EUR-base reference rate for USD) obs_date (date32) value (units of the quoted currency per 1 EUR) License = ecb-attrib-nomodify (reservable id from configs/sources.yaml). Attribution: "FX data from the ECB via Frankfurter". Usage: python jobs/ingest_frankfurter.py --dry # enumerate only, no writes python jobs/ingest_frankfurter.py # full run

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "Frankfurter API (ECB FX)",
  "description": "Full-coverage ingest of Frankfurter (ECB euro foreign-exchange reference rates). Frankfurter serves the ECB daily reference rates with EUR as base. The full daily history runs 1999-01-04..today. We pull the ENTIRE range year-by-year (polite, retried) and union every currency that has EVER appeared…",
  "url": "https://econdatalibrary.com/frankfurter.html",
  "identifier": "frankfurter",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "creator": {
    "@type": "Organization",
    "name": "Frankfurter API (ECB FX)"
  },
  "license": "ecb-attrib-nomodify",
  "keywords": [
    "fx",
    "frankfurter"
  ],
  "temporalCoverage": "1999-01-04/2026-06-02",
  "repeatFrequency": "P1D",
  "creditText": "FX data from the ECB via Frankfurter",
  "citation": "European Central Bank euro foreign-exchange reference rates (via the Frankfurter API). Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-frankfurter",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=frankfurter"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "frankfurter",
  "description": "Full-coverage ingest of Frankfurter (ECB euro foreign-exchange reference rates). Frankfurter serves the ECB daily reference rates with EUR as base. The full daily history runs 1999-01-04..today. We pull the ENTIRE range year-by-year (polite, retried) and union every currency that has EVER appeared…",
  "url": "https://econdatalibrary.com/frankfurter.html",
  "creator": {
    "@type": "sc:Organization",
    "name": "Frankfurter API (ECB FX)"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "ecb-attrib-nomodify",
  "keywords": [
    "fx"
  ],
  "temporalCoverage": "1999-01-04/2026-06-02",
  "citation": "European Central Bank euro foreign-exchange reference rates (via the Frankfurter API). Compiled and redistributed by the Elkassabgi Data Library.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "frankfurter-csv",
      "name": "frankfurter-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=frankfurter",
      "encodingFormat": "text/csv"
    }
  ]
}

Part of the Econ Data Library catalog · metadata generated 2026-07-14 from the central registry · browse all datasets