Grid Singularity Grid Operator API Overview

The Grid Singularity Grid Operator API is designed for grid operators (notably Distribution System Operators or DSOs) to manage congestion and grid constraints in different markets across the grid. The structure is designed so that multiple markets can be managed by a single agent (digital representation of the grid operator preferences), allowing information to be aggregated for integrated grid management.

It allows users to create agents that can dynamically change the grid fee in different markets. These agents can request and receive information through the Grid Operator API, feed that information into a tariff model, and submit grid fees through the Exchange SDK to change grid fees on the exchange. For more information, see this article.

To actively manage grid congestion by applying different grid fees for each market slot for select markets at different levels of the grid, please follow the following steps:

First, please install the Grid Singularity Exchange SDK on your computer by launching the following commands on your terminal window:

Install gsy-e-sdk

mkvirtualenv gsy-e-sdk
pip install https://github.com/gridsingularity/gsy-e-sdk.git

Update gsy-e-sdk (needed when an update is deployed)

pip uninstall -y gsy-e-sdk
pip install git+https://github.com/gridsingularity/gsy-e-sdk.git

Install the following Python packages

pip install pandas
pip install openpyxl
  1. For connecting to a specific Collaboration/Canary Network, the owner/Exchange Operator has to invite and grant access as Grid operator in the Registry panel:
    alt_text
  2. Edit the Grid Operator SDK Script template to experiment with different grid fee models and launch it.
  3. Run the Collaboration or notify the exchange operator that you are ready.