Skip to content

electricity_trading_pb2

frequenz.api.electricity_trading.v1.electricity_trading_pb2 ¤

Generated protocol buffer code.

Attributes¤

frequenz.api.electricity_trading.v1.electricity_trading_pb2.MARKET_SIDE_BUY module-attribute ¤

MARKET_SIDE_BUY: MarketSide.ValueType

BUY: Order to purchase electricity. This is referred to as a 'bid' in the order book.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.MARKET_SIDE_SELL module-attribute ¤

MARKET_SIDE_SELL: MarketSide.ValueType

SELL: Order to sell electricity. This is referred to as an 'ask' or 'offer' in the order book.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.MARKET_SIDE_UNSPECIFIED module-attribute ¤

MARKET_SIDE_UNSPECIFIED: MarketSide.ValueType

UNSPECIFIED: The side of the market has not been set.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_EXECUTION_OPTION_AON module-attribute ¤

ORDER_EXECUTION_OPTION_AON: OrderExecutionOption.ValueType

All or None: Order must be executed in its entirety, or not executed at all.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_EXECUTION_OPTION_FOK module-attribute ¤

ORDER_EXECUTION_OPTION_FOK: OrderExecutionOption.ValueType

Fill or Kill: Order must be executed immediately in its entirety, or not at all.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_EXECUTION_OPTION_IOC module-attribute ¤

ORDER_EXECUTION_OPTION_IOC: OrderExecutionOption.ValueType

Immediate or Cancel: Any portion of an order that cannot be filled immediately will be cancelled.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_EXECUTION_OPTION_NONE module-attribute ¤

ORDER_EXECUTION_OPTION_NONE: OrderExecutionOption.ValueType

Order remains open until it's fully fulfilled, cancelled by the client, valid_until timestamp is reached, or the end of the trading session.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_EXECUTION_OPTION_UNSPECIFIED module-attribute ¤

ORDER_EXECUTION_OPTION_UNSPECIFIED: OrderExecutionOption.ValueType

UNSPECIFIED: The order execution option has not been set.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_ACTIVE module-attribute ¤

ORDER_STATE_ACTIVE: OrderState.ValueType

ACTIVE: The order has been confirmed and is open in the market. It may be unfilled or partially filled.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_CANCELED module-attribute ¤

ORDER_STATE_CANCELED: OrderState.ValueType

CANCELED: The order has been cancelled. This can occur due to a cancellation request by the market participant, system, or market operator.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_CANCEL_REJECTED module-attribute ¤

ORDER_STATE_CANCEL_REJECTED: OrderState.ValueType

CANCEL_REJECTED: The order cancellation request was rejected, likely due to it having already been filled or expired.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_CANCEL_REQUESTED module-attribute ¤

ORDER_STATE_CANCEL_REQUESTED: OrderState.ValueType

CANCEL_REQUESTED: A cancellation request for the order has been submitted but the order is not yet removed from the order book.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_EXPIRED module-attribute ¤

ORDER_STATE_EXPIRED: OrderState.ValueType

EXPIRED: The order has not been filled within the defined duration and has expired.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_FAILED module-attribute ¤

ORDER_STATE_FAILED: OrderState.ValueType

FAILED: The order submission failed and was unable to be placed on the order book, usually due to a validation error or system issue.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_FILLED module-attribute ¤

ORDER_STATE_FILLED: OrderState.ValueType

FILLED: The order has been completely filled and there are no remaining quantities on the order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_HIBERNATE module-attribute ¤

ORDER_STATE_HIBERNATE: OrderState.ValueType

HIBERNATE: The order has been entered into the system but is not currently exposed to the market. This could be due to certain conditions not yet being met.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_PENDING module-attribute ¤

ORDER_STATE_PENDING: OrderState.ValueType

PENDING: The order has been sent to the marketplace but has not yet been confirmed. This can be due to awaiting validation or system processing.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_RECALL module-attribute ¤

ORDER_STATE_RECALL: OrderState.ValueType

RECALL: The order has been recalled. This could be due to a system issue or a request from the market participant or market operator.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_STATE_UNSPECIFIED module-attribute ¤

ORDER_STATE_UNSPECIFIED: OrderState.ValueType

UNSPECIFIED: The order state is not known. This is usually the default state of a newly created order object before any operations have been applied.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_BALANCE module-attribute ¤

