Currency Symbols API Reference

Overview

A currency code API built on the ISO 4217 list. Look up a currency code such as EUR to get every country that uses it, or a country to get its currency. Countries can be a name (Canada), a two- or three-letter ISO code (CA or CAN) or a common alternative spelling, and are matched against ISO 4217's own country names, so KR finds Korea (the Republic of). The Free plan returns the country names and ISO codes. Paid plans add the symbol, the currency's full name, its numeric code, its minor units (the decimal places to show) and its live value: units per US dollar, the dollar value of one unit and the percent change since yesterday's close, refreshed every few minutes. To convert amounts, use Currency Converter.

Live Test Currency Symbols API →

Endpoint

One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.

GEThttps://api.apiverve.com/v1/currencysymbols

1
2

curl "https://api.apiverve.com/v1/currencysymbols?currency=USD" \
  -H "x-api-key: your_api_key_here"

const res = await fetch('https://api.apiverve.com/v1/currencysymbols?currency=USD', {
  headers: { 'x-api-key': 'your_api_key_here' },
});

if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { data } = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.apiverve.com/v1/currencysymbols?currency=USD",
    headers={"x-api-key": "your_api_key_here"},
    timeout=15,
)
res.raise_for_status()

print(res.json()["data"])

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/currencysymbols?currency=USD", nil)
	req.Header.Set("x-api-key", "your_api_key_here")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.

Authentication

Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Parameters

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.

Parameter	Type	Description
`currency`Required	string	The currency code for which you want to get the symbol

Response

Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.

Sample response

