curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

Currency rounding API

Round an amount to its currency's minor unit (ISO 4217: 2 decimals for EUR, 0 for JPY, 3 for KWD) and to a country's cash rounding rule, such as 0.05 in Canada.

POST https://api.curatedapi.com/v1/calc/money/round

Rounds an amount of money the way the currency and the country require. First it rounds to the currency's minor unit from ISO 4217, the international list of currency codes: cents for USD and EUR, whole yen for JPY, three decimals for the Kuwaiti dinar. Then, if you give a country, it applies that country's rule for rounding cash totals in countries that have withdrawn their smallest coins, such as 0.05 in Canada, Australia and several euro countries, 0.10 in Israel, a whole krona in Sweden or 10 pesos in Chile. There are 23 countries, and every rule follows the country's law, central bank or government guidance, cited in the references, including the special cases: Finland and Estonia never round a total of 0.01 or 0.02 to zero, Slovakia rounds it up to 0.05, and Chile rounds 5 pesos down. You can also give your own cash step.

Formula

rounded = round(amount × 10^d) ÷ 10^d with d = ISO 4217 minor unit; cash = rounded to the nearest multiple of the step, ties and small totals per the country's rule
  • The amount is rounded to the minor unit first and the cash rule is applied to that, because prices and totals are always in whole minor units before cash rounding.
  • cash_rule says what the country's source requires, including whether rounding is mandatory or up to the shop, and whether card payments are rounded. Switzerland has no legal rule; its official guidance only allows rounding cash totals down, so CH always rounds down to 0.05.
  • Where a country's source does not say which way a total exactly halfway between two steps goes (New Zealand at 0.05, Denmark at 0.25 and 0.75, the Czech Republic at 0.50), it is rounded up with a CASH_TIE_ASSUMED warning unless you set cash_tie.
  • Cash rounding applies to the total to pay in cash, not to each item, and in most of these countries only to cash: card and bank payments are paid to the cent.
  • A negative amount (a cash refund) is rounded like the positive amount and made negative.
  • Codes without a minor unit in ISO 4217 (gold, silver, units of account such as XDR) are refused. Withdrawn codes such as BGN (replaced by the euro on 1 January 2026) are not accepted.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
amount required decimal (string) The amount to round. Allowed: >= -1000000000000000 and <= 1000000000000000. Unit: currency.
currency required string ISO 4217 code of the currency, such as USD, EUR, JPY or KWD. It sets the number of decimals (the minor unit): 2 for most currencies, 0 for JPY, 3 for KWD. At most 3 characters.
rounding half_up | half_even | half_down | up | down | ceiling | floor
default half_up
How to round to the currency's minor unit. half_up is the usual commercial rule (and the rule for euro conversions). Options: half_up: to nearest, ties away from zero (2.5 → 3, -2.5 → -3); half_even: to nearest, ties to even (2.5 → 2, 3.5 → 4): banker's rounding; half_down: to nearest, ties towards zero (2.5 → 2); up: away from zero (2.1 → 3, -2.1 → -3); down: towards zero, i.e. truncate (2.9 → 2); ceiling: towards +∞ (2.1 → 3, -2.1 → -2); floor: towards −∞ (2.9 → 2, -2.1 → -3)
cash_country string Optional ISO 3166 two-letter country code, to also round the total for a cash payment by that country's rule. The currency must be the country's. Countries: AU (AUD), BE (EUR), BS (BSD), CA (CAD), CH (CHF), CL (CLP), CZ (CZK), DK (DKK), EE (EUR), FI (EUR), HU (HUF), IE (EUR), IL (ILS), IT (EUR), JM (JMD), LT (EUR), MY (MYR), NL (EUR), NO (NOK), NZ (NZD), SE (SEK), SK (EUR), TT (TTD). At most 2 characters.
cash_step decimal (string) Optional cash step of your own, such as 0.05 or 0.10, instead of cash_country. It must be a whole number of minor units. Allowed: > 0 and <= 1000000.
cash_tie up | down Which way a cash total exactly halfway between two steps goes. The default is the country's rule; when the rule does not say (or with cash_step), up is used and a CASH_TIE_ASSUMED warning says so. Options: up: a total exactly halfway between two steps rounds away from zero; down: a total exactly halfway between two steps rounds towards zero

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
roundedstringThe amount in the currency's minor unit, with every decimal shown (10.50, 1050 for JPY, 1.235 for KWD).
minor_unitsstringThe rounded amount as a whole number of minor units (1050 for 10.50 EUR), as a string so it stays exact. Most payment APIs take amounts in this form, though a few use other minor units than ISO 4217 for some currencies, so check yours.
decimalsintegerThe currency's ISO 4217 minor unit.
currency_namestringThe currency's English name.
differencestringrounded − amount, exactly.
cash_amountstringThe total to pay in cash after the cash rounding rule.
cash_differencestringcash_amount − rounded, exactly.
cash_stepstringThe cash rounding step used.
cash_rulestringThe cash rounding rule that was applied, in words.
cash_sourcestringLink to the law, central bank or government page the country's rule comes from.

