TradingCalendars

com.tradingcalendars/holidays · v1.1.0 · finance-and-payments

TradingCalendars is healthy: it completed an MCP handshake in 1937 ms and exposes 17 tools.

Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges.

Endpoint: https://api.tradingcalendars.com/mcp (streamable-http)

No repository listed · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count17
Latency1937 ms
Last checked (UTC)2026-11-03T14:20:35.427Z

Health history

Checked (UTC)StatusLatencyError
2026-11-03T14:20:35.427ZHealthy1937

Tools (17)

list_calendarsList published holiday calendars available to your plan. Optional calendar_type filters by family (CURRENCY_FX, CURRENCY_NON_CLEARING, FINANCIAL_CENTRE, PAYMENT_SYSTEM, EXCHANGE_TRADING, EXCHANGE_SETTLEMENT).
get_holidaysHolidays for one calendar by code (e.g. USD.FX). start defaults to today; pass an earlier start for historical holidays, end to bound forward dates. Rows carry original_date when a holiday is observed on a shifted date, plus half-day and early-close details.
fx_market_holidaysFX market holidays for a currency (ISO 4217, e.g. USD): days the FX market for that currency does not trade. start defaults to today.
currency_non_clearing_daysCurrency non-clearing days (ISO 4217, e.g. USD): days the currency cannot clear or settle. Use to validate FX value dates. start defaults to today.
bank_holidaysBank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.
payment_system_holidaysPayment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.
trading_holidaysExchange trading holidays for a market (ISO 10383 MIC, e.g. XNYS): days the exchange is closed for trading, including shortened sessions (half_day and early_close_time fields). start defaults to today.
settlement_holidaysExchange settlement holidays for a market (ISO 10383 MIC, e.g. XNYS): days clearing and settlement cannot take place. start defaults to today.
list_currenciesList covered currencies (ISO 4217) with issuing country and issuer.
list_exchangesList covered exchanges (ISO 10383 MIC) with country, city, and timezone.
list_financial_centresList covered financial centres (UN/LOCODE) with country and timezone.
list_payment_systemsList covered payment systems with operator, type, currency, and country.
get_weekendsWeekend definitions and working weekends for one calendar code (e.g. USD.FX). weekend_days is the definition in force today (ISO weekday numbers); weekend_definitions carries the full history.
market_statusLive open/half/closed status for exchanges, evaluated against real trading hours and today's trading holidays in each exchange's timezone. Includes next_open_at and next_close_at timestamps. Pass a MIC (e.g. XNYS) for one market or omit it for all. Requires a plan with exchange trading data (Free, E
is_business_dayIs a date a business day? Answers for one or several calendars at once and says why not (holiday name, weekend) or flags a half day / early close. calendars: one or more calendar codes from list_calendars, e.g. ["USD.FX", "EUR.FX"] for a EUR/USD FX trade, ["XNYS.SETTLE"] for NYSE settlement, ["TARGE
add_business_daysDate that is N business days after (or before, with negative days) a start date: settlement and value dates (T+1 = 1, T+2 = 2), payment due dates, deadlines. days = 0 rolls a non-business start forward to the next business day. Lists every non-business day skipped and why. calendars: one or more cal
business_days_betweenNumber of business days between two dates (start counted, end not counted, like numpy.busday_count), with the non-business days in between and why. calendars: one or more calendar codes from list_calendars, e.g. ["USD.FX", "EUR.FX"] for a EUR/USD FX trade, ["XNYS.SETTLE"] for NYSE settlement, ["TARG