{
  "status": "ok",
  "error": null,
  "data": {
    "countriesFound": [
      {
        "country_name": "AMERICAN SAMOA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "BONAIRE, SINT EUSTATIUS AND SABA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "BRITISH INDIAN OCEAN TERRITORY (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "ECUADOR",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "EL SALVADOR",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "GUAM",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "HAITI",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "MARSHALL ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "MICRONESIA (FEDERATED STATES OF)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "NORTHERN MARIANA ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PALAU",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PANAMA",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "PUERTO RICO",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "TIMOR-LESTE",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "TURKS AND CAICOS ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "UNITED STATES MINOR OUTLYING ISLANDS (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "UNITED STATES OF AMERICA (THE)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "VIRGIN ISLANDS (BRITISH)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      },
      {
        "country_name": "VIRGIN ISLANDS (U.S.)",
        "currency_name": "US Dollar",
        "currency_iso_code": "USD",
        "currency_number": "840",
        "currency_mnr_unts": "2",
        "currency_symbol": "$",
        "exchangeRate": 1,
        "usdValue": 1,
        "change1d": 0
      }
    ],
    "ratesUpdated": "2026-10-27T17:41:09.810Z",
    "currency": "USD"
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`countriesFound`	array[19]		Array of countries matching the search query
`country_name`	string	`"AMERICAN SAMOA"`	Full name of the country
`currency_name`Premium	string	`"US Dollar"`	Full name of the currency used in country
`currency_iso_code`	string	`"USD"`	ISO 4217 currency code for the country
`currency_number`Premium	string	`"840"`	ISO 4217 numeric currency code
`currency_mnr_unts`Premium	string	`"2"`	Minor currency units for decimal place specification
`currency_symbol`Premium	string	`"$"`	Symbol representing the currency
`exchangeRate`Premium	number	`1`	Live units of this currency per 1 US dollar; null when no rate is published for it
`usdValue`Premium	number	`1`	Live value of 1 unit of this currency in US dollars; null when no rate is published for it
`change1d`Premium	number	`0`	Percent change in the currency's US dollar value since yesterday's close (positive means it strengthened); null when no close is stored
`ratesUpdated`Premium	string	`"2026-10-27T17:41:09.810Z"`	ISO 8601 time the live exchange rates were last refreshed
`currency`	string	`"USD"`	The currency code of the queried country

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.

Status	Meaning	What to do
`400`	Input was rejected	Read `error`; it names the parameter.
`401`	Key missing or invalid	Check the header name and the key value.
`403`	Key valid, but not permitted	A key restriction or IP allow-list; see key scoping.
`429`	Rate limited, or out of credits	Read `error` to tell them apart; see rate limits.

Supported Currencies

170+ world currencies supported including fiat currencies, cryptocurrencies, and precious metals.

Code	Currency	Region
`AED`	UAE Dirham	United Arab Emirates
`AFN`	Afghan Afghani	Afghanistan
`ALL`	Albanian Lek	Albania
`AMD`	Armenian Dram	Armenia
`ANG`	Netherlands Antillean Guilder	Curaçao
`AOA`	Angolan Kwanza	Angola
`ARS`	Argentine Peso	Argentina
`AUD`	Australian Dollar	Australia
`AWG`	Aruban Florin	Aruba
`AZN`	Azerbaijani Manat	Azerbaijan
`BAM`	Bosnia-Herzegovina Convertible Mark	Bosnia and Herzegovina
`BBD`	Barbadian Dollar	Barbados
`BDT`	Bangladeshi Taka	Bangladesh
`BGN`	Bulgarian Lev	Bulgaria
`BHD`	Bahraini Dinar	Bahrain
`BIF`	Burundian Franc	Burundi
`BMD`	Bermudan Dollar	Bermuda
`BND`	Brunei Dollar	Brunei
`BOB`	Bolivian Boliviano	Bolivia
`BRL`	Brazilian Real	Brazil
`BSD`	Bahamian Dollar	Bahamas
`BTC`	Bitcoin	Cryptocurrency
`BTN`	Bhutanese Ngultrum	Bhutan
`BWP`	Botswanan Pula	Botswana
`BYN`	Belarusian Ruble	Belarus
`BZD`	Belize Dollar	Belize
`CAD`	Canadian Dollar	Canada
`CDF`	Congolese Franc	Democratic Republic of the Congo
`CHF`	Swiss Franc	Switzerland
`CLF`	Chilean Unit of Account (UF)	Chile
`CLP`	Chilean Peso	Chile
`CNH`	Chinese Yuan (Offshore)	China
`CNY`	Chinese Yuan	China
`COP`	Colombian Peso	Colombia
`CRC`	Costa Rican Colón	Costa Rica
`CUC`	Cuban Convertible Peso	Cuba
`CUP`	Cuban Peso	Cuba
`CVE`	Cape Verdean Escudo	Cape Verde
`CZK`	Czech Koruna	Czech Republic
`DJF`	Djiboutian Franc	Djibouti
`DKK`	Danish Krone	Denmark
`DOP`	Dominican Peso	Dominican Republic
`DZD`	Algerian Dinar	Algeria
`EGP`	Egyptian Pound	Egypt
`ERN`	Eritrean Nakfa	Eritrea
`ETB`	Ethiopian Birr	Ethiopia
`EUR`	Euro	European Union
`FJD`	Fijian Dollar	Fiji
`FKP`	Falkland Islands Pound	Falkland Islands
`GBP`	British Pound Sterling	United Kingdom
`GEL`	Georgian Lari	Georgia
`GGP`	Guernsey Pound	Guernsey
`GHS`	Ghanaian Cedi	Ghana
`GIP`	Gibraltar Pound	Gibraltar
`GMD`	Gambian Dalasi	Gambia
`GNF`	Guinean Franc	Guinea
`GTQ`	Guatemalan Quetzal	Guatemala
`GYD`	Guyanaese Dollar	Guyana
`HKD`	Hong Kong Dollar	Hong Kong
`HNL`	Honduran Lempira	Honduras
`HRK`	Croatian Kuna	Croatia
`HTG`	Haitian Gourde	Haiti
`HUF`	Hungarian Forint	Hungary
`IDR`	Indonesian Rupiah	Indonesia
`ILS`	Israeli New Shekel	Israel
`IMP`	Isle of Man Pound	Isle of Man
`INR`	Indian Rupee	India
`IQD`	Iraqi Dinar	Iraq
`IRR`	Iranian Rial	Iran
`ISK`	Icelandic Króna	Iceland
`JEP`	Jersey Pound	Jersey
`JMD`	Jamaican Dollar	Jamaica
`JOD`	Jordanian Dinar	Jordan
`JPY`	Japanese Yen	Japan
`KES`	Kenyan Shilling	Kenya
`KGS`	Kyrgystani Som	Kyrgyzstan
`KHR`	Cambodian Riel	Cambodia
`KMF`	Comorian Franc	Comoros
`KPW`	North Korean Won	North Korea
`KRW`	South Korean Won	South Korea
`KWD`	Kuwaiti Dinar	Kuwait
`KYD`	Cayman Islands Dollar	Cayman Islands
`KZT`	Kazakhstani Tenge	Kazakhstan
`LAK`	Laotian Kip	Laos
`LBP`	Lebanese Pound	Lebanon
`LKR`	Sri Lankan Rupee	Sri Lanka
`LRD`	Liberian Dollar	Liberia
`LSL`	Lesotho Loti	Lesotho
`LYD`	Libyan Dinar	Libya
`MAD`	Moroccan Dirham	Morocco
`MDL`	Moldovan Leu	Moldova
`MGA`	Malagasy Ariary	Madagascar
`MKD`	Macedonian Denar	North Macedonia
`MMK`	Myanmar Kyat	Myanmar
`MNT`	Mongolian Tugrik	Mongolia
`MOP`	Macanese Pataca	Macau
`MRU`	Mauritanian Ouguiya	Mauritania
`MUR`	Mauritian Rupee	Mauritius
`MVR`	Maldivian Rufiyaa	Maldives
`MWK`	Malawian Kwacha	Malawi
`MXN`	Mexican Peso	Mexico
`MYR`	Malaysian Ringgit	Malaysia
`MZN`	Mozambican Metical	Mozambique
`NAD`	Namibian Dollar	Namibia
`NGN`	Nigerian Naira	Nigeria
`NIO`	Nicaraguan Córdoba	Nicaragua
`NOK`	Norwegian Krone	Norway
`NPR`	Nepalese Rupee	Nepal
`NZD`	New Zealand Dollar	New Zealand
`OMR`	Omani Rial	Oman
`PAB`	Panamanian Balboa	Panama
`PEN`	Peruvian Sol	Peru
`PGK`	Papua New Guinean Kina	Papua New Guinea
`PHP`	Philippine Peso	Philippines
`PKR`	Pakistani Rupee	Pakistan
`PLN`	Polish Zloty	Poland
`PYG`	Paraguayan Guarani	Paraguay
`QAR`	Qatari Rial	Qatar
`RON`	Romanian Leu	Romania
`RSD`	Serbian Dinar	Serbia
`RUB`	Russian Ruble	Russia
`RWF`	Rwandan Franc	Rwanda
`SAR`	Saudi Riyal	Saudi Arabia
`SBD`	Solomon Islands Dollar	Solomon Islands
`SCR`	Seychellois Rupee	Seychelles
`SDG`	Sudanese Pound	Sudan
`SEK`	Swedish Krona	Sweden
`SGD`	Singapore Dollar	Singapore
`SHP`	Saint Helena Pound	Saint Helena
`SLE`	Sierra Leonean Leone (new)	Sierra Leone
`SLL`	Sierra Leonean Leone (old)	Sierra Leone
`SOS`	Somali Shilling	Somalia
`SRD`	Surinamese Dollar	Suriname
`SSP`	South Sudanese Pound	South Sudan
`STD`	São Tomé and Príncipe Dobra (old)	São Tomé and Príncipe
`STN`	São Tomé and Príncipe Dobra	São Tomé and Príncipe
`SVC`	Salvadoran Colón	El Salvador
`SYP`	Syrian Pound	Syria
`SZL`	Swazi Lilangeni	Eswatini
`THB`	Thai Baht	Thailand
`TJS`	Tajikistani Somoni	Tajikistan
`TMT`	Turkmenistani Manat	Turkmenistan
`TND`	Tunisian Dinar	Tunisia
`TOP`	Tongan Paʻanga	Tonga
`TRY`	Turkish Lira	Turkey
`TTD`	Trinidad and Tobago Dollar	Trinidad and Tobago
`TWD`	New Taiwan Dollar	Taiwan
`TZS`	Tanzanian Shilling	Tanzania
`UAH`	Ukrainian Hryvnia	Ukraine
`UGX`	Ugandan Shilling	Uganda
`USD`	United States Dollar	United States
`UYU`	Uruguayan Peso	Uruguay
`UZS`	Uzbekistani Som	Uzbekistan
`VES`	Venezuelan Bolívar Soberano	Venezuela
`VND`	Vietnamese Dong	Vietnam
`VUV`	Vanuatu Vatu	Vanuatu
`WST`	Samoan Tala	Samoa
`XAF`	Central African CFA Franc	Central Africa
`XAG`	Silver (troy ounce)	Precious Metal
`XAU`	Gold (troy ounce)	Precious Metal
`XCD`	East Caribbean Dollar	Eastern Caribbean
`XCG`	Caribbean Guilder	Caribbean
`XDR`	Special Drawing Rights	International Monetary Fund
`XOF`	West African CFA Franc	West Africa
`XPD`	Palladium (troy ounce)	Precious Metal
`XPF`	CFP Franc	French Pacific Territories
`XPT`	Platinum (troy ounce)	Precious Metal
`YER`	Yemeni Rial	Yemen
`ZAR`	South African Rand	South Africa
`ZMW`	Zambian Kwacha	Zambia
`ZWG`	Zimbabwean Gold	Zimbabwe
`ZWL`	Zimbabwean Dollar	Zimbabwe

Use cases

E-Commerce Storefronts: Look up a buyer's country during checkout to retrieve the matching ISO currency code and render localized pricing with the correct symbol.
Invoicing Systems: Accounting platforms query an ISO currency code to identify the associated countries, numeric code, and decimal precision before generating international billing records.
Multi-Currency Digital Wallets: When a customer opens a foreign account balance, fetch the official currency name and symbol to display next to the ledger balance.
Expense Report Processing: Map foreign transaction entries to their originating country and currency code to validate expense submissions across international subsidiaries.

Other ways to use Currency Symbols

Set up Currency Symbols on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →

Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →

Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

Currency Symbols