/bff/currency/convert

Utility for forms: converts amount from from to to using the cross-rate resolver (CNB / ECB / Fawaz combined; pivots through CZK / EUR / USD when no direct quote exists). Result is rounded to the target currency ISO 4217 decimals.

CurrencypostBffCurrencyConvert

Parameters

JSON body

Request body

application/json

amountnumberRequired

Amount in the source currency.

Example100

fromstringRequired

Source ISO 4217 code.

ExampleEUR

tostringRequired

Target ISO 4217 code.

ExampleCZK

datestringOptional

Conversion date in YYYY-MM-DD. Defaults to today. Falls back to the most recent earlier fixing.

Example2026-04-27

Response schema

1 status code documented

200Success

amountnumberRequired

Converted amount, rounded to target decimals.

Example2435.5

ratenumberRequired

Effective from→to rate.

Example24.355

rateDatestringRequired

YYYY-MM-DD of the oldest fixing in the resolution path (rate is only as fresh as this).

Example2026-04-27

Response example

application/json

{
  "amount": 2435.5,
  "rate": 24.355,
  "rateDate": "2026-04-27"
}

Request example

POST /bff/currency/convert

post

curl -X POST "https://api.bizkithub.com/bff/currency/convert" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "amount": 100,
  "from": "EUR",
  "to": "CZK",
  "date": "2026-04-27"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key