CALENDAR_LIST Command

Get calendar events

Help

{
  "MSG":"HELP",
  "COMMAND":"CALENDAR_LIST",
  "DESCRIPTION":"Receive calendar events",
  "MANDATORY_TAGS":[
     "FROM_DATE (String)",
     "TO_DATE (String)"
  ],
  "OPTIONAL_TAGS":[
     "CURRENCY (String)",
     "COUNTRY_CODE (String)"
  ],
  "ERROR_ID":0,
  "ERROR_DESCRIPTION":"The operation completed successfully"
}

Information

CURRENCY (String): Country currency code name. "EUR", "USD" and so on.

COUNTRY_CODE (String): Country code name (ISO 3166-1 alpha-2). "US", "FR" and so on.

Example

Single Line command (necessary for MTsocketAPI):

{"MSG":"CALENDAR_LIST","FROM_DATE":"2024.05.03","TO_DATE":"2024.05.04","CURRENCY":"USD"}

Same command in Beauty Format:

{
   "MSG":"CALENDAR_LIST",
   "FROM_DATE":"2024.05.03",
   "TO_DATE":"2024.05.04",
   "CURRENCY":"USD"
}

MTsocketAPI reply:

{
   "MSG":"CALENDAR_LIST",
   "EVENTS":[
      {
         "TIME":"2024.05.03 15:30:00",
         "EVENT_COUNTRY_ID":840,
         "EVENT_DIGITS":1,
         "EVENT_CODE":"unemployment-rate",
         "EVENT_FREQUENCY":"CALENDAR_FREQUENCY_MONTH",
         "EVENT_ID":840030015,
         "EVENT_IMPORTANCE":"CALENDAR_IMPORTANCE_MODERATE",
         "EVENT_MULTIPLIER":"CALENDAR_MULTIPLIER_NONE",
         "EVENT_NAME":"Unemployment Rate",
         "EVENT_SECTOR":"CALENDAR_SECTOR_JOBS",
         "EVENT_SOURCE_URL":"https:\/\/www.bls.gov",
         "EVENT_TIME_MODE":"CALENDAR_TIMEMODE_DATETIME",
         "EVENT_TYPE":"CALENDAR_TYPE_INDICATOR",
         "EVENT_UNIT":"CALENDAR_UNIT_PERCENT",
         "ACTUAL_VALUE":3.9000,
         "FORECAST_VALUE":3.7000,
         "PREVIOUS_VALUE":3.8000,
         "IMPACT_TYPE":"CALENDAR_UNIT_CURRENCY",
         "REVISION":0,
         "PERIOD":"2024.04.01 00:00:00"
      },
      {
         "TIME":"2024.05.03 15:30:00",
         "EVENT_COUNTRY_ID":840,
         "EVENT_DIGITS":0,
         "EVENT_CODE":"nonfarm-payrolls",
         "EVENT_FREQUENCY":"CALENDAR_FREQUENCY_MONTH",
         "EVENT_ID":840030016,
         "EVENT_IMPORTANCE":"CALENDAR_IMPORTANCE_HIGH",
         "EVENT_MULTIPLIER":"CALENDAR_MULTIPLIER_THOUSANDS",
         "EVENT_NAME":"Nonfarm Payrolls",
         "EVENT_SECTOR":"CALENDAR_SECTOR_JOBS",
         "EVENT_SOURCE_URL":"https:\/\/www.bls.gov",
         "EVENT_TIME_MODE":"CALENDAR_TIMEMODE_DATETIME",
         "EVENT_TYPE":"CALENDAR_TYPE_INDICATOR",
         "EVENT_UNIT":"CALENDAR_UNIT_JOB",
         "ACTUAL_VALUE":175.0000,
         "FORECAST_VALUE":197.0000,
         "PREVIOUS_VALUE":303.0000,
         "REVISED_VALUE":315.0000,
         "IMPACT_TYPE":"CALENDAR_UNIT_CURRENCY",
         "REVISION":0,
         "PERIOD":"2024.04.01 00:00:00"
      },
      ...
      {
         "TIME":"2024.05.03 22:30:00",
         "EVENT_COUNTRY_ID":840,
         "EVENT_DIGITS":1,
         "EVENT_CODE":"cftc-nasdaq-100-non-commercial-net-positions",
         "EVENT_FREQUENCY":"CALENDAR_FREQUENCY_WEEK",
         "EVENT_ID":840520011,
         "EVENT_IMPORTANCE":"CALENDAR_IMPORTANCE_LOW",
         "EVENT_MULTIPLIER":"CALENDAR_MULTIPLIER_THOUSANDS",
         "EVENT_NAME":"CFTC Nasdaq 100 Non-Commercial Net Positions",
         "EVENT_SECTOR":"CALENDAR_SECTOR_MARKET",
         "EVENT_SOURCE_URL":"https:\/\/www.cftc.gov\/",
         "EVENT_TIME_MODE":"CALENDAR_TIMEMODE_DATETIME",
         "EVENT_TYPE":"CALENDAR_TYPE_INDICATOR",
         "EVENT_UNIT":"CALENDAR_UNIT_POSITION",
         "PREVIOUS_VALUE":6.1000,
         "IMPACT_TYPE":"CALENDAR_UNIT_NONE",
         "REVISION":0,
         "PERIOD":"2024.04.30 00:00:00"
      }
   ],
   "ERROR_ID":0,
   "ERROR_DESCRIPTION":"The operation completed successfully"
}