Money and currencies

All monetary amounts in the Quarzo API are represented as integers in the smallest currency unit — cents for EUR, pence for GBP, and so on. There are no decimals, no floating-point numbers.

{
  "amount": 10050,
  "currency": "EUR"
}

This represents €100.50, not 10 050 euros.

Why integers

Floating-point arithmetic is notoriously unreliable for financial calculations. 0.1 + 0.2 does not equal 0.3 in most programming environments. Storing amounts as integers eliminates rounding errors entirely.

Formatting for display

Never display raw integer amounts to your users. Always divide by the correct exponent for the currency before rendering.

// EUR, GBP, USD — exponent 2 (cents)
function formatAmount(amount, currency) {
  return new Intl.NumberFormat('fr-FR', {
    style: 'currency',
    currency,
  }).format(amount / 100)
}

formatAmount(10050, 'EUR') // → "100,50 €"
formatAmount(599,   'EUR') // → "5,99 €"

Money libraries

Rather than managing integer arithmetic yourself, consider using a dedicated money library for your language. These libraries handle subunit conversion, currency-aware formatting, and safe arithmetic out of the box.

You can find some proposed libraries below. These are provided for guidance only and should not be considered recommendations.

Language	Library
JavaScript / TypeScript	dinero.js, Moneta
Python	py-moneyed
Ruby	money
PHP	moneyphp/money
Java / Kotlin	JavaMoney (JSR 354)
Go	bojanz/currency

Supported currencies

All amounts must be paired with an explicit currency field using the ISO 4217 three-letter code.

Currency others than EUR could be used to show information about underlying assets of Unit Linked funds.

Currency	Code	Smallest unit
Euro	EUR	Cent (÷ 100)
Pound sterling	GBP	Penny (÷ 100)
Swiss franc	CHF	Rappen (÷ 100)
US dollar	USD	Cent (÷ 100)

Zero-decimal currencies

Some currencies — like JPY — have no subunit. For these, pass the amount as-is: { "amount": 1200, "currency": "JPY" } represents ¥1,200.

Common mistakes

Do not pass floats. The API will reject non-integer values.

// ❌ Invalid
{ "amount": 100.50, "currency": "EUR" }

// ✅ Correct
{ "amount": 10050, "currency": "EUR" }

Do not omit currency. Every amount field must be accompanied by a currency code. Requests missing currency will return a 422 Unprocessable Entity error.