Examples

Japanese yen have no decimals

Requestcurl
curl https://api.curatedapi.com/v1/calc/money/round \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1234.5",
    "currency": "JPY"
  }'
200 OKResponse
{
  "calculator": "money/round@1",
  "result": {
    "rounded": "1235",
    "minor_units": "1235",
    "decimals": 0,
    "currency_name": "Japanese yen",
    "difference": "0.5"
  },
  "exactness": {},
  "precision": null,
  "inputs": {
    "amount": "1234.5",
    "currency": "JPY",
    "rounding": "half_up"
  },
  "formula": "rounded = round(amount × 10^d) ÷ 10^d with d = ISO 4217 minor unit; cash = rounded to the nearest multiple of the step, ties and small totals per the country's rule",
  "references": [
    {
      "title": "ISO 4217 List One, current currencies and funds (SIX, the maintenance agency)",
      "url": "https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html"
    },
    {
      "title": "ISO 4217 amendment 180: Bulgaria adopts the euro (1 January 2026)",
      "url": "https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/amendments/dl-currency-iso-amendment-180.pdf"
    },
    {
      "title": "ACCC: Rounding and EFTPOS transactions (11 December 2000), quoting the 1991 guideline",
      "url": "https://www.accc.gov.au/media-release/rounding-and-eftpos-transactions"
    },
    {
      "title": "SPF Economie: L'arrondi obligatoire souffle ses 4 bougies (30 November 2023)",
      "url": "https://news.economie.fgov.be/232412-l-arrondi-obligatoire-souffle-ses-4-bougies/"
    },
    {
      "title": "Central Bank of The Bahamas: Penny facts, FAQs on the elimination of the one cent coin",
      "url": "https://www.centralbankbahamas.com/viewPDF/documents/2020-01-03-01-37-53-Penny-Facts.pdf"
    },
    {
      "title": "Canada Revenue Agency: GST/HST Info Sheet GI-131, Phasing Out of the Penny (December 2012)",
      "url": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html"
    },
    {
      "title": "SECO: FAQ zur Preisbekanntgabe (prices ending in 9 centimes; rounding down cash totals)",
      "url": "https://www.seco.admin.ch/de/faq-pbv"
    },
    {
      "title": "SUSESO: Ley 20.956, artículo 13 (rounding of cash payments)",
      "url": "https://www.suseso.gob.cl/612/w3-propertyvalue-633249.html"
    },
    {
      "title": "Czech National Bank: Jak postupovat při zaokrouhlování po ukončení platnosti 50haléřových mincí (Act 634/1992, section 3)",
      "url": "https://www.cnb.cz/cs/casto-kladene-dotazy/Jak-postupovat-pri-zaokrouhlovani-po-ukonceni-platnosti-50halerovych-minci"
    },
    {
      "title": "Bekendtgørelse nr. 928 af 2008 om afskaffelse af 25-øren som gyldigt betalingsmiddel, section 2",
      "url": "https://www.retsinformation.dk/eli/lta/2008/928/pdf"
    },
    {
      "title": "Eesti Pank and Ministry of Finance: The rounding rule (booklet, 2024)",
      "url": "https://haldus.eestipank.ee/sites/default/files/2024-10/ymardamisreegel_buklet_eng_011024.pdf"
    },
    {
      "title": "Laki euromääräisten maksujen pyöristämisestä 890/2000, sections 1 and 2",
      "url": "https://data.finlex.fi/api/assets/extra/statute-book-of-finland-pdf/fin/2000/20000124.pdf"
    },
    {
      "title": "2008. évi III. törvény az 1 és 2 forintos címletű érmék bevonása következtében szükséges kerekítés szabályairól, sections 1 to 3",
      "url": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00"
    },
    {
      "title": "Central Bank of Ireland: Rounding",
      "url": "https://www.centralbank.ie/consumer-hub/rounding"
    },
    {
      "title": "Bank of Israel: Abolition of the 5 agorot coin (in Hebrew, updated 1 May 2024)",
      "url": "https://boi.org.il/information/my-cash-banknotes/%D7%91%D7%99%D7%98%D7%95%D7%9C-%D7%9E%D7%98%D7%91%D7%A2-5-%D7%90%D7%92%D7%95%D7%A8%D7%95%D7%AA/"
    },
    {
      "title": "Decreto-legge 24 aprile 2017, n. 50, article 13-quater (coordinated text)",
      "url": "https://www.mefop.it/cms/doc/20300/dl-24-aprile-2017-50.pdf"
    },
    {
      "title": "Bank of Jamaica: Guidance on the demonetization of coins",
      "url": "https://boj.org.jm/uploads/news/guidance_demonetization_of_coins_ad_observer_copy.pdf"
    },
    {
      "title": "Lietuvos bankas: Apvalinimas (rounding of cash payments)",
      "url": "https://www.lb.lt/lt/apvalinimas"
    },
    {
      "title": "Bank Negara Malaysia: Introduction of a rounding mechanism for over-the-counter payments",
      "url": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments"
    },
    {
      "title": "Rijksoverheid: Mogen winkeliers betalingen afronden op 0 eurocent of 5 eurocent?",
      "url": "https://www.rijksoverheid.nl/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
    },
    {
      "title": "Norges Bank: Rundskriv 1/2011, Forskrift om tilbaketrekking av 50-øremynt som gyldig betalingsmiddel, section 2",
      "url": "https://www.norges-bank.no/aktuelt/nyheter/Rundskriv/2011/1-Forskrift-om-tilbaketrekking-av-50-oremynt-som-gyldig-betalingsmiddel/"
    },
    {
      "title": "New Zealand Government Consumer Protection: Cash and EFTPOS",
      "url": "https://www.consumerprotection.govt.nz/general-help/ways-to-buy-and-pay/cash-and-eftpos"
    },
    {
      "title": "Lag (1970:1029) om avrundning av öresbelopp, sections 1 and 2",
      "url": "https://data.riksdagen.se/dokument/sfs-1970-1029.html"
    },
    {
      "title": "Zákon č. 18/1996 Z. z. o cenách, section 3(4), in force from 1 January 2026",
      "url": "https://static.slov-lex.sk/pdf/SK/ZZ/1996/18/ZZ_1996_18_20260101.pdf"
    },
    {
      "title": "Central Bank (Withdrawal, Redemption and Demonetisation of One Cent Coins) Regulations, 2018, Legal Notice No. 35",
      "url": "https://www.central-bank.org.tt/wp-content/uploads/pdf/Legal-Notice-No.-35-of-2018.pdf"
    }
  ],
  "warnings": []
}

