Hub-to-Hub matrix
Data of available transfer capacities are only available for delivery periods opened for trading.
To receive notifications about changes in available transfer capacities, the client must connect via WebSocket with the topic hubtohub.
Message of type hubtohub-snapshot is sent to the client after the connection is initiated with the hubtohub topic or without any topic specified. This message represents the state of the available transfer capacities at that moment. Subsequent messages of type hubtohub-change are sent to reflect changes to the available transfer capacities.
Client can request new snapshot anytime with message of type hubtohub-snapshot.
GET https://isot.okte.sk/api/v1/idm/hub-to-hub
Parameters
|
:deliveryFrom |
Date Time 8601 UTC Start time of delivery range |
|---|---|
|
:deliveryTo |
Date Time 8601 UTC End time of delivery range |
|
:countryCodes |
Enum (CZ, PL, HU...) Two-letter country codes separated by commas. |
Example
GET https://isot.okte.sk/api/v1/idm/hub-to-hub?countryCodes=CZ&deliveryFrom=2024-11-18T13:00:00Z[
{
"eic": "10YCZ-CEPS-----N",
"areaName": "CEPS",
"countryCode": "CZ",
"deliveryDay": "2024-11-18",
"deliveryStart": "2024-11-18T22:00:00Z",
"deliveryEnd": "2024-11-18T23:00:00Z",
"availableCapacityIn": 3066,
"availableCapacityOut": 2798
}
]
Request may return HTTP status codes 200 (OK), 400 (Bad Request), 429 (Too Many Requests), or 500 (Internal Server Error).
Response fields description
| Field | Description | Format |
| eic | EIC of the Market Area | String |
| areaName | Name of the Market Area | String |
| countryCode | Two-letter country code | Enum (CZ, PL, HU...) |
| deliveryDay | Date of the delivery | Date ISO 8601 |
| deliveryStart | Delivery period start | Date Time 8601 UTC |
| deliveryEnd | Delivery period end | Date Time 8601 UTC |
| availableCapacityIn | Available import capacities in MW | Float number |
| availableCapacityOut | Available export capacities in MW | Float number |
Snapshot message example (WebSocket)
WS wss://isot.okte.sk/api/v1/idm/ws?topics=hubtohub{
"type": "hubtohub-snapshot",
"payload": {
"data": [
{
"eic": "10YCZ-CEPS-----N",
"areaName": "CEPS",
"countryCode": "CZ",
"deliveryDay": "2024-11-20",
"deliveryStart": "2024-11-20T20:00:00Z",
"deliveryEnd": "2024-11-20T21:00:00Z",
"availableCapacityIn": 2310,
"availableCapacityOut": 110
}
]
}
}
Changes message example (WebSocket)
WS wss://isot.okte.sk/api/v1/idm/ws?topics=hubtohub{
"type": "hubtohub-change",
"payload": {
"data": [
{
"eic": "10YCZ-CEPS-----N",
"areaName": "CEPS",
"countryCode": "CZ",
"deliveryDay": "2024-11-20",
"deliveryStart": "2024-11-20T20:00:00Z",
"deliveryEnd": "2024-11-20T21:00:00Z",
"availableCapacityIn": 2319,
"availableCapacityOut": 0
}
]
}
}
Snapshot request message example (WebSocket)
WS wss://isot.okte.sk/api/v1/idm/ws?topics=hubtohub{
"type": "hubtohub-snapshot"
}