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. (NEW v1.43.0) with below changes:

• All numbers are non-stringified

(REMOVED v1.43.0) 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": 14,
  "d": {
    "id": 2692,
    "name": "cal3",
    "timeZone": "+05:30",
    "marketOpen": "09:30",
    "marketClose": "12:37",
    "tradingDays": [
      "MONDAY",
      "TUESDAY",
      "WEDNESDAY",
      "THURSDAY",
      "FRIDAY",
      "SATURDAY",
      "SUNDAY"
    ],
    "holidays": [],
    "auctions": [
      {
        "days": [],
        "startTimes": [],
        "duration": 300000,
        "matchingAlgorithm": "EQUILIBRIUM_PRICE",
        "allowedTimeInForces": [
          "GTC",
          "GTD",
          "GAA",
          "DAY"
        ],
        "eventsModes": [
          "LIT",
          "INDICATIVE_PRICE"
        ],
        "trigger": "Resume",
        "overrideReferencePrice": false
      },
      {
        "days": [],
        "startTimes": [],
        "duration": 900000,
        "matchingAlgorithm": "EQUILIBRIUM_PRICE",
        "allowedTimeInForces": [
          "GTC",
          "GTD",
          "GAA",
          "DAY"
        ],
        "eventsModes": [
          "LIT",
          "INDICATIVE_PRICE"
        ],
        "trigger": "AutoResume",
        "overrideReferencePrice": false
      },
      {
        "days": [
          "MONDAY",
          "TUESDAY",
          "WEDNESDAY",
          "THURSDAY",
          "FRIDAY",
          "SATURDAY",
          "SUNDAY"
        ],
        "startTimes": [
          "17:14:00"
        ],
        "duration": 300000,
        "matchingAlgorithm": "EQUILIBRIUM_PRICE",
        "allowedTimeInForces": [
          "GTC",
          "GTD",
          "GAA"
        ],
        "eventsModes": [
          "INDICATIVE_PRICE"
        ],
        "trigger": "TimeBased",
        "overrideReferencePrice": false
      }
    ],
    "lastEodDate": "2025-03-13"
  }
}

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