AIIDA

Appearance

Real Time Data Market Document ​

The Real Time Data (RTD) Market Document contains near-real time (NRT) data that is received from a data source in AIIDA. The RTD Market Document is sent as JSON document over MQTT from AIIDA to EDDIE.

The XSD files for the different versions of this document can be found here:

xml
<MarketDocument>
    <!-- The UUID of the Real Time Data Market Document -->
    <mRID>bff481d5-edd8-4602-9c54-838b386ab4dd</mRID>
    <!-- UTC timestamp when the Market Document was created -->
    <createdDateTime>2025-07-01T09:44:00.00032307Z</createdDateTime>
    <TimeSeries>
        <!-- The values of an AIIDA Record -->
        <TimeSeries>
            <!-- The version of the Time Series, currently always 1.0 -->
            <version>1.0</version>
            <registeredResource.mRID codingScheme="NAT">
                <!-- The UUID of the data source which provided the data -->
                <value>5eef407d-d14f-49d4-b61a-769a20caa540</value>
            </registeredResource.mRID>
            <!-- UTC timestamp of the AIIDA Record -->
            <dateAndOrTime.dateTime>2025-07-01T07:43:59.073747585Z</dateAndOrTime.dateTime>
            <Quantity>
                <!-- Equivalents with an AIIDA Record Value -->
                <Quantity>
                    <!-- The quantity value of the AIIDA record -->
                    <quantity>25</quantity>
                    <!-- The type of the quantity -->
                    <type>0</type>
                    <!-- The quality of the quantity -->
                    <quality>AS_PROVIDED</quality>
                </Quantity>
                <!-- Equivalents with an AIIDA Record Value -->
                <Quantity>
                    <!-- The quantity value of the AIIDA record -->
                    <quantity>1750</quantity>
                    <!-- The type of the quantity -->
                    <type>2</type>
                    <!-- The quality of the quantity -->
                    <quality>AS_PROVIDED</quality>
                </Quantity>
            </Quantity>
        </TimeSeries>
    </TimeSeries>
</MarketDocument>

Time Series ​

Time Series in the RTD Market Document represent the values of an AIIDA Record, called quantities in the CIM. Quantities have a type that indicates what the quantity represents as well as its unit. Quantities also provide a quality field that indicates the quality of the quantity.

Type ​

Currently, the following types are supported:

