Skip to content

Finance Calendar API

The Finance Calendar API answers one question in many forms: is this a business day, and if not, when is the next one? It covers 1,600+ calendars: stock exchanges, settlement currencies, bond markets, and every country and region in the open-source holidays library. Plans start at US$29 a month, each with a 14-day free trial; see Pricing.

Terminal window
curl -H "Authorization: Bearer $FC_API_KEY" "https://api.financecalendarapi.com/v1/business-days/add?date=2027-12-23&n=2&calendars=USD,XNYS"
{ "date": "2027-12-23", "n": 2, "result": "2027-12-28", "mode": "all", "coverage": "verified", "estimated": false }

T+2 from 23 December 2027, counting only days when both US dollar settlement and the New York Stock Exchange are open, is 28 December.

  • Provenance. Each verified year cites the official sources it was checked against, and we keep a dated copy of every source page. See Provenance.
  • Coverage you can see. Every date says whether it’s verified against an official source or comes from the library, and whether it’s confirmed or provisional. See Coverage and status.
  • A changes feed. Every release lists the dates it added, removed or changed. See Releases and changes.
  • Getting started: your first requests, formats, limits and errors.
  • API reference: every endpoint, with live examples.
  • Guides: Excel, Google Sheets, VBA, Python, JavaScript and calendar apps.
  • Browser tools: try it without writing code.