Kuwaiti dinar have 3 decimals

Requestcurl
curl https://api.curatedapi.com/v1/calc/money/round \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1.2345",
    "currency": "KWD"
  }'
200 OKResponse
{
  "calculator": "money/round@1",
  "result": {
    "rounded": "1.235",
    "minor_units": "1235",
    "decimals": 3,
    "currency_name": "Kuwaiti dinar",
    "difference": "0.0005"
  },
  "exactness": {},
  "precision": null,
  "inputs": {
    "amount": "1.2345",
    "currency": "KWD",
    "rounding": "half_up"
  },
  "formula": "rounded = round(amount × 10^d) ÷ 10^d with d = ISO 4217 minor unit; cash = rounded to the nearest multiple of the step, ties and small totals per the country's rule",
  "references": [
    {
      "title": "ISO 4217 List One, current currencies and funds (SIX, the maintenance agency)",
      "url": "https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html"
    },
    {
      "title": "ISO 4217 amendment 180: Bulgaria adopts the euro (1 January 2026)",
      "url": "https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/amendments/dl-currency-iso-amendment-180.pdf"
    },
    {
      "title": "ACCC: Rounding and EFTPOS transactions (11 December 2000), quoting the 1991 guideline",
      "url": "https://www.accc.gov.au/media-release/rounding-and-eftpos-transactions"
    },
    {
      "title": "SPF Economie: L'arrondi obligatoire souffle ses 4 bougies (30 November 2023)",
      "url": "https://news.economie.fgov.be/232412-l-arrondi-obligatoire-souffle-ses-4-bougies/"
    },
    {
      "title": "Central Bank of The Bahamas: Penny facts, FAQs on the elimination of the one cent coin",
      "url": "https://www.centralbankbahamas.com/viewPDF/documents/2020-01-03-01-37-53-Penny-Facts.pdf"
    },
    {
      "title": "Canada Revenue Agency: GST/HST Info Sheet GI-131, Phasing Out of the Penny (December 2012)",
      "url": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html"
    },
    {
      "title": "SECO: FAQ zur Preisbekanntgabe (prices ending in 9 centimes; rounding down cash totals)",
      "url": "https://www.seco.admin.ch/de/faq-pbv"
    },
    {
      "title": "SUSESO: Ley 20.956, artículo 13 (rounding of cash payments)",
      "url": "https://www.suseso.gob.cl/612/w3-propertyvalue-633249.html"
    },
    {
      "title": "Czech National Bank: Jak postupovat při zaokrouhlování po ukončení platnosti 50haléřových mincí (Act 634/1992, section 3)",
      "url": "https://www.cnb.cz/cs/casto-kladene-dotazy/Jak-postupovat-pri-zaokrouhlovani-po-ukonceni-platnosti-50halerovych-minci"
    },
    {
      "title": "Bekendtgørelse nr. 928 af 2008 om afskaffelse af 25-øren som gyldigt betalingsmiddel, section 2",
      "url": "https://www.retsinformation.dk/eli/lta/2008/928/pdf"
    },
    {
      "title": "Eesti Pank and Ministry of Finance: The rounding rule (booklet, 2024)",
      "url": "https://haldus.eestipank.ee/sites/default/files/2024-10/ymardamisreegel_buklet_eng_011024.pdf"
    },
    {
      "title": "Laki euromääräisten maksujen pyöristämisestä 890/2000, sections 1 and 2",
      "url": "https://data.finlex.fi/api/assets/extra/statute-book-of-finland-pdf/fin/2000/20000124.pdf"
    },
    {
      "title": "2008. évi III. törvény az 1 és 2 forintos címletű érmék bevonása következtében szükséges kerekítés szabályairól, sections 1 to 3",
      "url": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00"
    },
    {
      "title": "Central Bank of Ireland: Rounding",
      "url": "https://www.centralbank.ie/consumer-hub/rounding"
    },
    {
      "title": "Bank of Israel: Abolition of the 5 agorot coin (in Hebrew, updated 1 May 2024)",
      "url": "https://boi.org.il/information/my-cash-banknotes/%D7%91%D7%99%D7%98%D7%95%D7%9C-%D7%9E%D7%98%D7%91%D7%A2-5-%D7%90%D7%92%D7%95%D7%A8%D7%95%D7%AA/"
    },
    {
      "title": "Decreto-legge 24 aprile 2017, n. 50, article 13-quater (coordinated text)",
      "url": "https://www.mefop.it/cms/doc/20300/dl-24-aprile-2017-50.pdf"
    },
    {
      "title": "Bank of Jamaica: Guidance on the demonetization of coins",
      "url": "https://boj.org.jm/uploads/news/guidance_demonetization_of_coins_ad_observer_copy.pdf"
    },
    {
      "title": "Lietuvos bankas: Apvalinimas (rounding of cash payments)",
      "url": "https://www.lb.lt/lt/apvalinimas"
    },
    {
      "title": "Bank Negara Malaysia: Introduction of a rounding mechanism for over-the-counter payments",
      "url": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments"
    },
    {
      "title": "Rijksoverheid: Mogen winkeliers betalingen afronden op 0 eurocent of 5 eurocent?",
      "url": "https://www.rijksoverheid.nl/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
    },
    {
      "title": "Norges Bank: Rundskriv 1/2011, Forskrift om tilbaketrekking av 50-øremynt som gyldig betalingsmiddel, section 2",
      "url": "https://www.norges-bank.no/aktuelt/nyheter/Rundskriv/2011/1-Forskrift-om-tilbaketrekking-av-50-oremynt-som-gyldig-betalingsmiddel/"
    },
    {
      "title": "New Zealand Government Consumer Protection: Cash and EFTPOS",
      "url": "https://www.consumerprotection.govt.nz/general-help/ways-to-buy-and-pay/cash-and-eftpos"
    },
    {
      "title": "Lag (1970:1029) om avrundning av öresbelopp, sections 1 and 2",
      "url": "https://data.riksdagen.se/dokument/sfs-1970-1029.html"
    },
    {
      "title": "Zákon č. 18/1996 Z. z. o cenách, section 3(4), in force from 1 January 2026",
      "url": "https://static.slov-lex.sk/pdf/SK/ZZ/1996/18/ZZ_1996_18_20260101.pdf"
    },
    {
      "title": "Central Bank (Withdrawal, Redemption and Demonetisation of One Cent Coins) Regulations, 2018, Legal Notice No. 35",
      "url": "https://www.central-bank.org.tt/wp-content/uploads/pdf/Legal-Notice-No.-35-of-2018.pdf"
    }
  ],
  "warnings": []
}

