Skip to main content

​
Python ESIOS

Access Spanish electricity market data with a powerful Python library and CLI. Query indicators, download archives, and analyze energy data with ease.

​
Key Features

Electricity Market Data

Access 600+ indicators including prices, generation, demand, and more from ESIOS/REE API

Archive Downloads

Download I90 settlement files and 150+ other archives with automatic caching

Intelligent Caching

Built-in parquet-based caching for fast data access and reduced API calls

Multi-Geography Support

Automatic pivoting and geo-name resolution for multi-country indicators

Pandas Integration

All data returned as pandas DataFrames for seamless analysis

Async & Sync Clients

Choose between synchronous ESIOSClient or async AsyncESIOSClient

CLI Tool

Command-line interface for quick data exploration and export

Offline Catalog

Browse indicators and archives offline without API calls

​
Quick Start

1

Install the package

Install python-esios using pip:
pip install python-esios
2

Configure your API token

Get a token from REE and configure it:
esios config set token YOUR_TOKEN
3

Start querying data

Fetch electricity price data with just a few lines:
from esios import ESIOSClient

client = ESIOSClient()

# Get PVPC electricity price
handle = client.indicators.get(600)
df = handle.historical("2025-01-01", "2025-01-31")
print(df)

Market Prices

Track PVPC and day-ahead electricity prices

Generation & Demand

Monitor renewable generation and electricity demand

I90 Files

Download settlement files for billing analysis

​
Common Indicators

IDNameDescription
600PVPCVoluntary price for small consumers
1001Day-ahead priceOMIE spot market price
10033DemandReal-time electricity demand
10034Wind generationReal-time wind generation
10035Solar PV generationReal-time solar generation

Explore all indicators

Search and discover 600+ available indicators

Build docs developers (and LLMs) love

Get started for freeTalk to us