Currency reference

All 166 ISO 4217 fiat codes, named aliases, input markers, fractional digits and live-rate caching.

Main branch reference after R89 · released versions may differ docs/SYNTAX_REFERENCE.md @ 1ebc752

Numlex converts 166 fiat currencies — ISO 4217 codes only, no cryptocurrencies or precious metals. The code itself is the unit id, the display label and an input alias; rates come from a live provider with USD as the fixed base.

This page lists every code, the named aliases, the input marker table, the fractional-digit exceptions that affect display only, and the caching rules that keep offline sheets usable without ever inventing a rate.

Catalog

166 ISO 4217 fiat codes; no cryptocurrencies and no precious metals. The set matches the open provider’s list.
A code works as the unit identifier, the display label, and an input alias.
The provider’s base currency is fixed: USD. The app has no setting for choosing a different base.

Fractional digits

ISO 4217 defines how many fractional digits a currency conventionally shows. In Numlex this affects display only — underlying values are never rounded.

Digits	Currencies
0	`BIF`, `CLP`, `DJF`, `GNF`, `ISK`, `JPY`, `KMF`, `KRW`, `PYG`, `RWF`, `UGX`, `VND`, `VUV`, `XAF`, `XOF`, `XPF`
2	all other codes
3	`BHD`, `IQD`, `JOD`, `KWD`, `LYD`, `OMR`, `TND`
4	`CLF`

Input

Three ways to write money (see Money & rates for the full syntax):

Currency markers from the table below.
An ISO-code annotation next to the number: 100 USD.
A named alias from the table below, such as 100 Canadian dollar.

A code outside the catalog is an unknown unit. When an input has no marker in the marker table, the display falls back to the code as a suffix (600.00 CHF). The position of the symbol and the sign is a display setting.

Live rates

Provider: open.er-api.com — a free endpoint, no key, base USD.
The rate table refreshes hourly (3600-second interval).
The last good rates are kept in an atomic file snapshot. Offline, or when a request fails, the app keeps working with the last cache — it never invents a rate.

Live results are dynamic by nature; see Privacy & network for what is sent.

All 166 codes

`AED` `AFN` `ALL` `AMD` `ANG` `AOA` `ARS` `AUD` `AWG` `AZN`
`BAM` `BBD` `BDT` `BGN` `BHD` `BIF` `BMD` `BND` `BOB` `BRL`
`BSD` `BTN` `BWP` `BYN` `BZD` `CAD` `CDF` `CHF` `CLF` `CLP`
`CNH` `CNY` `COP` `CRC` `CUP` `CVE` `CZK` `DJF` `DKK` `DOP`
`DZD` `EGP` `ERN` `ETB` `EUR` `FJD` `FKP` `FOK` `GBP` `GEL`
`GGP` `GHS` `GIP` `GMD` `GNF` `GTQ` `GYD` `HKD` `HNL` `HRK`
`HTG` `HUF` `IDR` `ILS` `IMP` `INR` `IQD` `IRR` `ISK` `JEP`
`JMD` `JOD` `JPY` `KES` `KGS` `KHR` `KID` `KMF` `KRW` `KWD`
`KYD` `KZT` `LAK` `LBP` `LKR` `LRD` `LSL` `LYD` `MAD` `MDL`
`MGA` `MKD` `MMK` `MNT` `MOP` `MRU` `MUR` `MVR` `MWK` `MXN`
`MYR` `MZN` `NAD` `NGN` `NIO` `NOK` `NPR` `NZD` `OMR` `PAB`
`PEN` `PGK` `PHP` `PKR` `PLN` `PYG` `QAR` `RON` `RSD` `RUB`
`RWF` `SAR` `SBD` `SCR` `SDG` `SEK` `SGD` `SHP` `SLE` `SLL`
`SOS` `SRD` `SSP` `STN` `SYP` `SZL` `THB` `TJS` `TMT` `TND`
`TOP` `TRY` `TTD` `TVD` `TWD` `TZS` `UAH` `UGX` `USD` `UYU`
`UZS` `VES` `VND` `VUV` `WST` `XAF` `XCD` `XCG` `XDR` `XOF`
`XPF` `YER` `ZAR` `ZMW` `ZWG` `ZWL`

Named aliases

