FX trading & cross-border payments
FX value dates, right for both currencies
An FX trade settles in two currencies, so its value date has to be a business day for both. Miss a holiday in one of them and the trade fails, the payment is late, or a forward rolls into the wrong month. TradingCalendars gives you the FX market and currency clearing calendar of each currency, and computes value dates on any combination of them.
Who uses it
- FX brokers, banks and liquidity providers
- Cross-border payment and money-transfer companies
- Corporate treasury hedging desks
- Trading and risk platforms with FX workflows
Where value dates go wrong
Checking only one currency
A EUR/USD trade done in Singapore still settles on euro and US dollar days. The value date must be open in both currencies' calendars, whatever the trading centre.
Late-announced and moving holidays
Chinese New Year, Golden Week, Diwali and Eid move every year, and some are confirmed only weeks ahead after a moon sighting. Estimated dates are flagged and updated when the official date is announced.
Weekends assumed to be Saturday and Sunday
The UAE moved its weekend from Friday–Saturday to Saturday–Sunday on 1 January 2022. Weekends are stored per calendar, with their history, so old and new dates both come out right.
Month-end forwards rolling into the next month
A forward maturing on the last business day of the month must stay in that month. The adjust-date endpoint applies modified following and the other ISDA conventions on a joint calendar.
Live example
Spot value dates for a trade done Tue, 17 Nov 2026
| Pair | Spot | Value date | Skipped |
|---|---|---|---|
| EUR/USD | T+2 | Thu, 19 Nov 2026 | Weekends only |
| GBP/USD | T+2 | Thu, 19 Nov 2026 | Weekends only |
| USD/JPY | T+2 | Thu, 19 Nov 2026 | Weekends only |
| USD/SGD | T+2 | Thu, 19 Nov 2026 | Weekends only |
| AUD/USD | T+2 | Thu, 19 Nov 2026 | Weekends only |
| USD/CNH | T+2 | Thu, 19 Nov 2026 | Weekends only |
| USD/CAD | T+1 | Wed, 18 Nov 2026 | Weekends only |
Simplified spot: T+2 (T+1 for USD/CAD) business days open in both currencies' FX calendars, counted from today's trade date (Monday at weekends). Pair-specific market conventions can differ; the API gives you each currency's calendar to apply them.
What you get
FX and clearing calendars
An FX market calendar (.FX) and a currency non-clearing calendar (.CLEAR) for each currency, plus CLS.
Joint calendars in one call
Pass several codes and a date is a business day only when every calendar is open; T+N and conventions included.
Explained answers
Every result lists the days skipped and which holiday in which currency caused each one.
Calendars to start with
Use it your way
The REST API, the open-source Python client, or your AI assistant through the MCP server. Full reference in the documentation.
curl "https://api.tradingcalendars.com/v1/add-business-days?calendars=EUR.FX,USD.FX&date=2026-12-23&days=2" \
-H "Authorization: Bearer YOUR_API_KEY"from tradingcalendars import TradingCalendars
tc = TradingCalendars()
# T+2 spot for EUR/USD traded on 23 Dec
tc.add_business_days(["EUR.FX", "USD.FX"], "2026-12-23", 2) # date(2026, 12, 28)
# Is the 1-month forward date open in both currencies?
tc.is_business_day(["GBP.FX", "USD.FX"], "2027-01-29")Ask your AI assistant (Claude, ChatGPT, Cursor)
“What's the T+2 spot date for USD/JPY traded today, and which days were skipped?”
Questions
The .FX calendar is the currency's FX market calendar, the days the interbank market trades and settles it. The .CLEAR calendar lists the days the currency does not clear through its payment system. Use .FX for FX value dates and .CLEAR for payments in that currency.