Query Trading Calendar

Query the trading calendar for a specific currency pair and deal type within a given date range. Returns a list of available dates when deals can be created or settlements can occur, based on the requested calendar type.
Request Parameters
dealTypestring
required
The type of FX deal to query the trading calendar for. This determines which set of available dates is returned.

Valid Values:

UNFUNDED_SPOT — Unfunded spot deal.
FORWARD — Forward deal.
startDatestring
required
The start date of the query range, in YYYY-MM-DD format (UTC timezone). Must be earlier than or equal to endDate.
endDatestring
required
The end date of the query range, in YYYY-MM-DD format (UTC timezone). Must be later than or equal to startDate.
buyCurrencystring
required
The currency to buy, specified as an ISO 4217 currency code. See Data Types. Must differ from sellCurrency.
sellCurrencystring
required
The currency to sell, specified as an ISO 4217 currency code. See Data Types. Must differ from buyCurrency.
calendarTypestring
The type of calendar to query. If omitted, the default is DEAL_CALENDAR.

Valid Values:

DEAL_CALENDAR — Trading calendar showing dates when deals can be created.
SETTLEMENT_CALENDAR — Settlement calendar showing dates when settlements can occur.
Response Parameters
resultResult
See Result.
availableDatesarray
A list of available trading dates within the queried range. Each element is a date string in YYYY-MM-DD format.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
FX_DEAL_DATE_RANGE_NOT_SUPPORTEDFThe deal date range is not within the supported window.Adjust the date range to fall within the supported trading window for the specified deal type.
Definition
POST /api/open/v1/fx/references/queryCalendar
Request
{
"dealType": "FORWARD",
"startDate": "2026-04-02",
"endDate": "2026-04-30",
"buyCurrency": "USD",
"sellCurrency": "HKD"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"availableDates": [
  "2026-04-03",
  "2026-04-06",
  "2026-04-07",
  "2026-04-08",
  "2026-04-09",
  "2026-04-10",
  "2026-04-13",
  "2026-04-14",
  "2026-04-15",
  "2026-04-16",
  "2026-04-17",
  "2026-04-20",
  "2026-04-21",
  "2026-04-22",
  "2026-04-23",
  "2026-04-24",
  "2026-04-27",
  "2026-04-28",
  "2026-04-29",
  "2026-04-30"
]
}