ORDER_TYPE_BALANCE: OrderType.ValueType

BALANCE: (Not yet supported) Balance order aims to balance supply and demand, usually at a specific location or within a system.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_BLOCK module-attribute ¤

ORDER_TYPE_BLOCK: OrderType.ValueType

BLOCK: (Not yet supported) User defined block order, generally a large quantity order filled all at once.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_ICEBERG module-attribute ¤

ORDER_TYPE_ICEBERG: OrderType.ValueType

ICEBERG: A large order divided into smaller lots to hide the actual order quantity. Only the visible part of the order is shown in the order book.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_LIMIT module-attribute ¤

ORDER_TYPE_LIMIT: OrderType.ValueType

LIMIT: Order to buy or sell at a specific price or better. It remains active until it is filled, cancelled, or expired.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_PREARRANGED module-attribute ¤

ORDER_TYPE_PREARRANGED: OrderType.ValueType

PRE: (Not yet supported) On exchange prearranged trade, a trade that has been privately negotiated and then submitted to the exchange.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_PRIVATE module-attribute ¤

ORDER_TYPE_PRIVATE: OrderType.ValueType

PRIVATE: (Not yet supported) Private and confidential trade, not visible in the public order book and has no market impact.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_STOP_LIMIT module-attribute ¤

ORDER_TYPE_STOP_LIMIT: OrderType.ValueType

STOP_LIMIT: An order that will be executed at a specified price, or better, after a given stop price has been reached.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ORDER_TYPE_UNSPECIFIED module-attribute ¤

ORDER_TYPE_UNSPECIFIED: OrderType.ValueType

UNSPECIFIED: The order type has not been set.

Classes¤

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CancelAllGridpoolOrdersRequest ¤

Bases: Message

Request to cancel all currently open orders for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool containing the orders to be cancelled.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CancelAllGridpoolOrdersResponse ¤

Bases: Message

Response to canceling all currently open orders for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool to cancel the orders for.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CancelGridpoolOrderRequest ¤

Bases: Message

Request to cancel an existing order for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool the order belongs to.

order_id instance-attribute ¤
order_id: builtins.int

ID of the order to be cancelled.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CancelGridpoolOrderResponse ¤

Bases: Message

Response from canceling an existing order for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool the order belongs to.

order_detail property ¤
order_detail: global___OrderDetail

Details of the cancelled order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CreateGridpoolOrderRequest ¤

Bases: Message

Represents a request to create a new order for a specific Gridpool.

A Gridpool is a collection of microgrids that can span multiple delivery areas. It's important to note that when submitting an order for a Gridpool, you must group microgrids by their respective delivery areas. This means you should submit separate orders for each delivery area within the Gridpool. Failing to do so could lead to inaccuracies in the bidding process and may not fully represent the capabilities or constraints of the microgrids in different delivery areas. However, in most countries only one delivery area exists, exceptions are countries like e.g. Australia, Germany and the US.

Caution

If a Gridpool contains microgrids in both Delivery Area A and Delivery Area B, you should submit one order for Delivery Area A and another for Delivery Area B, specifying the details for each.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

Unique identifier for the Gridpool to which the bid belongs.

order property ¤
order: global___Order

The details of the order being placed.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.CreateGridpoolOrderResponse ¤

Bases: Message

Represents the server's response after a new order has been successfully created for a specific Gridpool.

This response provides essential details about the newly created order, such as the unique order ID and the state of the order. By receiving this response, users can be sure that their order has been placed successfully for the designated Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool the order belongs to.

order_detail property ¤
order_detail: global___OrderDetail

Details of the newly created order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.GetGridpoolOrderRequest ¤

Bases: Message

Request to retrieve a single order for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool containing the order to be retrieved.

order_id instance-attribute ¤
order_id: builtins.int

ID of the order to be retrieved.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.GetGridpoolOrderResponse ¤

Bases: Message

Response from requesting order details for a specific order.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the gridpool containing the retrieved order.

order_detail property ¤
order_detail: global___OrderDetail

Details of the retrieved order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.GridpoolOrderFilter ¤

Bases: Message

Parameters for filtering Gridpool orders.

Note

Multiple filters can be used in combination to narrow down the returned results. For example, you can apply both state and side filters simultaneously to list only the open orders on the buy side of the market.

