Banco de España Statistics API

Use in your agent

Load a Banco de España series into pandas and Parquet. Checked against the provider's documentation on Nov 1, 2026.

Access

• No account or key. The JSON series endpoints are public.

Request

curl 'https://app.bde.es/bierest/resources/srdatosapp/listaSeries?idioma=en&series=D_1NBAF472&rango=30M'

Format

JSON array whose series object contains code, long and short descriptions, frequency, decimals, symbol, metadata, full coverage dates and parallel date and value arrays.

Load into pandas and Parquet

Needs Python 3 with requests, pandas and pyarrow.

"""Banco de Espana monthly series sample -> pandas -> Parquet. No key."""
import requests
import pandas as pd

URL = "https://app.bde.es/bierest/resources/srdatosapp/listaSeries"
params = {"idioma": "en", "series": "D_1NBAF472", "rango": "30M"}
r = requests.get(URL, params=params, timeout=60)
r.raise_for_status()
item = r.json()[0]
df = pd.DataFrame({"date": item["fechas"], "value": item["valores"]})
df["date"] = pd.to_datetime(df["date"], utc=True)
df["series"] = item["serie"]
df["frequency"] = item["codFrecuencia"]
df.to_parquet("banco_de_espana_sample.parquet", index=False)
print(len(df), "observations", item["serie"], df["date"].min().date(), "to", df["date"].max().date())

Run by us on 2026-11-01 (python 3.13.5 | pandas 3.1.0 | pyarrow 26.0.0 | requests 2.34.2). Result: 31 observations D_1NBAF472 2024-03-01 to 2026-09-01

Limits

• Rate limit: Not stated.
• If time_range is omitted, the API returns the smallest default window for that series frequency.
• MAX is documented for monthly, quarterly and annual series; daily windows are 3M, 12M or 36M.

Quirks

• The fechas and valores arrays are parallel and the checked response is newest-first.
• Monthly, quarterly and annual timestamps represent reference periods using provider-defined dates, not publication instants.
• Series codes can contain # or %, which must be URL-encoded as %23 or %25.

Terms and attribution

• Cite Banco de España using the provider's unprocessed or processed wording.
• Mention the source's last update date when available and preserve content, metadata and meaning.
• The reuse policy excludes confidential and third-party data.

Sources

• https://www.bde.es/webbe/en/estadisticas/recursos/api-estadisticas-bde.html: “The JSON (JavaScript Object Notation) web service described in this section allows access via URL requests to all the information available both in the Statistics section of the Banco de España and in the HERMES application.”
• https://www.bde.es/wbe/en/estadisticas/recursos/terminos/terminos-de-uso.html: “The statistical information published on the Banco de España website is made available to the public free of charge, with open access and use, in accordance with the principles of transparency and reuse of public information.”
• https://www.bde.es/wbe/en/estadisticas/recursos/terminos/terminos-de-uso.html: “The Banco de España must always be cited as the source”