v0.14.0

Frequenz Electricity Trading API Client Release Notes

Summary

This release adds enhanced filtering capabilities for gridpool orders and trades, with support for tag-based filtering and more flexible time-based queries.

New Features

• Tag filtering for gridpool trades: The gridpool_trades() method now accepts a tag parameter to filter trades by tag. The GridpoolTradeFilter dataclass has been updated accordingly.

• Flexible time filtering with DeliveryTimeFilter: Replaced the restrictive delivery_period parameter with a more flexible delivery_time_filter across gridpool orders and trades methods. The new DeliveryTimeFilter supports:

  • Time interval filtering with optional start/end times
  • Multiple delivery duration filters
  • More granular control over time-based queries

• New types for time filtering: Added Interval and DeliveryTimeFilter types to support the enhanced filtering API.

• Support tags in CLI create-order command.

Breaking Changes

• The delivery_period parameter has been replaced with delivery_time_filter in the following methods:

  • list_gridpool_orders()
  • stream_gridpool_orders()
  • gridpool_trades()

  Note: The create_gridpool_order() method maintains backward compatibility by keeping both parameters.

• Updated API imports from v1 to v1alpha8 for common types.

What's Changed

• chore(deps): bump actions/download-artifact from 4 to 5 by @dependabot[bot] in #186
• chore(deps): bump actions/checkout from 4 to 5 by @dependabot[bot] in #187
• chore(deps): bump setuptools-scm[toml] from 8.3.1 to 9.2.0 by @dependabot[bot] in #188
• chore(deps): bump pydoclint from 0.6.6 to 0.7.0 by @dependabot[bot] in #189
• chore(deps): bump the patch group with 4 updates by @dependabot[bot] in #191
• chore(deps): bump types-protobuf from 6.30.2.20250703 to 6.30.2.20250822 by @dependabot[bot] in #190
• chore(deps): bump mkdocstrings-python from 1.17.0 to 1.18.2 in the mkdocstrings group by @dependabot[bot] in #192
• Support tags in CLI create-order command by @cwasicki in #193
• chore(deps): bump pydoclint from 0.7.0 to 0.7.3 by @dependabot[bot] in #199
• chore(deps): bump pandas-stubs from 2.3.2.250827 to 2.3.2.250926 by @dependabot[bot] in #200
• chore(deps): bump pytest-asyncio from 1.1.0 to 1.2.0 by @dependabot[bot] in #198
• chore(deps): bump the patch group with 4 updates by @dependabot[bot] in #196
• chore(deps): bump actions/labeler from 5.0.0 to 6.0.1 by @dependabot[bot] in #194
• chore(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #195
• chore(deps): bump the minor group with 8 updates by @dependabot[bot] in #197
• Fix tests namespace pollution from entsoe and remove tests/init by @Marenz in #201
• Enhance filtering capabilities by @phillip-wenig-frequenz in #204

New Contributors

• @phillip-wenig-frequenz made their first contribution in #204

Full Changelog: v0.13.0...v0.14.0