balancing-services-cli
⚠️ DEPRECATED — no longer maintained
balancing-services-cliis deprecated and will receive no further releases. Balancing Services has moved to an MCP-based interface. This1.13.0release is the final published version; it still works against the current API but is frozen and unsupported.Use instead:
- The Balancing Services MCP server for agent / tool-based access.
- The
balancing-servicesPython client library for programmatic access.See balancing.services for details.
Command-line interface for the Balancing Services REST API - access European electricity balancing market data directly from your terminal.
Installation
uv add balancing-services-cli
Or with pip:
pip install balancing-services-cli
Or run without installing via uvx:
uvx balancing-services-cli imbalance-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z
Authentication
Provide your API token via the --token option:
bs-cli --token your-token-here imbalance-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z
Usage
# CSV to stdout (default)
bs-cli imbalance-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z
# Save to CSV file
bs-cli imbalance-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z -o prices.csv
# Save to Parquet
bs-cli imbalance-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z -o prices.parquet
# Balancing energy commands (require --reserve-type)
bs-cli energy-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z --reserve-type aFRR
bs-cli energy-bids --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z --reserve-type mFRR
# Balancing capacity commands (require --reserve-type)
bs-cli capacity-prices --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z --reserve-type aFRR
bs-cli capacity-bids --area EE --start 2025-01-01T00:00:00Z --end 2025-01-02T00:00:00Z --reserve-type FCR
Commands
| Command | Description |
|---|---|
imbalance-prices |
Imbalance prices |
imbalance-volumes |
Imbalance total volumes |
energy-activated |
Balancing energy activated volumes |
energy-offered |
Balancing energy offered volumes |
energy-prices |
Balancing energy prices |
energy-bids |
Balancing energy bids (auto-paginates) |
energy-cbpm |
Cross-border purchased marginal prices (auto-paginates) |
energy-cross-border-volumes |
Cross-border balancing energy volumes |
energy-day-ahead-prices |
Day-ahead wholesale energy prices (EXPERIMENTAL, auto-paginates) |
capacity-bids |
Balancing capacity bids (auto-paginates) |
capacity-prices |
Balancing capacity prices |
capacity-procured |
Balancing capacity procured volumes |
capacity-cross-zonal |
Cross-zonal capacity allocation |
Output Formats
- CSV (default): Written to stdout or file. Use with Excel, DuckDB, Polars, pandas, etc.
- Parquet: Must specify
-o file.parquet.
Global Options
| Option | Description |
|---|---|
--token |
API bearer token |
-o, --output |
Output file path (auto-detects format from .csv/.parquet extension) |
-f, --format |
Override output format (csv, parquet) |
1 maintainer
Metadata
1 maintainer
Release files for balancing-services-cli 1.13.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| balancing_services_cli-1.13.0.tar.gz | 16.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| balancing_services_cli-1.13.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 32.6 kB
Release files / balancing_services_cli-1.13.0.tar.gz
| Download URL | balancing_services_cli-1.13.0.tar.gz |
|---|---|
| Size | 16.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d76dba6d2bbe45e0e3721e84f260509156c543b551f6db60edad3e60cd6d45fb
|
|
BLAKE2b-256 checksum How to use checksums |
3e5b561b6870f537a4b5aaf0699104e276fe9aa403952d5844a170781d422b1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"openSUSE Tumbleweed","version":"20260510","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / balancing_services_cli-1.13.0-py3-none-any.whl
| Download URL | balancing_services_cli-1.13.0-py3-none-any.whl |
|---|---|
| Size | 16.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c883653f8e5f9d5b9b5008bc88ef43e2a1b5727f80839606319f195ed590aea
|
|
BLAKE2b-256 checksum How to use checksums |
4e2e688a7b2544a49cb7240fd341f064a4347c11b6ca72404aad859f20d2fd1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"openSUSE Tumbleweed","version":"20260510","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
