Getting Started

From zero to your first API call in under 5 minutes.

1

Create a free account

Sign in with your email — no password needed. We'll send you a one-time code.

Sign in →
2

Generate an API key

From the dashboard, click Create Key. Your key is shown once — copy it somewhere safe before leaving the page.

Keys look like: fincal_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3

Make your first request

Pass your key in the Authorization header on every request.

curl -H "Authorization: Bearer fincal_live_YOUR_KEY_HERE" \
  "https://fincalapi.com/v1/day_status?date=2026-06-21&calendar=NYSE"

Expected response:

{
  "date": "2026-06-21",
  "calendar": "NYSE",
  "status": "open",
  "is_holiday": false,
  "is_early_close": false,
  "is_weekend": false,
  "close_time": null
}

What's available

Day status & holidays

Is a market open, closed, or early close on a given date?

/v1/day_status   /v1/is_holiday   /v1/upcoming

Settlement dates

T+N settlement date calculation across market calendars.

/v1/settlement_date   /v1/next_settlement_date

Business day arithmetic

Next and previous business day for any calendar.

/v1/next_business_day   /v1/previous_business_day

14 global calendars

NYSE, NASDAQ, LSE, HKEX, JPX, SSE, SGX, ASX and more.

/v1/calendars

Next steps