Financial Calendar API

Description

The SSE calendar covers the Shanghai Stock Exchange equity market in mainland China. It reflects official Chinese public holidays as published in the HKEX Stock Connect Trading Calendar (Shanghai row). China's Golden Week holidays (Chinese New Year and National Day) create multi-day trading closures that significantly affect settlement schedules. The SZSE calendar shares the same schedule.

What this calendar is useful for

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

Holiday Dates

Official SSE 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=SSE.

API Examples

Day status — National Day 2025

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

Is holiday check

GET /v1/is_holiday?calendar=SSE&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=SSE&date=2025-09-30

Previous business day

GET /v1/previous_business_day?calendar=SSE&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=SSE&date=2026-04-03&tplus=1

Spreadsheet & Integration Examples

🧮 Excel Formula

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

💻 VBA Macro

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

📊 Google Sheets

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

🐍 Python

import requests

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

🖥️ cURL

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

Notes & Limitations

The SSE and SZSE calendars share the same schedule — querying either returns identical results.
No early-close data is published for the SSE. 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 Shanghai Stock Exchange for mission-critical applications.