Attributes¤
delivery_area property ¤
delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

Optional filter for delivery area.

delivery_period property ¤
delivery_period: frequenz.api.common.v1.grid.delivery_duration_pb2.DeliveryPeriod

Optional filter for delivery period.

side instance-attribute ¤
side: global___MarketSide.ValueType

Optional filter for order side.

states property ¤
states: google.protobuf.internal.containers.RepeatedScalarFieldContainer[
    global___OrderState.ValueType
]

Optional filter for order state.

tag instance-attribute ¤
tag: builtins.str

Optional filters the listed orders by their associated tag.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ListGridpoolOrdersRequest ¤

Bases: Message

Request to retrieve a list of orders for a specific Gridpool.

Attributes¤
filter property ¤
filter: global___GridpoolOrderFilter

Optional Gridpool orders filter.

gridpool_id instance-attribute ¤
gridpool_id: builtins.int

The Gridpool to retrieve the orders for.

pagination_params property ¤
pagination_params: frequenz.api.common.v1.pagination.pagination_params_pb2.PaginationParams

Pagination parameters.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ListGridpoolOrdersResponse ¤

Bases: Message

Response from listing orders for a given Gridpool.

Attributes¤
order_detail_lists property ¤
order_detail_lists: google.protobuf.internal.containers.RepeatedCompositeFieldContainer[
    global___OrderDetail
]

List of all listed orders with their details.

pagination_info property ¤
pagination_info: frequenz.api.common.v1.pagination.pagination_info_pb2.PaginationInfo

Metadata for pagination, including token for next page to retrieve.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ListPublicOrdersRequest ¤

Bases: Message

Request to list all executed public orders with optional filters. This method allows for querying historical data, useful for various analytics tasks.

Attributes¤
filter property ¤
filter: global___PublicOrderFilter

Optional filter to narrow down the list of public orders.

pagination_params property ¤
pagination_params: frequenz.api.common.v1.pagination.pagination_params_pb2.PaginationParams

Pagination parameters.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ListPublicOrdersResponse ¤

Bases: Message

ListPublicOrdersResponse is a message that contains a list of historic executed public orders. This dataset is vital for tasks such as training machine learning models, backtesting trading strategies, and conducting market analysis.

Attributes¤
pagination_info property ¤
pagination_info: frequenz.api.common.v1.pagination.pagination_info_pb2.PaginationInfo

Metadata for pagination, including token for next page to retrieve.

public_order_lists property ¤
public_order_lists: google.protobuf.internal.containers.RepeatedCompositeFieldContainer[
    global___PublicOrder
]

List of all public orders that met the specified filtering criteria.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.MarketSide ¤

Bases: _MarketSide

Enum for the side of the market that the order is on.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.Order ¤

Bases: Message

Represents an order in the electricity market.

Attributes¤
delivery_area property ¤
delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

The delivery area where the contract is to be delivered. The representation of the delivery area may vary by jurisdiction.

delivery_period property ¤
delivery_period: frequenz.api.common.v1.grid.delivery_duration_pb2.DeliveryPeriod

The delivery period for the contract, specified as a start and end timestamp in UTC. It represents the period during which the contract is expected to be fulfilled.

display_quantity property ¤
display_quantity: frequenz.api.common.v1.market.energy_pb2.Energy

Applicable for ICEBERG orders. This is the quantity of the order to be displayed in the order book.

execution_option instance-attribute ¤
execution_option: global___OrderExecutionOption.ValueType

Optional execution options such as All or None, Fill or Kill, etc.

payload property ¤
payload: google.protobuf.struct_pb2.Struct

Optional user-defined payload individual to a specific order. This can be any data that needs to be associated with the order.

The field can store e.g. JSON objects containing details involved in the order. This feature can simplify application development by eliminating the need for complicated state management to remember the specifics of each order.

By embedding this "state" within the order itself, you can include specifics like which microgrids consume or provide how much power. This makes it easier to manage complex orders and can simplify the logic required in applications.

Example JSON payload: { "microgrids": [ { "microgrid_id": "1", "mwh": 1.0 }, { "microgrid_id": "2", "mwh": 0.5 } ] }

In this example, if the order is exectuted, these microgrids might consume the electricity mentioned in the example JSON payload.

