Calendar List

This API provides snapshot and real-time updates for calendar details.

Upon successful subscription, a snapshot of all calendars is sent. The last message of the snapshot contains lastMessage=Y. Any changes to the calendars after the snapshot are sent as subsequent updates.

In cases where there are no calendars to return, the system will send an empty message.

qualifier: v1/exchange.marketdata/calendarList

Request

No request parameters

Response

Similar to this.

NOTE: All numbers are stringified

Error Codes

Code	Message
1	System is unavailable

Samples

Subscription

{
  "q": "v1/exchange.marketdata/calendarList",
  "token": "eyJleGNoYW5nZUlkIjozMCwicHJvamVjdElkIjoyMDB9",
  "sid": 10,
  "d": {
  }
}

Response

{
  "q": "v1/exchange.marketdata/calendarList",
  "sid": 13,
  "d": {
    "id": "2692",
    "name": "cal3",
    "timeZone": "+05:30",
    "marketOpen": "09:30",
    "marketClose": "16:00",
    "tradingDays": [
      "MONDAY",
      "TUESDAY",
      "WEDNESDAY",
      "THURSDAY",
      "FRIDAY",
      "SATURDAY",
      "SUNDAY"
    ],
    "holidays": [
      {
        "date": "2023-10-20",
        "closeTime": "13:30",
        "name": "Holiday 1"
      },
      {
        "date": "2023-10-25",
        "name": "Holiday 2"
      }
    ],
    "auctions": [
      {
        "days": [],
        "startTimes": [],
        "duration": "300000",
        "matchingAlgorithm": "EQUILIBRIUM_PRICE",
        "allowedTimeInForces": [
          "GTC",
          "GTD",
          "GAA",
          "DAY"
        ],
        "eventsModes": [
          "LIT",
          "INDICATIVE_PRICE"
        ],
        "auctionType": "MANY_TO_MANY",
        "indicativePriceFrequency": "1000",
        "trigger": "Resume",
        "overrideReferencePrice": false
      },
      {
        "days": [],
        "startTimes": [],
        "duration": "900000",
        "matchingAlgorithm": "EQUILIBRIUM_PRICE",
        "allowedTimeInForces": [
          "GTC",
          "GTD",
          "GAA",
          "DAY"
        ],
        "eventsModes": [
          "LIT",
          "INDICATIVE_PRICE"
        ],
        "auctionType": "ONE_TO_MANY",
        "buyMpList": [
          "14"
        ],
        "indicativePriceFrequency": "1000",
        "trigger": "AutoResume",
        "overrideReferencePrice": false
      }
    ]
  }
}

Last message

{
  "q": "v1/exchange.marketdata/calendarList",
  "sid": 13,
  "d": {
    "id": "2692",
    "name": "cal3",
    "timeZone": "+05:30",
    "tradingDays": [
      "MONDAY",
      "TUESDAY",
      "WEDNESDAY",
      "THURSDAY",
      "FRIDAY",
      "SATURDAY",
      "SUNDAY"
    ],
    "holidays": [],
    "auctions": [],
    "lastMessage": "Y"
  }
}

Empty message

{
  "q": "v1/exchange.marketdata/calendarList",
  "sid": 17,
  "d": {
    "lastMessage": "Y"
  }
}