{"id":24814,"library":"volue-insight-timeseries","title":"Volue Insight Timeseries","description":"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.","status":"active","version":"2.3.1","language":"python","source_language":"en","source_url":"https://github.com/Volue-Public/volue-insight-timeseries","tags":["volue","insight","timeseries","energy","grpc","api-client"],"install":[{"cmd":"pip install volue-insight-timeseries","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"gRPC transport layer","package":"grpcio","optional":false},{"reason":"Protocol Buffers for API messages","package":"protobuf","optional":false},{"reason":"Optional for converting timeseries to DataFrame","package":"pandas","optional":true}],"imports":[{"note":"Package uses underscores in module name","wrong":"from volueinsight import VolueInsight","symbol":"VolueInsight","correct":"from volue_insight_timeseries import VolueInsight"},{"note":"Correct path since v2.0.0","wrong":null,"symbol":"TimeSeriesRequest","correct":"from volue_insight_timeseries.models import TimeSeriesRequest"}],"quickstart":{"code":"from volue_insight_timeseries import VolueInsight\n\nclient = VolueInsight(\n    oauth_client_id=os.environ.get('VOLUE_CLIENT_ID', ''),\n    oauth_client_secret=os.environ.get('VOLUE_CLIENT_SECRET', ''),\n    url=os.environ.get('VOLUE_GRPC_ENDPOINT', '')\n)\nprint('Connection established')","lang":"python","description":"Initialize client with OAuth credentials. Requires environment variables or direct values."},"warnings":[{"fix":"Upgrade Python to 3.10 or higher.","message":"In v2.0.0, Python 3.9 support was dropped. You must use Python >=3.10.","severity":"breaking","affected_versions":"<=1.x"},{"fix":"Replace 'import volueinsight' with 'from volue_insight_timeseries import VolueInsight'.","message":"In v2.0.0, the package module was renamed from 'volueinsight' to 'volue_insight_timeseries'. Old imports will break.","severity":"breaking","affected_versions":"<=1.x"},{"fix":"Remove 'use_ssl' argument from VolueInsight() constructor.","message":"The 'use_ssl' parameter in the constructor is deprecated since v2.2.0. TLS is now always enabled.","severity":"deprecated","affected_versions":">=2.2.0"},{"fix":"Explicitly pass oauth_client_id and oauth_client_secret when constructing VolueInsight.","message":"OAuth credentials must be provided via client_id and client_secret; environment variables are not automatically read by the library.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from volue_insight_timeseries import VolueInsight'.","cause":"Old package name used after v2.0.0.","error":"ModuleNotFoundError: No module named 'volueinsight'"},{"fix":"Upgrade to >=2.0.0: pip install 'volue-insight-timeseries>=2.0.0'.","cause":"Version <2.0.0 installed or incorrect import path.","error":"ImportError: cannot import name 'VolueInsight' from 'volue_insight_timeseries' (unknown location)"},{"fix":"Verify VOLUE_CLIENT_ID and VOLUE_CLIENT_SECRET environment variables or direct parameters.","cause":"Missing or incorrect OAuth client_id/client_secret.","error":"grpc.RpcError: status = Unauthenticated, message = \"Invalid authentication credentials\""}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}