Documentación de ESIOS Data

API access

Query ESIOS market data programmatically from Python. Use the datons client or call the REST endpoints directly.

Quickstart

Install

pip install datons

Example

from datons import Client

client = Client(token="YOUR_API_KEY")

# Query preprocessed I90 market data → pandas DataFrame
df = client.esios.query(
    "SELECT unit, datetime, energy, price "
    "FROM operational_data "
    "WHERE program = 'PDBF' AND toDate(datetime) >= '2025-01-01' "
    "LIMIT 100"
)
print(df.head())

Authentication

Request header

Include your API key in every request:

X-API-Key: your_key_here

Environment variable

Set DATONS_API_KEY and the client will pick it up automatically:

export DATONS_API_KEY=your_key_here

Base URL

https://mcp.datons.com/esios-data

Don't have an API key yet? Get your API key from your account dashboard.

Endpoint reference

Rate limits

All API requests are rate-limited by tier. See plans for tier comparison. All queries are read-only (SELECT only).

Response headers

Every response includes rate limit headers so you can track your usage:

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 73

X-RateLimit-Reset: 1712448000

X-Tier: explorer

Query examples

Loading examples...

Loading preview...

Diccionario de columnas

Descripción y tipo de cada columna en la tabla operational_data_15min.

unit String

unit_name Nullable(String) NULL

company_name LowCardinality(Nullable(String))

program LowCardinality(String)

sign LowCardinality(Nullable(String))

technology LowCardinality(Nullable(String))

unit_type LowCardinality(Nullable(String))

transaction LowCardinality(Nullable(String))

restriction LowCardinality(Nullable(String))

redispatch LowCardinality(Nullable(String))

calculation LowCardinality(Nullable(String))

session LowCardinality(Nullable(String))

offer_type LowCardinality(Nullable(String))

qh_type LowCardinality(Nullable(String))

energy_sign LowCardinality(Nullable(String))

zone_regulation LowCardinality(Nullable(String))

datetime DateTime('Europe/Madrid')

energy Float64

price Float64

Referencia de programas

Programas de mercado disponibles y sus estadísticas.

PDBF -

Programa Diario Base Funcionamiento

PDVP -

Programa Diario Viable Provisional

PHF1 -

Programa Horario Funcional 1

BS -

Banda Secundaria

PHF2 -

Programa Horario Funcional 2

PHF3 -

Programa Horario Funcional 3

PHF4 -

Programa Horario Funcional 4

PHF5 -

Programa Horario Funcional 5

PHF6 -

Programa Horario Funcional 6

PHF7 -

Programa Horario Funcional 7

RTR -

Restricciones Tiempo Real

RR -

Mercado de Balances

BT -

Banda Terciaria