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

PairSpotValue dateSkipped
EUR/USDT+2Thu, 19 Nov 2026Weekends only
GBP/USDT+2Thu, 19 Nov 2026Weekends only
USD/JPYT+2Thu, 19 Nov 2026Weekends only
USD/SGDT+2Thu, 19 Nov 2026Weekends only
AUD/USDT+2Thu, 19 Nov 2026Weekends only
USD/CNHT+2Thu, 19 Nov 2026Weekends only
USD/CADT+1Wed, 18 Nov 2026Weekends 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.

REST API
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"
Python (pip install tradingcalendars-client)
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.

Related use cases