energyquantified 0.1

Energy Quantified Time series API client.

Energy Quantified Python Client

The Python library for Energy Quantified's Time Series API. It allows you to access thousands of data series directly from Energy Quantified's time series database. It integrates with the popular pandas library for high-performance data analysis and manipulation.

Developed for Python 3.7+.

Note: An user account with an API key is required to use this library. Create an account on Energy Quantified's home page. Trial users do get access to 30 days of history.

Features

• Simple authentication
• Metadata caching
• Rate-limiting and automatic retries on network errors
• Full-text search and keyword search for curves and powerplants
• Forecasts- and time series data
• Period-based data
• (TODO!) OHLC data
• (TODO!) SRMC, dark- and spark spreads
• (TODO!) Shows your subscription for each series
• Support for time-zones, resolutions and aggregations
• Easy-to-use filters for issue dates and forecast types
• Integrates with pandas

Documentation

Find the documentation at readthedocs.

Installation

Install with pip:

# Install
pip install energyquantified

# Upgrade
pip install --upgrade energyquantified

Example usage

How to initialize the client, search for data series and download data. More details available in the documentation.

from datetime import date, timedelta
from energyquantified import EnergyQuantified

# Initialize client
eq = EnergyQuantified(api_key='<insert api key here>')

# Freetext search (filtering on attributes is also supported)
curves = eq.metadata.curves(q='germany wind production actual')

# Load time series data
curve = curve[0]
timeseries = eq.timeseries.load(
    curve,
    begin=date.today() - timedelta(days=10),
    end=date.today()
)

# Convert to Pandas data frame
df = timeseries.to_dataframe()

License

The Energy Quantified Python client is licensed under the Apache License version 2.0.