---
title: "GET /api/calendar/value-date"
method: GET
path: "/api/calendar/value-date"
tags: ["Market Calendar"]
---

# GET /api/calendar/value-date

`GET /api/calendar/value-date`

## Request

- Base URL: `https://api.unirateapi.com`
- URL: `https://api.unirateapi.com/api/calendar/value-date`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unirateapi/apis/unirate-api/docs/api/calendar/value-date/get.ts> (a function with typed inputs; its response is checked against the schema)

FX spot value (settlement) date for a currency pair and trade date. Pro subscription required.

Convention: spot is T+2, counted separately on each currency's settlement calendar - a non-USD currency needs 2 clear business days, USD only 1 (a US holiday on T+1 does not delay spot), except against MXN/CLP/ARS/BRL/COP/PEN where USD also needs 2. USD/CAD, USD/TRY, USD/PHP and USD/RUB are T+1. The spot date must be a business day in both currencies and not a US holiday (crosses included), otherwise it rolls forward.

Calendars: EUR = TARGET2 closing days; USD = Federal Reserve holidays (a Saturday holiday is NOT moved to Friday); GBP = England & Wales bank holidays; JPY = Japan public + bank holidays; others = the home country's public holidays and weekend (e.g. Friday-Saturday for SAR).

Limitations: reference only. Not modelled - Middle-East Friday half-sessions, CLS cut-offs, NDF fixing conventions, ad-hoc closures announced after the library release, counterparty-specific agreements. Confirm with your counterparty.

## Query parameters

- `api_key` string, required
- `pair` string, required
- `trade_date` string
- `format` 'json' | 'xml'
- `callback` string

## Response `200`

Spot value date.

## Other responses

- `400`: Invalid pair/trade_date/format
- `401`: Missing or invalid API key
- `403`: Pro subscription required
- `404`: No settlement calendar for one of the currencies (e.g. crypto, metals, XOF/XAF)
- `429`: Daily calendar quota exceeded

---

[API](https://skmtc.dev/unirateapi/apis/unirate-api.md) - [All operations](https://skmtc.dev/unirateapi/apis/unirate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unirateapi/apis/unirate-api/revisions/e5fd92902326?raw)