Dutch cash rounding: 23.37 EUR is paid as 23.35

Requestcurl
curl https://api.curatedapi.com/v1/calc/money/round \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "23.37",
    "currency": "EUR",
    "cash_country": "NL"
  }'
200 OKResponse
{
  "calculator": "money/round@1",
  "result": {
    "rounded": "23.37",
    "minor_units": "2337",
    "decimals": 2,
    "currency_name": "Euro",
    "difference": "0",
    "cash_amount": "23.35",
    "cash_difference": "-0.02",
    "cash_step": "0.05",
    "cash_rule": "Netherlands: shops may round cash totals to the nearest 0.05 EUR (23.37 to 23.35, 8.89 to 8.90) if a sticker says so; card payments are not rounded.",
    "cash_source": "https://www.rijksoverheid.nl/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
  },
  "exactness": {},
  "precision": null,
  "inputs": {
    "amount": "23.37",
    "currency": "EUR",
    "rounding": "half_up",
    "cash_country": "NL"
  },
  "formula": "rounded = round(amount × 10^d) ÷ 10^d with d = ISO 4217 minor unit; cash = rounded to the nearest multiple of the step, ties and small totals per the country's rule",
  "references": [
    {
      "title": "ISO 4217 List One, current currencies and funds (SIX, the maintenance agency)",
      "url": "https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html"
    },
    {
      "title": "ISO 4217 amendment 180: Bulgaria adopts the euro (1 January 2026)",
      "url": "https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/amendments/dl-currency-iso-amendment-180.pdf"
    },
    {
      "title": "ACCC: Rounding and EFTPOS transactions (11 December 2000), quoting the 1991 guideline",
      "url": "https://www.accc.gov.au/media-release/rounding-and-eftpos-transactions"
    },
    {
      "title": "SPF Economie: L'arrondi obligatoire souffle ses 4 bougies (30 November 2023)",
      "url": "https://news.economie.fgov.be/232412-l-arrondi-obligatoire-souffle-ses-4-bougies/"
    },
    {
      "title": "Central Bank of The Bahamas: Penny facts, FAQs on the elimination of the one cent coin",
      "url": "https://www.centralbankbahamas.com/viewPDF/documents/2020-01-03-01-37-53-Penny-Facts.pdf"
    },
    {
      "title": "Canada Revenue Agency: GST/HST Info Sheet GI-131, Phasing Out of the Penny (December 2012)",
      "url": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html"
    },
    {
      "title": "SECO: FAQ zur Preisbekanntgabe (prices ending in 9 centimes; rounding down cash totals)",
      "url": "https://www.seco.admin.ch/de/faq-pbv"
    },
    {
      "title": "SUSESO: Ley 20.956, artículo 13 (rounding of cash payments)",
      "url": "https://www.suseso.gob.cl/612/w3-propertyvalue-633249.html"
    },
    {
      "title": "Czech National Bank: Jak postupovat při zaokrouhlování po ukončení platnosti 50haléřových mincí (Act 634/1992, section 3)",
      "url": "https://www.cnb.cz/cs/casto-kladene-dotazy/Jak-postupovat-pri-zaokrouhlovani-po-ukonceni-platnosti-50halerovych-minci"
    },
    {
      "title": "Bekendtgørelse nr. 928 af 2008 om afskaffelse af 25-øren som gyldigt betalingsmiddel, section 2",
      "url": "https://www.retsinformation.dk/eli/lta/2008/928/pdf"
    },
    {
      "title": "Eesti Pank and Ministry of Finance: The rounding rule (booklet, 2024)",
      "url": "https://haldus.eestipank.ee/sites/default/files/2024-10/ymardamisreegel_buklet_eng_011024.pdf"
    },
    {
      "title": "Laki euromääräisten maksujen pyöristämisestä 890/2000, sections 1 and 2",
      "url": "https://data.finlex.fi/api/assets/extra/statute-book-of-finland-pdf/fin/2000/20000124.pdf"
    },
    {
      "title": "2008. évi III. törvény az 1 és 2 forintos címletű érmék bevonása következtében szükséges kerekítés szabályairól, sections 1 to 3",
      "url": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00"
    },
    {
      "title": "Central Bank of Ireland: Rounding",
      "url": "https://www.centralbank.ie/consumer-hub/rounding"
    },
    {
      "title": "Bank of Israel: Abolition of the 5 agorot coin (in Hebrew, updated 1 May 2024)",
      "url": "https://boi.org.il/information/my-cash-banknotes/%D7%91%D7%99%D7%98%D7%95%D7%9C-%D7%9E%D7%98%D7%91%D7%A2-5-%D7%90%D7%92%D7%95%D7%A8%D7%95%D7%AA/"
    },
    {
      "title": "Decreto-legge 24 aprile 2017, n. 50, article 13-quater (coordinated text)",
      "url": "https://www.mefop.it/cms/doc/20300/dl-24-aprile-2017-50.pdf"
    },
    {
      "title": "Bank of Jamaica: Guidance on the demonetization of coins",
      "url": "https://boj.org.jm/uploads/news/guidance_demonetization_of_coins_ad_observer_copy.pdf"
    },
    {
      "title": "Lietuvos bankas: Apvalinimas (rounding of cash payments)",
      "url": "https://www.lb.lt/lt/apvalinimas"
    },
    {
      "title": "Bank Negara Malaysia: Introduction of a rounding mechanism for over-the-counter payments",
      "url": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments"
    },
    {
      "title": "Rijksoverheid: Mogen winkeliers betalingen afronden op 0 eurocent of 5 eurocent?",
      "url": "https://www.rijksoverheid.nl/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
    },
    {
      "title": "Norges Bank: Rundskriv 1/2011, Forskrift om tilbaketrekking av 50-øremynt som gyldig betalingsmiddel, section 2",
      "url": "https://www.norges-bank.no/aktuelt/nyheter/Rundskriv/2011/1-Forskrift-om-tilbaketrekking-av-50-oremynt-som-gyldig-betalingsmiddel/"
    },
    {
      "title": "New Zealand Government Consumer Protection: Cash and EFTPOS",
      "url": "https://www.consumerprotection.govt.nz/general-help/ways-to-buy-and-pay/cash-and-eftpos"
    },
    {
      "title": "Lag (1970:1029) om avrundning av öresbelopp, sections 1 and 2",
      "url": "https://data.riksdagen.se/dokument/sfs-1970-1029.html"
    },
    {
      "title": "Zákon č. 18/1996 Z. z. o cenách, section 3(4), in force from 1 January 2026",
      "url": "https://static.slov-lex.sk/pdf/SK/ZZ/1996/18/ZZ_1996_18_20260101.pdf"
    },
    {
      "title": "Central Bank (Withdrawal, Redemption and Demonetisation of One Cent Coins) Regulations, 2018, Legal Notice No. 35",
      "url": "https://www.central-bank.org.tt/wp-content/uploads/pdf/Legal-Notice-No.-35-of-2018.pdf"
    }
  ],
  "warnings": []
}

