Ecb
The ECB's dataflow catalogue — the vocabulary `series` takes as its `dataflow`.
5 endpoints327 calls5/5 passing
Dataflows
GET
/v1/finance:ecb/dataflowspassing · 1.0s1d cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| agency | string | query | Maintenance agency of the dataflows. Default ECB. |
| query | string | query | Case-insensitive filter over the dataflow id, name and data-structure id. |
Example response
{"project":"finance:ecb", "data": {"count":104, "items": [ {"name":"AGR","agency":"ECB","version":"1.0","dataflow":"AGR","structure":"ECB_BCS1" }, {"name":"AMECO","agency":"ECB","version":"1.0","dataflow":"AME","structure":"ECB_AME1" }, {"name":"Banknotes statistics","agency":"ECB","version":"1.0","dataflow":"BKN","structure":"ECB_BKN1" }, {"name":"Bank Lending Survey Statistics","agency":"ECB","version":"1.0","dataflow":"BLS","structure":"ECB_BLS1" }, {"name":"Shipments of Euro Banknotes Statistics (ESCB)","agency":"ECB","version":"1.0","dataflow":"BNT","structure":"ECB_BOP_BNT" }, {"name":"Euro Area Balance of Payments and International Investment Position Statistics","agency":"ECB","version":"1.0","dataflow":"BOP","structure":"ECB_BOP1" }, {"name":"Balance Sheet Items","agency":"ECB","version":"1.0","dataflow":"BSI","structure":"ECB_BSI1" }, {"name":"Balance Sheet Items Statistics (tables 2 to 5 of the Blue Book)","agency":"ECB","version":"1.0","dataflow":"BSP","structure":"ECB_BSI1" } ],"query":null,"total":104,"agency":"ECB","dataset":"dataflows","provider":"ecb" },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Series
Any of the ECB's 104 SDMX dataflows, by dataflow and series key.
GET
/v1/finance:ecb/seriespassing · 12.3s1h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| dataflow | string | query | ECB dataflow id — EXR, FM, ICP, YC, BSI, MIR, BOP, GST, STS and 95 more. `dataflows` lists them. Required. |
| key | string | query | Series key: dimension values dot-joined in the dataflow's order, `+` to OR within one position, empty between dots for a wildcard. Default all series in the dataflow. |
| from | string | query | First period, in the series' own period format (2026-08-20, 2026-08, 2026-Q2, 2026). |
| to | string | query | Last period, same format as `from`. |
| last | number | query | Return only the newest N observations per series. |
| first | number | query | Return only the oldest N observations per series. |
| detail | enum | query | full (default), dataonly (drops attributes), serieskeysonly or nodata — use the last two to resolve a wildcard key cheaply. One of full, dataonly, serieskeysonly, nodata. |
| updatedAfter | string | query | Only observations changed after this ISO timestamp. |
| history | enum | query | Return every point-in-time vintage instead of the current values, adding action, validFrom and validTo to each observation. Default false. One of true, false. |
| length | number | query | Observations per series to return, newest first. Default 200, max 20000. |
Example response
{"project":"finance:ecb", "data": {"to":null,"key":null,"from":null,"count":4027, "items": [ {"key":"EXR.A.ARS.EUR.SP00.A","unit":"ARS","count":1,"title":"Argentine peso/Euro","total":1, "values": [ {"value":53.8200352941176,"period":"2019","status":"A","comment":"Indicative rate" } ],"frequency":"A", "attributes": {"unit":"ARS","title":"Argentine peso/Euro","decimals":"5","unitMult":"0","collection":"A","timeFormat":"P1Y","titleCompl":"Indicative exchange rate, Euro/Argentine peso, 2:15 pm (C.E.T.)","sourceAgency":"4F0" }, "dimensions": {"freq":"A","exrType":"SP00","currency":"ARS","exrSuffix":"A","currencyDenom":"EUR" },"latestValue":53.8200352941176,"latestPeriod":"2019" }, {"key":"EXR.A.ARS.EUR.SP00.E","unit":"ARS","count":1,"title":"Euro/Argentine peso","total":1, "values": [ {"value":67.2692,"period":"2019","status":"A" } ],"frequency":"A", "attributes": {"unit":"ARS","title":"Euro/Argentine peso","decimals":"5","unitMult":"0","collection":"E","timeFormat":"P1Y","titleCompl":"Indicative exchange rate, Euro/Argentine peso, 2:15 pm (C.E.T.)","sourceAgency":"4F0" }, "dimensions": {"freq":"A","exrType":"SP00","currency":"ARS","exrSuffix":"E","currencyDenom":"EUR" },"latestValue":67.2692,"latestPeriod":"2019" }, {"key":"EXR.A.AUD.EUR.SP00.A","unit":"AUD","count":1,"title":"Australian dollar/Euro ECB reference exchange rate","total":1, "values": [ {"value":1.75176,"period":"2025","status":"A","confidentiality":"F" } ],"frequency":"A", "attributes": {"unit":"AUD","title":"Australian dollar/Euro ECB reference exchange rate","decimals":"4","unitMult":"0","collection":"A","timeFormat":"P1Y","titleCompl":"ECB reference exchange rate, Australian dollar/Euro, 2.15 pm (C.E.T.)","sourceAgency":"4F0" }, "dimensions": {"freq":"A","exrType":"SP00","currency":"AUD","exrSuffix":"A","currencyDenom":"EUR" },"latestValue":1.75176,"latestPeriod":"2025" } ],"total":4027,"detail":"full","dataset":"series","history":false,"dataflow":"EXR","provider":"ecb" },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Exchange Rates
ECB euro foreign-exchange reference rates.
GET
/v1/finance:ecb/exchange-ratespassing · 0.2s1h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | string | query | ISO currency codes, comma-separated, up to 40 in one call. Default USD. Rates are units per euro. |
| frequency | enum | query | D daily, M monthly average, Q quarterly average or A annual average. Default D. One of D, M, Q, A. |
| from | string | query | First period, YYYY-MM-DD for daily, YYYY-MM for monthly, YYYY-Q1 for quarterly, YYYY for annual. |
| to | string | query | Last period, same format as `from`. |
| asOf | string | query | A single period. Overrides `from` and `to`. A day the ECB did not publish returns 404. |
| last | number | query | Return only the newest N observations per currency. Default 30 when no window is given. |
Example response
{"project":"finance:ecb", "data": {"to":null,"base":"EUR","from":null,"count":3, "items": [ {"base":"EUR","count":30,"title":"US dollar/Euro ECB reference exchange rate", "values": [ {"rate":1.1681,"period":"2026-08-20","status":"A" }, {"rate":1.1605,"period":"2026-08-19","status":"A" }, {"rate":1.1576,"period":"2026-08-18","status":"A" }, {"rate":1.1593,"period":"2026-08-17","status":"A" }, {"rate":1.1567,"period":"2026-08-14","status":"A" }, {"rate":1.1534,"period":"2026-08-13","status":"A" }, {"rate":1.1545,"period":"2026-08-12","status":"A" }, {"rate":1.154,"period":"2026-08-11","status":"A" } ],"currency":"USD","latestRate":1.1681,"latestPeriod":"2026-08-20" }, {"base":"EUR","count":30,"title":"Pound sterling/Euro ECB reference exchange rate", "values": [ {"rate":0.85725,"period":"2026-08-20","status":"A" }, {"rate":0.85608,"period":"2026-08-19","status":"A" }, {"rate":0.85585,"period":"2026-08-18","status":"A" }, {"rate":0.855,"period":"2026-08-17","status":"A" }, {"rate":0.8545,"period":"2026-08-14","status":"A" }, {"rate":0.8549,"period":"2026-08-13","status":"A" }, {"rate":0.85358,"period":"2026-08-12","status":"A" }, {"rate":0.85483,"period":"2026-08-11","status":"A" } ],"currency":"GBP","latestRate":0.85725,"latestPeriod":"2026-08-20" }, {"base":"EUR","count":30,"title":"Japanese yen/Euro ECB reference exchange rate", "values": [ {"rate":185.45,"period":"2026-08-20","status":"A" }, {"rate":184.62,"period":"2026-08-19","status":"A" }, {"rate":184.87,"period":"2026-08-18","status":"A" }, {"rate":184.59,"period":"2026-08-17","status":"A" }, {"rate":183.93,"period":"2026-08-14","status":"A" }, {"rate":183.77,"period":"2026-08-13","status":"A" }, {"rate":183.67,"period":"2026-08-12","status":"A" }, {"rate":183.72,"period":"2026-08-11","status":"A" } ],"currency":"JPY","latestRate":185.45,"latestPeriod":"2026-08-20" } ],"total":90,"dataset":"exchange-rates","missing":[],"provider":"ecb", "resolved": [ "GBP", "JPY", "USD" ],"frequency":"D", "currencies": [ "USD", "GBP", "JPY" ] },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Hicp
Euro-area inflation — the Harmonised Index of Consumer Prices.
GET
/v1/finance:ecb/hicppassing · 0.2s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| item | string | query | COICOP item code — 000000 overall, 010000 food, 040000 housing, XEF000 excluding energy and food. Comma-separated for several. Default 000000. |
| area | string | query | Reference area — U2 euro area, DE, FR, IT, ES and the other member states. Default U2. |
| measure | enum | query | ANR annual rate of change, INX index level, ANR_S seasonally adjusted annual rate, MRR monthly rate, CTG contribution, CTG_S adjusted contribution, WGT weight. Default ANR. One of ANR, INX, ANR_S, MRR, CTG, CTG_S, WGT. |
| from | string | query | First month, YYYY-MM. |
| to | string | query | Last month, YYYY-MM. |
| last | number | query | Return only the newest N months per item. Default 24 when no window is given. |
Example response
{"project":"finance:ecb", "data": {"to":null,"area":"U2","from":null,"count":1, "items": [ {"area":"U2","item":"000000","unit":"PCCH","count":24,"title":"HICP - Overall index", "values": [ {"value":1.9,"period":"2025-12" }, {"value":2.1,"period":"2025-11" }, {"value":2.1,"period":"2025-10" }, {"value":2.2,"period":"2025-09" }, {"value":2,"period":"2025-08" }, {"value":2,"period":"2025-07" }, {"value":2,"period":"2025-06" }, {"value":1.9,"period":"2025-05" } ],"measure":"ANR","latestValue":1.9,"measureName":"Annual rate of change","latestPeriod":"2025-12" } ],"total":24,"dataset":"hicp","measure":"ANR","missing":[],"provider":"ecb", "resolved": [ "000000" ], "itemCodes": [ "000000" ],"latestPeriod":"2025-12" },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Key Rates
The ECB's three policy rates and every date they changed.
GET
/v1/finance:ecb/key-ratespassing · 0.7s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| rate | string | query | Policy rates, comma-separated: MRR_FR (main refinancing), DFR (deposit facility), MLFR (marginal lending facility). Default all three. |
| from | string | query | First date, YYYY-MM-DD. The series is daily and repeats the level between changes. |
| to | string | query | Last date, YYYY-MM-DD. |
| last | number | query | Return only the newest N observations per rate. Default 20 when no window is given. |
Example response
{"project":"finance:ecb", "data": {"to":null,"from":null,"count":2, "items": [ {"name":"Main refinancing operations - fixed rate","rate":"MRR_FR","unit":"percent per annum","count":20,"title":"Main refinancing operations - fixed rate tenders (fixed rate) (date of changes) - Level", "values": [ {"date":"2026-08-21","rate":2.4 }, {"date":"2026-08-20","rate":2.4 }, {"date":"2026-08-19","rate":2.4 }, {"date":"2026-08-18","rate":2.4 }, {"date":"2026-08-17","rate":2.4 }, {"date":"2026-08-16","rate":2.4 }, {"date":"2026-08-15","rate":2.4 }, {"date":"2026-08-14","rate":2.4 } ],"latestDate":"2026-08-21","latestRate":2.4 }, {"name":"Deposit facility","rate":"DFR","unit":"percent per annum","count":20,"title":"Deposit facility - date of changes (raw data) - Level", "values": [ {"date":"2026-08-21","rate":2.25 }, {"date":"2026-08-20","rate":2.25 }, {"date":"2026-08-19","rate":2.25 }, {"date":"2026-08-18","rate":2.25 }, {"date":"2026-08-17","rate":2.25 }, {"date":"2026-08-16","rate":2.25 }, {"date":"2026-08-15","rate":2.25 }, {"date":"2026-08-14","rate":2.25 } ],"latestDate":"2026-08-21","latestRate":2.25 } ], "rates": [ "MRR_FR", "DFR" ],"total":40,"dataset":"key-rates","provider":"ecb" },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:ecb", "dataflows", { agency: "ECB", query: "yield" });
Ecb
The ECB's dataflow catalogue — the vocabulary `series` takes as its `dataflow`.
5 endpoints327 calls5/5 passing
GET
/v1/…ecb/dataflowspassing · 1.0s1d cache
Try it
Parameters
agency
string · query · optional
Maintenance agency of the dataflows. Default ECB.
query
string · query · optional
Case-insensitive filter over the dataflow id, name and data-structure id.
Example response
{"project":"finance:ecb", "data": {"count":104, "items": [ {"name":"AGR","agency":"ECB","version":"1.0","dataflow":"AGR","structure":"ECB_BCS1" }, {"name":"AMECO","agency":"ECB","version":"1.0","dataflow":"AME","structure":"ECB_AME1" }, {"name":"Banknotes statistics","agency":"ECB","version":"1.0","dataflow":"BKN","structure":"ECB_BKN1" }, {"name":"Bank Lending Survey Statistics","agency":"ECB","version":"1.0","dataflow":"BLS","structure":"ECB_BLS1" }, {"name":"Shipments of Euro Banknotes Statistics (ESCB)","agency":"ECB","version":"1.0","dataflow":"BNT","structure":"ECB_BOP_BNT" }, {"name":"Euro Area Balance of Payments and International Investment Position Statistics","agency":"ECB","version":"1.0","dataflow":"BOP","structure":"ECB_BOP1" }, {"name":"Balance Sheet Items","agency":"ECB","version":"1.0","dataflow":"BSI","structure":"ECB_BSI1" }, {"name":"Balance Sheet Items Statistics (tables 2 to 5 of the Blue Book)","agency":"ECB","version":"1.0","dataflow":"BSP","structure":"ECB_BSI1" } ],"query":null,"total":104,"agency":"ECB","dataset":"dataflows","provider":"ecb" },"timestamp":"2026-08-21T02:22:14Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:ecb", "dataflows", { agency: "ECB", query: "yield" });