python-esios
A Python library and CLI to query the Spanish electricity market API (ESIOS/REE).
Download indicators (prices, generation, demand), archives (I90 settlement files), and more.
Install
pip install python-esios
Configure your token
Request a personal token from REE, then:
esios config set token YOUR_TOKEN
This stores the token in ~/.config/esios/config.toml. Alternatively, set the ESIOS_API_KEY environment variable.
CLI usage
# Search indicators
esios indicators search "precio"
# Download historical data
esios indicators history 600 --start 2025-01-01 --end 2025-01-31
# Export to CSV
esios indicators history 600 -s 2025-01-01 -e 2025-01-31 --format csv --output prices.csv
# List archives
esios archives list
# Download I90 settlement files
esios archives download 1 --start 2025-01-01 --end 2025-01-31
# Cache status
esios cache status
Python usage
from esios import ESIOSClient
client = ESIOSClient()
# Get indicator data as DataFrame
handle = client.indicators.get(600) # Day-ahead spot price (OMIE)
df = handle.historical("2025-01-01", "2025-01-31")
# Search indicators
results = client.indicators.search("precio")
# Download archives
client.archives.download(1, start="2025-01-01", end="2025-01-31", output_dir="./data")
Common indicators
| ID | Name | Description |
|---|---|---|
| 600 | Day-ahead price | OMIE spot market price |
| 1001 | PVPC | Voluntary price for small consumers (2.0TD) |
| 10033 | Demand | Real-time electricity demand |
| 10034 | Wind generation | Real-time wind generation |
| 10035 | Solar PV generation | Real-time solar generation |
License
GPL-3.0
1 maintainer
Metadata
1 maintainer
Release files for python-esios 2.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_esios-2.4.2.tar.gz | 656.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_esios-2.4.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 725.9 kB
Release files / python_esios-2.4.2.tar.gz
| Download URL | python_esios-2.4.2.tar.gz |
|---|---|
| Size | 656.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb02575b548d6792ec2993b830c27bc8f51da079ad890c40a9410d0ff217d14a
|
|
BLAKE2b-256 checksum How to use checksums |
45b044f446100fae8a64d0a2a6f1b1a336f9903bcdcbe766cc8fd7e6e20e9117
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 14, 2026.
Transparency logRelease files / python_esios-2.4.2-py3-none-any.whl
| Download URL | python_esios-2.4.2-py3-none-any.whl |
|---|---|
| Size | 69.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a61df77672eac431cc55ede71be7309d6500ea792f89132427d5d379a3f19931
|
|
BLAKE2b-256 checksum How to use checksums |
c554aba011c77550ffc84a01f79ef607fbfb32c0d47ac2181e854581d979c145
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 14, 2026.
Transparency log