Your own cash step of 0.10

Requestcurl
curl https://api.curatedapi.com/v1/calc/money/round \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "4.17",
    "currency": "USD",
    "cash_step": "0.10"
  }'
200 OKResponse
{
  "calculator": "money/round@1",
  "result": {
    "rounded": "4.17",
    "minor_units": "417",
    "decimals": 2,
    "currency_name": "United States dollar",
    "difference": "0",
    "cash_amount": "4.20",
    "cash_difference": "0.03",
    "cash_step": "0.10",
    "cash_rule": "Nearest multiple of 0.10 USD."
  },
  "exactness": {},
  "precision": null,
  "inputs": {
    "amount": "4.17",
    "currency": "USD",
    "rounding": "half_up",
    "cash_step": "0.1"
  },
  "formula": "rounded = round(amount × 10^d) ÷ 10^d with d = ISO 4217 minor unit; cash = rounded to the nearest multiple of the step, ties and small totals per the country's rule",
  "references": [
    {
      "title": "ISO 4217 List One, current currencies and funds (SIX, the maintenance agency)",
      "url": "https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html"
    },
    {
      "title": "ISO 4217 amendment 180: Bulgaria adopts the euro (1 January 2026)",
      "url": "https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/amendments/dl-currency-iso-amendment-180.pdf"
    },
    {
      "title": "ACCC: Rounding and EFTPOS transactions (11 December 2000), quoting the 1991 guideline",
      "url": "https://www.accc.gov.au/media-release/rounding-and-eftpos-transactions"
    },
    {
      "title": "SPF Economie: L'arrondi obligatoire souffle ses 4 bougies (30 November 2023)",
      "url": "https://news.economie.fgov.be/232412-l-arrondi-obligatoire-souffle-ses-4-bougies/"
    },
    {
      "title": "Central Bank of The Bahamas: Penny facts, FAQs on the elimination of the one cent coin",
      "url": "https://www.centralbankbahamas.com/viewPDF/documents/2020-01-03-01-37-53-Penny-Facts.pdf"
    },
    {
      "title": "Canada Revenue Agency: GST/HST Info Sheet GI-131, Phasing Out of the Penny (December 2012)",
      "url": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html"
    },
    {
      "title": "SECO: FAQ zur Preisbekanntgabe (prices ending in 9 centimes; rounding down cash totals)",
      "url": "https://www.seco.admin.ch/de/faq-pbv"
    },
    {
      "title": "SUSESO: Ley 20.956, artículo 13 (rounding of cash payments)",
      "url": "https://www.suseso.gob.cl/612/w3-propertyvalue-633249.html"
    },
    {
      "title": "Czech National Bank: Jak postupovat při zaokrouhlování po ukončení platnosti 50haléřových mincí (Act 634/1992, section 3)",
      "url": "https://www.cnb.cz/cs/casto-kladene-dotazy/Jak-postupovat-pri-zaokrouhlovani-po-ukonceni-platnosti-50halerovych-minci"
    },
    {
      "title": "Bekendtgørelse nr. 928 af 2008 om afskaffelse af 25-øren som gyldigt betalingsmiddel, section 2",
      "url": "https://www.retsinformation.dk/eli/lta/2008/928/pdf"
    },
    {
      "title": "Eesti Pank and Ministry of Finance: The rounding rule (booklet, 2024)",
      "url": "https://haldus.eestipank.ee/sites/default/files/2024-10/ymardamisreegel_buklet_eng_011024.pdf"
    },
    {
      "title": "Laki euromääräisten maksujen pyöristämisestä 890/2000, sections 1 and 2",
      "url": "https://data.finlex.fi/api/assets/extra/statute-book-of-finland-pdf/fin/2000/20000124.pdf"
    },
    {
      "title": "2008. évi III. törvény az 1 és 2 forintos címletű érmék bevonása következtében szükséges kerekítés szabályairól, sections 1 to 3",
      "url": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00"
    },
    {
      "title": "Central Bank of Ireland: Rounding",
      "url": "https://www.centralbank.ie/consumer-hub/rounding"
    },
    {
      "title": "Bank of Israel: Abolition of the 5 agorot coin (in Hebrew, updated 1 May 2024)",
      "url": "https://boi.org.il/information/my-cash-banknotes/%D7%91%D7%99%D7%98%D7%95%D7%9C-%D7%9E%D7%98%D7%91%D7%A2-5-%D7%90%D7%92%D7%95%D7%A8%D7%95%D7%AA/"
    },
    {
      "title": "Decreto-legge 24 aprile 2017, n. 50, article 13-quater (coordinated text)",
      "url": "https://www.mefop.it/cms/doc/20300/dl-24-aprile-2017-50.pdf"
    },
    {
      "title": "Bank of Jamaica: Guidance on the demonetization of coins",
      "url": "https://boj.org.jm/uploads/news/guidance_demonetization_of_coins_ad_observer_copy.pdf"
    },
    {
      "title": "Lietuvos bankas: Apvalinimas (rounding of cash payments)",
      "url": "https://www.lb.lt/lt/apvalinimas"
    },
    {
      "title": "Bank Negara Malaysia: Introduction of a rounding mechanism for over-the-counter payments",
      "url": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments"
    },
    {
      "title": "Rijksoverheid: Mogen winkeliers betalingen afronden op 0 eurocent of 5 eurocent?",
      "url": "https://www.rijksoverheid.nl/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
    },
    {
      "title": "Norges Bank: Rundskriv 1/2011, Forskrift om tilbaketrekking av 50-øremynt som gyldig betalingsmiddel, section 2",
      "url": "https://www.norges-bank.no/aktuelt/nyheter/Rundskriv/2011/1-Forskrift-om-tilbaketrekking-av-50-oremynt-som-gyldig-betalingsmiddel/"
    },
    {
      "title": "New Zealand Government Consumer Protection: Cash and EFTPOS",
      "url": "https://www.consumerprotection.govt.nz/general-help/ways-to-buy-and-pay/cash-and-eftpos"
    },
    {
      "title": "Lag (1970:1029) om avrundning av öresbelopp, sections 1 and 2",
      "url": "https://data.riksdagen.se/dokument/sfs-1970-1029.html"
    },
    {
      "title": "Zákon č. 18/1996 Z. z. o cenách, section 3(4), in force from 1 January 2026",
      "url": "https://static.slov-lex.sk/pdf/SK/ZZ/1996/18/ZZ_1996_18_20260101.pdf"
    },
    {
      "title": "Central Bank (Withdrawal, Redemption and Demonetisation of One Cent Coins) Regulations, 2018, Legal Notice No. 35",
      "url": "https://www.central-bank.org.tt/wp-content/uploads/pdf/Legal-Notice-No.-35-of-2018.pdf"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.