BizKitHub
DocsAPI ReferenceCurrency/bff/currency/rate-history
getCurrencyAdmin BFF

/bff/currency/rate-history

Daily middle-rate time series for a single currency over the last N days, expressed in the organisation default currency. Each point is resolved through the cross-rate graph, so currencies covered only by Fawaz (e.g., AED, SAR, EGP) work too. Returns one point per business day.

CurrencygetBffCurrencyRate-history

Parameters

2 query

Query parameters

· 2
codestringRequired

ISO 4217 code to chart.

ExampleUSD
daysstringOptional

Window length in calendar days (default 30, max 1825 = 5 years).

Example30

Response schema

1 status code documented

200Success
codestringRequired
ExampleUSD
baseCodestringRequired
ExampleEUR
itemsobject[]Required
Each array item:
datestringRequired

YYYY-MM-DD of the CNB fixing.

Example2026-04-27
ratenumberRequired

Units of base currency per 1 unit of code on this date.

Example24.355
itemCountnumberRequired
Example22

Response example

application/json
{
  "code": "USD",
  "baseCode": "EUR",
  "items": [
    {
      "date": "2026-04-27",
      "rate": 24.355
    }
  ],
  "itemCount": 22
}

Request example

GET /bff/currency/rate-history

get
curl -X GET "https://api.bizkithub.com/bff/currency/rate-history?code=USD&days=30" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key