ESIOS Data documentation

Data model, query examples, MCP integration, and REST API reference for the Spanish electricity market dataset.

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_15min "
    "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? Contact us to request access.

Endpoint reference

Rate limits & policies

Raw query row limit	50 rows
Aggregated query row limit	10,000 rows
Execution timeout	30 seconds
Allowed operations	SELECT read-only

Query examples

Loading examples...

The data API is currently unavailable. Please try again later.