Skip to content

Listing Challenges for Market Sessions

After retrieving the open market sessions, you may want to list the challenges associated with a specific market session. Challenges are opportunities published by the Market Maker (Elia) that Forecasters can submit forecasts for.

Important

  • Each challenge is created for a specific use case, target day, and associated target resource.
  • For this proof of concept every challenge will be an opportunity for forecasters to submit forecasts for the offshore wind power generation in Belgian grid.

API Endpoints:

To interact with the Predicto API and retrieve information about challenges published in open market sessions, you can use the following endpoints:

Prerequisites

  • Access Token: Ensure you have a valid access token. Refer to the Authentication section if needed.
  • Open Market Session ID: You should have the ID of the open market session you're interested in. See Listing Open Sessions to retrieve it.

Check this out

Check our Useful Links section for additional resources (Jupyter Notebook, API Specifications) to help you get started with the Predico platform.

Retrieving Challenges for an Open Market Session

Here's how you can retrieve the list of registered challenges for a specific open market session using Python:

Tip: How to preview previous challenges

  • To preview every challenge registered in this platform, simply change the open_only query parameter to false in the request URL.
list_challenges_for_open_session.py
import requests

access_token = "your_access_token"
open_market_session_id = "your_open_market_session_id"

headers = {
    'Authorization': f'Bearer {access_token}',
    'Accept': 'application/json'
}

params = {
    'market_session': open_market_session_id
}

response = requests.get(
    url='https://predico-elia.inesctec.pt/api/v1/market/challenge',
    params=params,
    headers=headers
)

# Check if the request was successful
if response.status_code == 200:
    challenges = response.json()
    print("Challenges for Open Market Session:")
    print(challenges)
else:
    print("Failed to retrieve challenges.")
    print(f"Status code: {response.status_code}")

Download Full Example

JSON Example Response

After running the example script, you will receive a response containing a list of market challenges. It's important to verify whether the response contains any data, as there may be not challenges created yet, by the Market Maker.

If the response is empty, you may need to try again later.

Click to view Example Response 
{
  "code": 200,
  "data": [
    {
      "id": "ef3a473f-0fcf-4880-8b42-93f6bf732e3a",
      "use_case": "wind_power",
      "start_datetime": "2024-06-24T22:00:00Z",
      "end_datetime": "2024-06-25T21:45:00Z",
      "target_day": "2024-06-25",
      "registered_at": "2024-06-24T09:19:33.990638Z",
      "updated_at": "2024-06-24T09:19:33.990638Z",
      "user": "3ca74375-2ac0-46f4-b4bf-7cf013d0c28f",
      "resource": "b92c96d1-f5ee-4f96-a4cc-216a92acb10b",
      "market_session": 1,
      "resource_name": "wind_farm_x"
    }
  ]
}

What's next?

Learn how to download measurements data information (published by Market Makers) on the Predico platform in the Downloading Raw Data section.