Money

The Quarzo API represents each Money value with two fields:

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

This value represents €100.50.

The API, the webhooks, the SDK and the MCP tools use this format, in requests and in responses.

Fields

Field	Type	Description
amount	string	An integer amount in the minor unit of the currency.
currency	string	An uppercase ISO 4217 currency code that Quarzo supports.

The API sends amount as text so that clients can keep exact values. Do not convert a large amount to a JavaScript number.

Minor unit

The minor unit is the smallest unit of a currency. For EUR, the minor unit is the cent.

The ISO 4217 exponent of the currency gives the number of decimal places. The Money value has no scale field.

Use this rule to read a Money value:

decimal value = amount / 10^exponent

For amount = "10050" and currency = "EUR", the exponent is 2 and the result is 100.50.

Supported currencies

Currency	Exponent	Minor unit	Example	Decimal value
EUR	2	cent	{ "amount": "1000", "currency": "EUR" }	€10.00
USD	2	cent	{ "amount": "1000", "currency": "USD" }	$10.00

The API refuses a currency that is not in this table.

Format of the amount

The amount field is a string that matches this pattern:

^(0|-?[1-9][0-9]*)$

• "0" is zero.
• "1000" is a positive amount.
• "-1000" is a negative amount. Only the fields that permit a negative value contain it.

The amount field does not contain these items:

• a decimal point
• a + sign
• a leading zero
• a space
• an n suffix

Requests

The API accepts only this format. A request field that must be greater than zero refuses "0" and a negative amount.

The API returns 400 with the code parameter_invalid for each of these values:

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

The amount is a JSON number.

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

The amount has a decimal point.

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

The value has a scale field.

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

The value uses the former value field.

Client handling

Keep amount as text until you use an exact integer or decimal library.

Use the exponent of the currency for the decimal placement when you format a value.

Do not use floating-point arithmetic for Money values.

Values that are not Money

A value with more decimal places than its currency is not a Money value. A number of shares is an example: see Shares. The price of one share is a second example: see NAV.