logo
Documentation Powered by ReDoc

ETSS Market Data API (1.0.4)

Download OpenAPI specification:Download

E-mail: prodsappsdevelsd@athexgroup.gr Terms of Service

The ETSS Market Data API is an HTTP REST API served by ENEX. It is the same API the ETSS web client uses to communicate with the Market Data server, so everything the web client can do, can be done with the API. Most of the client's commands map directly to API endpoints.

Authentication

The authentication for ETSS Market Data API is centralized and implements single sign-on and access control for modern web applications and APIs using protocol OAuth2 . Moreover, the authentication process is token based, which means that in order to access an API, the API request must include a valid access token, issued by the ENEX authentication service. To obtain an access token, a standard OAuth2 'client credentials' flow should be followed against the ENEX Identity Management System. All subsequent calls to the API methods POST / GET / DELETE should send an Authorization: Bearer <access token> header.

OAuth2_bearer

The API consumer must provide a valid JWT access token, obtained after successful authentication (by either 'code' or 'client credentials' OAuth2 flows) against the ENEX authentication server.

Security Scheme Type HTTP
HTTP Authorization Scheme bearer
Bearer format "JWT"

OAuth2_implicit

This API uses OAuth 2 with the implicit grant flow. More info

Security Scheme Type OAuth2
implicit OAuth Flow
Authorization URL: https://login.helex.gr/ms_oauth/oauth2/endpoints/oauthservice/tokens
Scopes:
  • openid -

    default

System

Requests in this section, provide Trading System specific data, for eventual use in subsequent requests.

Market Data server local time.

Returns the Market Data System local (Europe/Athens) time.

Authorizations:
OAuth2_bearer

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "localTime": "2022-01-01T23:00:00.000000+02:00",
  • "marketTime": "2022-01-01T13:00:00.000000+01:00"
}

Get a list of products

The list of traded products as defined in the XBID trading system.

Authorizations:
OAuth2_bearer
query Parameters
productName
string
Example: productName=XBID_Half_Hour_Power, XBID_Hour_Power, XBID_Quarter_Hour_Power

The product id sought

state
string
Enum: "ACTI" "IACT" "HIBE"

The state of products sought

header Parameters
X-ETSS-CUID
string <uuid>

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00",
  • "data": {
    }
}

Get a list of contracts per date

Authorizations:
OAuth2_bearer
query Parameters
date
string
Example: date=2022-02-24

The delivery date for which the contracts are effective. (YYYY-MM-DD ISO 8601)

dateTo
string
Example: dateTo=2022-02-25

The last (inclusive) delivery date of the range for which the contracts are effective. (YYYY-MM-DD ISO 8601)

contractId
integer <int64>

The contract id sought

state
string
Enum: "ACTI" "IACT" "HIBE"

The state of contracts sought

tradingPhase
string
Enum: "CLSD" "CONT"

The trading phase of contracts sought

product
string
Example: product=XBID_Hour_Power,XBID_Quarter_Hour_Power

The (comma delimited) product names of contracts sought

header Parameters
X-ETSS-CUID
string <uuid>

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00",
  • "data": {
    }
}

Markets

Everything about markets

Get the list of market areas

Authorizations:
OAuth2_bearer
query Parameters
marketAreaId
string

The market area sought

header Parameters
X-ETSS-CUID
string <uuid>

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00",
  • "data": {
    }
}

Miscellaneous

Miscellaneous requests

server-info data

Gets operational information of the API Application Server

Authorizations:
OAuth2_bearer

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "company": "string",
  • "wsInstance": "string",
  • "loginMode": "string",
  • "wsVersion": "string",
  • "apiVersion": "string",
  • "remoteIp": "string"
}

Unauthenticated API server connectivity check.

Returns the API server local (Europe/Athens) time.

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00"
}

Capacities

Get the list of Hub To Hub available capacities

Authorizations:
OAuth2_bearer
query Parameters
date
string
Example: date=2022-05-18

The delivery date for which the atcs are effective. (YYYY-MM-DD ISO 8601)

hubFrom
string

The source hub's delivery area Id (EIC)

deliveryStart
string
Example: deliveryStart=2022-01-01T23:00+01:00

The deliveryStart datetime in Europe/Amsterdam timezone, for which the atcs are effective. CET/CEST ISO 8601 YYYY-MM-DDThh:mmTZD

header Parameters
X-ETSS-CUID
string <uuid>

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00",
  • "data": [
    ]
}

Get the list of cross-border available capacities.

Authorizations:
OAuth2_bearer
query Parameters
date
string
Example: date=2022-05-18

The delivery date for which the atcs are effective. (YYYY-MM-DD ISO 8601)

hubFrom
string

The source hub's delivery area Id (EIC)

deliveryStart
string
Example: deliveryStart=2022-01-01T23:00+01:00

The deliveryStart datetime in Europe/Amsterdam timezone, for which the atcs are effective. CET/CEST ISO 8601 YYYY-MM-DDThh:mmTZD

header Parameters
X-ETSS-CUID
string <uuid>

Responses

Response samples

Content type
application/json; charset=UTF-8
{
  • "serverTime": "2022-01-01T23:00:00.000000+02:00",
  • "data": [
    ]
}

Streaming SSE

The SSE endpoint propagating private events concerning the orders residing in ETSS

Authorizations:
OAuth2_bearer

Responses

The SSE endpoint propagating public messages for the state of the XBID Single Order Book

Authorizations:
OAuth2_bearer

Responses