Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Bankday Fx API
version: 1.0.0
description: Business days, holidays and settlement dates for payment rails, exchanges and countries.
contact:
url: https://bankday.dev
servers:
- url: https://bankday.dev
security:
- bearer: []
tags:
- name: FX
paths:
/v1/fx/spot:
get:
operationId: fx
summary: FX spot value date
description: Spot date for a currency pair traded on trade_date. T+2 by default, T+1 for USD/CAD, USD/TRY, USD/RUB, USD/PHP and USD/KZT. The intermediate day only needs to be a business day for the non-USD currency; the spot date must be a business day for both currencies and, for crosses such as EURGBP, also a USD business day. Currencies map to settlement calendars (USD → us-fed, EUR → eu-target2, GBP → uk-bacs, others → country).
parameters:
- name: pair
in: query
required: true
description: e.g. EURUSD, EUR/USD
schema:
type: string
- name: trade_date
in: query
required: true
description: YYYY-MM-DD
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
example:
pair: EURUSD
trade_date: '2026-11-25'
spot_lag: 2
spot_date: '2026-11-27'
calendars:
EUR: eu-target2
USD: us-fed
convention: 'T+2 spot: ...'
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'404':
$ref: '#/components/responses/Error'
'422':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
tags:
- FX
components:
responses:
Error:
description: Error
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
securitySchemes:
bearer:
type: http
scheme: bearer