peak_price_delta property ¤
peak_price_delta: frequenz.api.common.v1.market.price_pb2.Price

Applicable for ICEBERG orders. This is the price difference between the peak price and the limit price.

price property ¤
price: frequenz.api.common.v1.market.price_pb2.Price

The limit price at which the contract is to be traded. This is the maximum price for a BUY order or the minimum price for a SELL order.

quantity property ¤
quantity: frequenz.api.common.v1.market.energy_pb2.Energy

The quantity of the contract being traded, specified in MWh.

side instance-attribute ¤
side: global___MarketSide.ValueType

Indicates if the order is on the Buy or Sell side of the market.

stop_price property ¤
stop_price: frequenz.api.common.v1.market.price_pb2.Price

Applicable for STOP_LIMIT orders. This is the stop price that triggers the limit order.

tag instance-attribute ¤
tag: builtins.str

Optional user-defined tag to group related orders.

type instance-attribute ¤
type: global___OrderType.ValueType

The type of order, such as LIMIT, STOP_LIMIT, ICEBERG etc. This determines how the order is to be executed in the market.

valid_until property ¤
valid_until: google.protobuf.timestamp_pb2.Timestamp

Do not use if ExecutionOption is set to FOK or IOC. This is an optional UTC timestamp defining the time after which the order should be cancelled if not filled.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.OrderDetail ¤

Bases: Message

Represents an order with full details, including its ID, state and associated UTC timestamps.

Attributes¤
create_time property ¤
create_time: google.protobuf.timestamp_pb2.Timestamp

UTC Timestamp when the order was created.

filled_quantity property ¤
filled_quantity: frequenz.api.common.v1.market.energy_pb2.Energy

Filled quantity for this order.

modification_time property ¤
modification_time: google.protobuf.timestamp_pb2.Timestamp

UTC Timestamp of the last update to the order.

open_quantity property ¤
open_quantity: frequenz.api.common.v1.market.energy_pb2.Energy

Remaining open quantity for this order.

order property ¤
order: global___Order

The details of the order.

order_id instance-attribute ¤
order_id: builtins.int

Unique identifier of the order.

state_detail property ¤
state_detail: global___OrderDetail.StateDetail

Details of the order's current state.

Classes¤
StateDetail ¤

Bases: Message

Inner message providing details about the current state of the order.

Attributes¤
MARKET_ACTOR_MARKET_OPERATOR instance-attribute ¤ 
MARKET_ACTOR_MARKET_OPERATOR: OrderDetail.StateDetail.MarketActor.ValueType

The market operator was the actor.

MARKET_ACTOR_SYSTEM instance-attribute ¤ 
MARKET_ACTOR_SYSTEM: OrderDetail.StateDetail.MarketActor.ValueType

The system was the actor.

MARKET_ACTOR_USER instance-attribute ¤ 
MARKET_ACTOR_USER: OrderDetail.StateDetail.MarketActor.ValueType

The user was the actor.

STATE_REASON_ADD instance-attribute ¤ 
STATE_REASON_ADD: OrderDetail.StateDetail.StateReason.ValueType

The order was added.

STATE_REASON_DEACTIVATE instance-attribute ¤ 
STATE_REASON_DEACTIVATE: OrderDetail.StateDetail.StateReason.ValueType

The order was deactivated.

STATE_REASON_DELETE instance-attribute ¤ 
STATE_REASON_DELETE: OrderDetail.StateDetail.StateReason.ValueType

The order was deleted.

STATE_REASON_FULL_EXECUTION instance-attribute ¤ 
STATE_REASON_FULL_EXECUTION: OrderDetail.StateDetail.StateReason.ValueType

The order was fully executed.

STATE_REASON_ICEBERG_SLICE_ADD instance-attribute ¤ 
STATE_REASON_ICEBERG_SLICE_ADD: OrderDetail.StateDetail.StateReason.ValueType

An iceberg slice was added.

STATE_REASON_MODIFY instance-attribute ¤ 
STATE_REASON_MODIFY: OrderDetail.StateDetail.StateReason.ValueType

The order was modified.

STATE_REASON_PARTIAL_EXECUTION instance-attribute ¤ 
STATE_REASON_PARTIAL_EXECUTION: OrderDetail.StateDetail.StateReason.ValueType

The order was partially executed.

