/v1/today

Current trading and holiday status across all supported calendars.

Last Updated: 2026-05-13

Description

Returns the trading and holiday status for all supported financial calendars — or a single specified calendar — for a given date. When no date is provided the endpoint defaults to today's date in the America/New_York timezone. Useful for daily dashboards, market-status widgets, and any workflow that needs a quick read on which markets are open, closed, or closing early on a given day.

Endpoint

GET https://fincalapi.com/v1/today

Parameters

Name Type Required Description
date string No — defaults to today (America/New_York) Date to check in YYYY-MM-DD format. Omit to use today's date in the America/New_York timezone.
calendar string No — defaults to all calendars A specific calendar code, e.g., NYSE, LSE, SIFMA-US. Omit to return status for all 14 supported calendars.

Default Behavior

With no parameters, /v1/today returns status for all 14 supported calendars using today's date in the America/New_York timezone. Narrow the response to a single calendar with the calendar parameter, or check a specific past or future date with date.

Clickable Examples

Click any link to see live JSON output:

Usage Examples

🐍 Python

import requests

# All calendars for today
response = requests.get("https://fincalapi.com/v1/today")
data = response.json()
for cal in data["calendars"]:
    print(f"{cal['calendar']}: {cal['status']}")

# Single calendar on a specific date
response = requests.get(
    "https://fincalapi.com/v1/today",
    params={"date": "2026-01-01", "calendar": "NYSE"}
)
print(response.json())

🖥️ cURL / Terminal

# All calendars for today
curl "https://fincalapi.com/v1/today"

# Single calendar on a specific date
curl "https://fincalapi.com/v1/today?date=2026-01-01&calendar=NYSE"

Example JSON Response

For /v1/today?date=2025-07-04&calendar=NYSE (Independence Day — full close):

{
  "date": "2025-07-04",
  "calendars": [
    {
      "calendar": "NYSE",
      "date": "2025-07-04",
      "status": "full_close",
      "is_holiday": true,
      "is_weekend": false,
      "is_early_close": false,
      "close_time": null
    }
  ]
}

For /v1/today?date=2025-07-03&calendar=NYSE (early close day):

{
  "date": "2025-07-03",
  "calendars": [
    {
      "calendar": "NYSE",
      "date": "2025-07-03",
      "status": "early_close",
      "is_holiday": false,
      "is_weekend": false,
      "is_early_close": true,
      "close_time": "13:00"
    }
  ]
}

Common Use Cases

Notes & Limitations