Metadata-Version: 2.4
Name: voltcast
Version: 0.1.0
Summary: Official Python SDK for the Voltcast API — 15-minute European power prices and probabilistic forecasts.
License: MIT
Project-URL: Homepage, https://voltcast.com
Project-URL: Repository, https://github.com/Voltcast-com/sdk
Project-URL: Documentation, https://voltcast.com/docs
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24
Provides-Extra: pandas
Requires-Dist: pandas>=2.0; extra == "pandas"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-httpx>=0.30; extra == "dev"

# voltcast — Python SDK

Official Python client for the [Voltcast API](https://voltcast.com/docs): 15-minute
European day-ahead power prices, P10/P50/P90 forecasts, optimization and bulk export.

```bash
pip install voltcast            # or: pip install voltcast[pandas]
```

```python
import voltcast

vc = voltcast.Client("YOUR_API_KEY")   # keys: https://voltcast.com/dashboard

prices = vc.prices("DE-LU")            # yesterday → tomorrow, 15-minute native
print(len(prices), prices[0])

df = vc.prices("DE-LU", start="2026-07-01", end="2026-07-10").to_pandas()

forecast = vc.forecast("DE-LU", horizon="48h")
print(forecast.meta["model_version"], forecast[0])

# Pro plans: optimization + bulk export
windows = vc.cheapest_window("DE-LU", duration_minutes=120)
plan = vc.schedule("DE-LU", energy_kwh=40, max_power_kw=11, deadline="2026-07-11T07:00:00Z")
files = vc.export_urls("DE-LU", "2018-01-01", "2026-12-31", format="parquet")
```

Errors raise `voltcast.VoltcastError` with `.status` and the API's machine-readable `.code`.
Attribution requirements for verbatim price data: https://voltcast.com/legal/data-licensing