STATE_REASON_QUOTE_ADD instance-attribute ¤ 
STATE_REASON_QUOTE_ADD: OrderDetail.StateDetail.StateReason.ValueType

A quote was added.

STATE_REASON_QUOTE_FULL_EXECUTION instance-attribute ¤ 
STATE_REASON_QUOTE_FULL_EXECUTION: OrderDetail.StateDetail.StateReason.ValueType

A quote was fully executed.

STATE_REASON_QUOTE_PARTIAL_EXECUTION instance-attribute ¤ 
STATE_REASON_QUOTE_PARTIAL_EXECUTION: OrderDetail.StateDetail.StateReason.ValueType

A quote was partially executed.

STATE_REASON_REJECT instance-attribute ¤ 
STATE_REASON_REJECT: OrderDetail.StateDetail.StateReason.ValueType

The order was rejected.

STATE_REASON_UNKNOWN_STATE instance-attribute ¤ 
STATE_REASON_UNKNOWN_STATE: OrderDetail.StateDetail.StateReason.ValueType

The state of the order is unknown.

STATE_REASON_VALIDATION_FAIL instance-attribute ¤ 
STATE_REASON_VALIDATION_FAIL: OrderDetail.StateDetail.StateReason.ValueType

The order failed validation.

market_actor instance-attribute ¤ 
market_actor: global___OrderDetail.StateDetail.MarketActor.ValueType

Actor responsible for the current state.

state instance-attribute ¤ 
state: global___OrderState.ValueType

Current state of the order.

state_reason instance-attribute ¤ 
state_reason: global___OrderDetail.StateDetail.StateReason.ValueType

Reason for the current state.

Classes¤
MarketActor ¤

Bases: _MarketActor

Enum describing the actor responsible for an order state change.

StateReason ¤

Bases: _StateReason

Enum describing the action that led to the state change.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.OrderExecutionOption ¤

Bases: _OrderExecutionOption

OrderExecutionOption defines specific behavior for the execution of an order. These options provide control on how an order is handled in the market.

Source code in py/frequenz/api/electricity_trading/v1/electricity_trading_pb2.py 
64
65
66
67
_globals['_UPDATEGRIDPOOLORDERREQUEST_UPDATEORDER']._serialized_end=5348
_globals['_UPDATEGRIDPOOLORDERRESPONSE']._serialized_start=5351
_globals['_UPDATEGRIDPOOLORDERRESPONSE']._serialized_end=5493
_globals['_CANCELGRIDPOOLORDERREQUEST']._serialized_start=5495

frequenz.api.electricity_trading.v1.electricity_trading_pb2.OrderState ¤

Bases: _OrderState

Enum for the state of an order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.OrderType ¤

Bases: _OrderType

Enum for the order types that can be specified for an order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.PublicOrder ¤

Bases: Message

Represents a public order in the market.

Each PublicOrder within this response message represents an order that was previously active in the public order book, along with its key attributes and final state.

Attributes¤
buy_delivery_area property ¤
buy_delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

Delivery area code of the buy side.

delivery_period property ¤
delivery_period: frequenz.api.common.v1.grid.delivery_duration_pb2.DeliveryPeriod

The delivery period for the contract.

modification_time property ¤
modification_time: google.protobuf.timestamp_pb2.Timestamp

UTC Timestamp of the last order update or matching.

price property ¤
price: frequenz.api.common.v1.market.price_pb2.Price

The limit price at which the contract is to be traded.

public_order_id instance-attribute ¤
public_order_id: builtins.int

ID of the order from the public order book.

quantity property ¤
quantity: frequenz.api.common.v1.market.energy_pb2.Energy

The quantity of the contract being traded in MWh.

sell_delivery_area property ¤
sell_delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

Delivery area code of the sell side.

state instance-attribute ¤
state: global___OrderState.ValueType

State of the order.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.PublicOrderFilter ¤

Bases: Message

Parameters for filtering the historic, publicly executed orders (trades).

Attributes¤
buy_delivery_area property ¤
buy_delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

If set, only orders in this buy delivery area are returned.

delivery_period property ¤
delivery_period: frequenz.api.common.v1.grid.delivery_duration_pb2.DeliveryPeriod

If set, only orders with this delivery period are returned.

sell_delivery_area property ¤
sell_delivery_area: frequenz.api.common.v1.grid.delivery_area_pb2.DeliveryArea

