Year

FreeValueStandardPro

Get equity market holidays and early-close days for a year (vendor year_holidays endpoint — only non-standard days, not every trading day).

• Retrieves equity market holidays for a given year
• Note: Holiday data is available 01/01/2012 through the end of the calendar year that immediately follows the current year
• *On days when the market closes early at 1:00 PM ET; eligible options will trade until 1:15 PM.
• **Some NYSE exchanges will continue late trading until 5:00 PM ET on early close days.

pub fn calendar_year(&self, year: &str) -> CalendarYearBuilder<'_>

Execute with .await → Result<Vec<CalendarDay>, Error>, or decode chunk-by-chunk with .stream(handler).

Example

let rows = tdx.calendar_year("2025").await?;
for t in &rows {
    println!("date={} is_open={} status={}", t.date, t.is_open, t.status);
}

ThetaDataDxClient.calendar_year(year, *, timeout_ms=None) -> list[CalendarDay]

calendar_year_async(...) awaits the same call shape.

Example

rows = tdx.calendar_year("2025")
for t in rows:
    print(t.date, t.is_open, t.status)

calendarYear(year: string, options?: { ... }): Promise<Array<CalendarDay>>

Optional parameters ride in a single trailing options object: timeoutMs?: number.

Example

const rows = await tdx.calendarYear('2025');
for (const t of rows) {
  console.log(t.date, t.isOpen, t.status);
}

std::vector<CalendarDay> calendar_year(
    const std::string& year,
    const EndpointRequestOptions& options = {}) const;

Throws tdx::Error on failure.

Example

auto rows = client.calendar_year("2025");
for (const auto& t : rows) {
    std::cout << t.date << ' ' << t.is_open << ' ' << t.status << "\n";
}

GET http://127.0.0.1:25503/v3/calendar/year

Served by the bundled server binary; responses stream as JSON, CSV, or NDJSON via the format parameter.

Example

curl 'http://127.0.0.1:25503/v3/calendar/year?year=2025'

Parameters

Name	Type	Required	Default	Description
year	string	yes	—	4-digit year (e.g. 2024)
timeout_ms	int	no	—	Per-request deadline in milliseconds. 0 means no deadline.

Response

Rows of CalendarDay:

Field	Type	Description
date	i32	Calendar date as a YYYYMMDD integer. 0 when the server omits the column (single-day endpoints).
is_open	bool	Whether the market trades at all on this date (true for open and early-close days).
open_time	i32	Market open time, milliseconds since midnight ET.
close_time	i32	Market close time, milliseconds since midnight ET.
status	string	Vendor day classification: open, early_close, full_close, or weekend.