datons

Python client for Datons data APIs.

Installation

pip install datons

Quick start

from datons import Client

client = Client(token="esd_live_...")

# Query preprocessed I90 market data
df = client.esios.query(
    "SELECT unit, datetime, energy, price "
    "FROM operational_data_15min "
    "WHERE program = 'PDBF' AND date >= '2025-01-01' "
    "LIMIT 100"
)

# Dataset metadata (schema, programs, stats)
meta = client.esios.metadata()

# Search for units, companies, technologies
results = client.esios.search("iberdrola")

Authentication

Get your API key at datons.com/apps/esios-data.

Pass it directly or set the DATONS_API_KEY environment variable:

export DATONS_API_KEY="esd_live_..."

from datons import Client

client = Client()  # picks up DATONS_API_KEY