Combining calendars
Most endpoints take several ids in calendars, comma-separated (how many depends on your plan). That’s how you answer settlement questions that
involve more than one market: a USD trade on the NYSE settles on days when both are open.
mode decides what counts as a business day across them:
mode |
A business day when | Use it for |
|---|---|---|
all (default) |
every calendar is open | settlement: T+N across currencies and markets |
any |
at least one calendar is open | “is anything trading today?” |
# T+2 across US dollar settlement and the NYSE: both must be opencurl -H "Authorization: Bearer $FC_API_KEY" "https://api.financecalendarapi.com/v1/business-days/add?date=2027-12-23&n=2&calendars=USD,XNYS&mode=all"/v1/days/{date} answers for each calendar and for the combination, so you can see which one made the day a holiday.