EnumValueEnumNameDescriptionUnit
0TOTAL_ACTIVE_ENERGY_CONSUMED_KWHCumulative amount of electrical energy consumed from the gridkWh
1TOTAL_ACTIVE_ENERGY_PRODUCED_KWHCumulative amount of electrical energy exported back to the gridkWh
2INSTANTANEOUS_ACTIVE_POWER_CONSUMPTION_KWReal-time power currently being consumed from the gridkW
3INSTANTANEOUS_ACTIVE_POWER_GENERATION_KWReal-time power currently being generated and exported to the gridkW
4INSTANTANEOUS_VOLTAGE_V_IN_PHASE_L1Real-time voltage level on phase L1V
5INSTANTANEOUS_VOLTAGE_V_IN_PHASE_L2Real-time voltage level on phase L2V
6INSTANTANEOUS_VOLTAGE_V_IN_PHASE_L3Real-time voltage level on phase L3V
7INSTANTANEOUS_CURRENT_A_IN_PHASE_L1Real-time current flowing on phase L1A
8INSTANTANEOUS_CURRENT_A_IN_PHASE_L2Real-time current flowing on phase L2A
9INSTANTANEOUS_CURRENT_A_IN_PHASE_L3Real-time current flowing on phase L3A
10INSTANTANEOUS_POWERFACTORRatio of real power to apparent power, indicating efficiency of power usage-
11TOTAL_ACTIVE_ENERGY_CONSUMED_KWH_IN_PHASE_L1Amount of electrical energy consumed from the grid on phase L1kWh
12TOTAL_ACTIVE_ENERGY_CONSUMED_KWH_IN_PHASE_L2Amount of electrical energy consumed from the grid on phase L2kWh
13TOTAL_ACTIVE_ENERGY_CONSUMED_KWH_IN_PHASE_L3Amount of electrical energy consumed from the grid on phase L3kWh
14TOTAL_ACTIVE_ENERGY_PRODUCED_KWH_IN_PHASE_L1Amount of electrical energy exported back to the grid on phase L1kWh
15TOTAL_ACTIVE_ENERGY_PRODUCED_KWH_IN_PHASE_L2Amount of electrical energy exported back to the grid on phase L2kWh
16TOTAL_ACTIVE_ENERGY_PRODUCED_KWH_IN_PHASE_L3Amount of electrical energy exported back to the grid on phase L3kWh
17INSTANTANEOUS_ACTIVE_POWER_CONSUMPTION_KW_IN_PHASE_L1Real-time power currently being consumed from the grid on phase L1kW
18INSTANTANEOUS_ACTIVE_POWER_CONSUMPTION_KW_IN_PHASE_L2Real-time power currently being consumed from the grid on phase L2kW
19INSTANTANEOUS_ACTIVE_POWER_CONSUMPTION_KW_IN_PHASE_L3Real-time power currently being consumed from the grid on phase L3kW
20INSTANTANEOUS_REACTIVE_POWER_CONSUMPTION_KVARReal-time reactive power currently being consumed from the grid on phase L1kvar
21INSTANTANEOUS_REACTIVE_POWER_CONSUMPTION_KVAR_IN_PHASE_L1Real-time reactive power currently being consumed from the grid on phase L1kvar
22INSTANTANEOUS_REACTIVE_POWER_CONSUMPTION_KVAR_IN_PHASE_L2Real-time reactive power currently being consumed from the grid on phase L2kvar
23INSTANTANEOUS_REACTIVE_POWER_CONSUMPTION_KVAR_IN_PHASE_L3Real-time reactive power currently being consumed from the grid on phase L3kvar
24INSTANTANEOUS_REACTIVE_POWER_GENERATION_KVARReal-time reactive power currently being generated and exported to the gridkvar
25INSTANTANEOUS_VOLTAGE_VReal-time voltage levelV
26INSTANTANEOUS_CURRENT_AReal-time current flowingA
27INSTANTANEOUS_CURRENT_A_IN_PHASE_NEUTRALReal-time current flowing on the neutral conductorA
28MAXIMUM_CURRENT_AMaximum current observed during the time intervalA
29MAXIMUM_CURRENT_A_IN_PHASE_L1Maximum current observed during the time interval on phase L1A
30MAXIMUM_CURRENT_A_IN_PHASE_L2Maximum current observed during the time interval on phase L2A
31MAXIMUM_CURRENT_A_IN_PHASE_L3Maximum current observed during the time interval on phase L3A
32INSTANTANEOUS_POWER_FACTOR_IN_PHASE_L1Real-time power factor on phase L1-
33INSTANTANEOUS_POWER_FACTOR_IN_PHASE_L2Real-time power factor on phase L2-
34INSTANTANEOUS_POWER_FACTOR_IN_PHASE_L3Real-time power factor on phase L3-
35FREQUENCY_HZReal-time frequency of the electrical systemHz

Quality ​

Currently, the following qualities are supported:

EnumValueEnumNameDescription
A01ADJUSTEDThe value has been adjusted
A02NOT_AVAILABLEThe value is not available
A03ESTIMATEDThe value is estimated
A04AS_PROVIDEDThe value is provided as is, without modifications
A05INCOMPLETEThe value is incomplete
A06CALCULATEDThe value has been calculated

Complete JSON Example ​

json
{
  "MessageDocumentHeader": {
    "creationDateTime": "2026-02-11T15:32:25Z",
    "MetaInformation": {
      "connectionId": "1",
      "requestPermissionId": "70744400-a059-4fc8-ab36-d68b2bb877e1",
      "dataNeedId": "5dc71d7e-e8cd-4403-a3a8-d3c095c97a84",
      "documentType": "near-real-time-market-document",
      "finalCustomerId": "88e0fc2c-4ea7-4850-a736-8b9742757518",
      "dataSourceId": "7d2b2547-27dd-4fe0-9516-707540e1184f",
      "regionConnector": "aiida",
      "regionCountry": "AT",
      "Asset": {
        "type": "CONNECTION-AGREEMENT-POINT",
        "operatorId": "AT003000",
        "meterId": "003114735"
      }
    }
  },
  "MarketDocument": {
    "mRID": "bfc16eda-4f05-4711-b319-af17ec0ce6d5",
    "createdDateTime": "2026-02-11T15:32:25Z",
    "TimeSeries": [
      {
        "version": "1.0",
        "dateAndOrTime.dateTime": "2026-02-11T15:32:24Z",
        "Quantity": [
          {
            "quantity": 0.132,
            "type": "2",
            "quality": "AS_PROVIDED"
          },
          {
            "quantity": 65238.377,
            "type": "0",
            "quality": "AS_PROVIDED"
          }
        ],
        "registeredResource.mRID": {
          "value": "7d2b2547-27dd-4fe0-9516-707540e1184f",
          "codingScheme": "NAT"
        }
      }
    ]
  }
}