Volue Insight Timeseries

2.3.1 verified Fri May 01 auth: no python

Official Python client library for the Volue Insight API, providing access to time series data, market data, and metadata from energy markets. Version 2.3.1 supports Python 3.10-3.14, with regular releases on a monthly/quarterly cadence.

pip install volue-insight-timeseries

Common errors

error ModuleNotFoundError: No module named 'volueinsight' ↓

cause Old package name used after v2.0.0.

fix

Use 'from volue_insight_timeseries import VolueInsight'.

error ImportError: cannot import name 'VolueInsight' from 'volue_insight_timeseries' (unknown location) ↓

cause Version <2.0.0 installed or incorrect import path.

fix

Upgrade to >=2.0.0: pip install 'volue-insight-timeseries>=2.0.0'.

error grpc.RpcError: status = Unauthenticated, message = "Invalid authentication credentials" ↓

cause Missing or incorrect OAuth client_id/client_secret.

fix

Verify VOLUE_CLIENT_ID and VOLUE_CLIENT_SECRET environment variables or direct parameters.

Warnings

breaking In v2.0.0, Python 3.9 support was dropped. You must use Python >=3.10. ↓

fix Upgrade Python to 3.10 or higher.

breaking In v2.0.0, the package module was renamed from 'volueinsight' to 'volue_insight_timeseries'. Old imports will break. ↓

fix Replace 'import volueinsight' with 'from volue_insight_timeseries import VolueInsight'.

deprecated The 'use_ssl' parameter in the constructor is deprecated since v2.2.0. TLS is now always enabled. ↓

fix Remove 'use_ssl' argument from VolueInsight() constructor.

gotcha OAuth credentials must be provided via client_id and client_secret; environment variables are not automatically read by the library. ↓

fix Explicitly pass oauth_client_id and oauth_client_secret when constructing VolueInsight.

Imports

VolueInsight

wrong

from volueinsight import VolueInsight

correct

from volue_insight_timeseries import VolueInsight

Package uses underscores in module name

TimeSeriesRequest

from volue_insight_timeseries.models import TimeSeriesRequest

Correct path since v2.0.0

Quickstart

Initialize client with OAuth credentials. Requires environment variables or direct values.

from volue_insight_timeseries import VolueInsight

client = VolueInsight(
    oauth_client_id=os.environ.get('VOLUE_CLIENT_ID', ''),
    oauth_client_secret=os.environ.get('VOLUE_CLIENT_SECRET', ''),
    url=os.environ.get('VOLUE_GRPC_ENDPOINT', '')
)
print('Connection established')