Financial Calendar API

Description

The SZSE calendar covers the Shenzhen Stock Exchange equity market in mainland China. SZSE observes the same national holiday schedule as the Shanghai Stock Exchange (SSE) — querying either calendar returns identical results. China's Golden Week holidays (Chinese New Year and National Day) create multi-day trading closures that significantly affect settlement schedules.

What this calendar is useful for

Checking whether a date is an SZSE non-trading day
Calculating the next or previous SZSE business day
Computing T+N settlement dates for Shenzhen equity markets
Planning around Golden Week closures (Chinese New Year, National Day)
Validating Stock Connect southbound trading windows

Holiday Dates

Official SZSE non-trading days are dynamically retrieved via the API.

For a comprehensive list of upcoming holidays, use the /v1/holidays/range or /v1/next_n_holidays endpoints with calendar=SZSE.

API Examples

Day status — National Day 2025

GET /v1/day_status?calendar=SZSE&date=2025-10-01

Is holiday check

GET /v1/is_holiday?calendar=SZSE&date=2025-10-01

Next business day — skips National Day Golden Week

From Tuesday 30 Sep 2025: skips National Day Golden Week (Oct 1–8) → returns Thursday 9 Oct 2025.

GET /v1/next_business_day?calendar=SZSE&date=2025-09-30

Previous business day

GET /v1/previous_business_day?calendar=SZSE&date=2025-10-09

Settlement date — T+1 skips Ching Ming

T+1 from Friday 3 Apr 2026: skips weekend and Ching Ming (Apr 6) → settles Tuesday 7 Apr 2026.

GET /v1/settlement_date?calendar=SZSE&date=2026-04-03&tplus=1

Spreadsheet & Integration Examples

🧮 Excel Formula

=WEBSERVICE("https://fincalapi.com/v1/holidays/range?calendar=SZSE&months_ahead=12&format=csv")

💻 VBA Macro

Function GetSZSEHolidays() As String
    Dim http As Object
    Set http = CreateObject("MSXML2.XMLHTTP")
    http.Open "GET", "https://fincalapi.com/v1/holidays/range?calendar=SZSE&months_ahead=12&format=json", False
    http.Send
    GetSZSEHolidays = http.responseText
End Function

📊 Google Sheets

=IMPORTDATA("https://fincalapi.com/v1/holidays/range?calendar=SZSE&months_ahead=12&format=csv")

🐍 Python

import requests

resp = requests.get("https://fincalapi.com/v1/day_status", params={"calendar": "SZSE", "date": "2025-10-01"})
print(resp.json())

🖥️ cURL

curl "https://fincalapi.com/v1/day_status?calendar=SZSE&date=2025-10-01"

Notes & Limitations

SZSE and SSE share the same holiday schedule — querying either returns identical results.
No early-close data is published for the SZSE. All non-trading days are full closures.
China's Golden Week closures (Chinese New Year in Jan/Feb and National Day in Oct) can span 7–10 days including weekends.
Data currently covers 2025–2026. The 2027 calendar will be added when published.
Verify via the Shenzhen Stock Exchange for mission-critical applications.