Code	Aliases
`AED`	`UAE dirham`, `UAE dirhams`, `dirham`, `dirhams`
`ARS`	`Argentine peso`, `Argentine pesos`
`AUD`	`Australian dollar`, `Australian dollars`
`BDT`	`Bangladeshi taka`, `taka`
`BGN`	`Bulgarian lev`, `lev`
`BHD`	`Bahraini dinar`, `Bahraini dinars`
`BRL`	`Brazilian real`, `Brazilian reais`, `reais`
`CAD`	`Canadian dollar`, `Canadian dollars`
`CHF`	`Swiss franc`, `Swiss francs`
`CLP`	`Chilean peso`, `Chilean pesos`
`CNY`	`Chinese yuan`, `yuan`, `renminbi`, `RMB`
`COP`	`Colombian peso`, `Colombian pesos`
`CZK`	`Czech koruna`, `koruna`
`EGP`	`Egyptian pound`, `Egyptian pounds`
`EUR`	`euro`, `euros`, `european euro`, `european euros`
`GBP`	`British pound`, `British pounds`, `pound sterling`, `sterling`
`GEL`	`Georgian lari`, `lari`
`GHS`	`Ghanaian cedi`, `cedi`
`HKD`	`Hong Kong dollar`, `Hong Kong dollars`
`HUF`	`Hungarian forint`, `forint`
`IDR`	`Indonesian rupiah`, `rupiah`
`ILS`	`Israeli new shekel`, `Israeli new shekels`, `new shekel`, `new shekels`, `shekel`, `shekels`
`INR`	`Indian rupee`, `Indian rupees`, `rupee`, `rupees`
`JOD`	`Jordanian dinar`, `Jordanian dinars`
`JPY`	`Japanese yen`, `yen`
`KES`	`Kenyan shilling`, `Kenyan shillings`
`KRW`	`South Korean won`, `Korean won`, `won`
`KWD`	`Kuwaiti dinar`, `Kuwaiti dinars`
`KZT`	`Kazakhstani tenge`, `tenge`
`MXN`	`Mexican peso`, `Mexican pesos`
`MYR`	`Malaysian ringgit`, `ringgit`
`NGN`	`Nigerian naira`, `naira`
`NZD`	`New Zealand dollar`, `New Zealand dollars`
`PEN`	`Peruvian sol`, `Peruvian soles`, `sol`, `soles`
`PHP`	`Philippine peso`, `Philippine pesos`
`PKR`	`Pakistani rupee`, `Pakistani rupees`
`PLN`	`Polish zloty`, `Polish zlotys`, `zloty`, `zlotys`
`QAR`	`Qatari riyal`, `Qatari riyals`
`RON`	`Romanian leu`, `leu`
`RUB`	`Russian ruble`, `Russian rubles`, `ruble`, `rubles`, `rouble`, `roubles`
`SAR`	`Saudi riyal`, `Saudi riyals`
`SGD`	`Singapore dollar`, `Singapore dollars`
`THB`	`Thai baht`, `baht`
`TRY`	`Turkish lira`, `lira`, `liras`
`TWD`	`New Taiwan dollar`, `New Taiwan dollars`
`UAH`	`Ukrainian hryvnia`, `hryvnia`
`USD`	`US dollar`, `US dollars`, `American dollar`, `American dollars`, `dollar`, `dollars`
`VND`	`Vietnamese dong`, `dong`
`ZAR`	`South African rand`, `rand`

Input markers

The marker table is matched longest-first, so CN¥ is not mistaken for ¥ (see Money & rates):

Marker	Code
`NZ$`	`NZD`
`CA$`	`CAD`
`HK$`	`HKD`
`MX$`	`MXN`
`NT$`	`TWD`
`A$`	`AUD`
`S$`	`SGD`
`R$`	`BRL`
`CN¥`	`CNY`
`Rp`	`IDR`
`RM`	`MYR`
`zł`	`PLN`
`Kč`	`CZK`
`$`	`USD`
`€`	`EUR`
`£`	`GBP`
`¥`	`JPY`
`₽`	`RUB`
`₩`	`KRW`
`₹`	`INR`
`₺`	`TRY`
`₴`	`UAH`
`₫`	`VND`
`₱`	`PHP`
`฿`	`THB`
`₪`	`ILS`
`₦`	`NGN`
`₾`	`GEL`
`₸`	`KZT`
`₮`	`MNT`
`₯`	`LAK`
`៛`	`KHR`
`₡`	`CRC`
`₲`	`PYG`
`₵`	`GHS`

Money & rates — writing and combining money.
Privacy & network — the rate provider in context.