Logo
    User Avatar

    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"
    }