If set, only orders in this sell delivery area are returned.

states property ¤
states: google.protobuf.internal.containers.RepeatedScalarFieldContainer[
    global___OrderState.ValueType
]

If set, only orders in this state are returned.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ReceiveGridpoolOrdersStreamRequest ¤

Bases: Message

Subscribe to Gridpool order stream. This method provides real-time updates on Gridpool orders, making it useful for dynamic analytics and real-time decision-making.

Attributes¤
filter property ¤
filter: global___GridpoolOrderFilter

Optional public orders filter.

DeliveryPeriod Filter

Ensure that the specified DeliveryPeriod is set for a future timeframe. If a past or present period is selected, the stream will automatically close and return no entries.

gridpool_id instance-attribute ¤
gridpool_id: builtins.int

The gridpool to retrieve the orders for.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ReceiveGridpoolOrdersStreamResponse ¤

Bases: Message

Response to a subscription request for a stream of Gridpool orders. Real-time information on gridpool orders is pushed through this response.

Attributes¤
order_detail property ¤
order_detail: global___OrderDetail

Order detail response.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ReceivePublicOrdersStreamRequest ¤

Bases: Message

Subscribe to public order stream. This method provides real-time updates on newly executed public orders, making it useful for dynamic analytics and real-time decision-making.

Attributes¤
filter property ¤
filter: global___PublicOrderFilter

Optional filter to specify which orders should be included in the stream.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.ReceivePublicOrdersStreamResponse ¤

Bases: Message

Response to a subscription request for a stream of public orders. Real-time information on public orders is pushed through this response.

Attributes¤
public_order property ¤
public_order: global___PublicOrder

The public order that has been executed and is being broadcasted in real-time.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.UpdateGridpoolOrderRequest ¤

Bases: Message

Request to update an existing order for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the Gridpool the order belongs to.

order_id instance-attribute ¤
order_id: builtins.int

The order identifier

update_mask property ¤
update_mask: google.protobuf.field_mask_pb2.FieldMask

Field mask specifying which fields should be updated

update_order_fields property ¤
update_order_fields: global___UpdateGridpoolOrderRequest.UpdateOrder

The fields that can be updated

Classes¤
UpdateOrder ¤

Bases: Message

Represents the order properties that can be updated after an order has been placed. At least one of the optional fields must be set for an update to take place.

Attributes¤
display_quantity property ¤ 
display_quantity: frequenz.api.common.v1.market.energy_pb2.Energy

Applicable for ICEBERG orders. This is the updated quantity of the order to be displayed in the order book.

execution_option instance-attribute ¤ 
execution_option: global___OrderExecutionOption.ValueType

Updated execution options such as All or None, Fill or Kill, etc.

payload property ¤ 
payload: google.protobuf.struct_pb2.Struct

Updated user-defined payload individual to a specific order. This can be any data that the user wants to associate with the order.

peak_price_delta property ¤ 
peak_price_delta: frequenz.api.common.v1.market.price_pb2.Price

Applicable for ICEBERG orders. This is the updated price difference between the peak price and the limit price.

price property ¤ 
price: frequenz.api.common.v1.market.price_pb2.Price

The updated limit price at which the contract is to be traded. This is the maximum price for a BUY order or the minimum price for a SELL order.

quantity property ¤ 
quantity: frequenz.api.common.v1.market.energy_pb2.Energy

The updated quantity of the contract being traded, specified in MWh.

stop_price property ¤ 
stop_price: frequenz.api.common.v1.market.price_pb2.Price

Applicable for STOP_LIMIT orders. This is the updated stop price that triggers the limit order.

tag instance-attribute ¤ 
tag: builtins.str

Updated user-defined tag to group related orders.

valid_until property ¤ 
valid_until: google.protobuf.timestamp_pb2.Timestamp

This is an updated timestamp defining the time after which the order should be cancelled if not filled. The timestamp is in UTC.

frequenz.api.electricity_trading.v1.electricity_trading_pb2.UpdateGridpoolOrderResponse ¤

Bases: Message

Response from updating an existing order for a given Gridpool.

Attributes¤
gridpool_id instance-attribute ¤
gridpool_id: builtins.int

ID of the Gridpool the order belongs to.

order_detail property ¤
order_detail: global___OrderDetail

Details of the updated order.