CALENDAR_LIST
Description
Gets the Economic Calendar available in your terminal.
Important
All JSON commands you send to MetaSocket should be in a single line format similar to the examples below. Additionally, example replies in this page are presented in a "beautified" format for presentation purposes. Actual replies are always returned in a single line.
Example
{"MSG": "CALENDAR_LIST","FROM_DATE": "2025.09.16","TO_DATE": "2025.09.17","CURRENCY": "USD"}
Reply
{
"MSG": "CALENDAR_LIST",
"EVENTS": [
{
"TIME": "2025.09.16 15:30:00",
"EVENT_ID": 840020010,
"EVENT_NAME": "Retail Sales m/m",
"EVENT_DIGITS": 1,
"EVENT_IMPORTANCE": "CALENDAR_IMPORTANCE_HIGH",
"EVENT_SOURCE_URL": "https://census.gov",
"EVENT_UNIT": "CALENDAR_UNIT_PERCENT",
"CURRENCY": "USD",
"ACTUAL_VALUE": 600000,
"FORECAST_VALUE": -300000,
"PREVIOUS_VALUE": 500000
},
{
"TIME": "2025.09.16 15:30:00",
"EVENT_ID": 840020011,
"EVENT_NAME": "Core Retail Sales m/m",
"EVENT_DIGITS": 1,
"EVENT_IMPORTANCE": "CALENDAR_IMPORTANCE_HIGH",
"EVENT_SOURCE_URL": "https://census.gov",
"EVENT_UNIT": "CALENDAR_UNIT_PERCENT",
"CURRENCY": "USD",
"ACTUAL_VALUE": 700000,
"FORECAST_VALUE": 0,
"PREVIOUS_VALUE": 300000
},
{
"TIME": "2025.09.16 15:30:00",
"EVENT_ID": 840020012,
"EVENT_NAME": "Retail Control m/m",
"EVENT_DIGITS": 1,
"EVENT_IMPORTANCE": "CALENDAR_IMPORTANCE_MODERATE",
"EVENT_SOURCE_URL": "https://census.gov",
"EVENT_UNIT": "CALENDAR_UNIT_PERCENT",
"CURRENCY": "USD",
"ACTUAL_VALUE": 700000,
"FORECAST_VALUE": -200000,
"PREVIOUS_VALUE": 500000
},
{
"TIME": "2025.09.16 15:30:00",
"EVENT_ID": 840020021,
"EVENT_NAME": "Retail Sales excl. Autos and Gas m/m",
"EVENT_DIGITS": 1,
"EVENT_IMPORTANCE": "CALENDAR_IMPORTANCE_LOW",
"EVENT_SOURCE_URL": "https://census.gov",
"EVENT_UNIT": "CALENDAR_UNIT_PERCENT",
"CURRENCY": "USD",
"ACTUAL_VALUE": 700000,
"FORECAST_VALUE": 300000,
"PREVIOUS_VALUE": 200000
},
{
"EVENT": "---DATA REDACTED FOR BREVITY---"
},
{
"TIME": "2025.09.16 20:00:00",
"EVENT_ID": 840220019,
"EVENT_NAME": "20-Year Bond Auction",
"EVENT_DIGITS": 3,
"EVENT_IMPORTANCE": "CALENDAR_IMPORTANCE_MODERATE",
"EVENT_SOURCE_URL": "https://home.treasury.gov/",
"EVENT_UNIT": "CALENDAR_UNIT_PERCENT",
"CURRENCY": "USD",
"ACTUAL_VALUE": 4613000,
"FORECAST_VALUE": -9223372036854776000,
"PREVIOUS_VALUE": 4876000
}
],
"TOTAL_AVAILABLE": 52,
"RETURNED_COUNT": 19,
"ERROR_ID": 0,
"ERROR_DESCRIPTION": "The operation completed successfully"
}