Can I use the Convert Currency API for commercial purposes?

Yes, but you must have a premium subscription. Commercial use of the Convert Currency API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

How do I get an API key and start using the Convert Currency API?

Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

What happens if I exceed my quota for the month?

Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page .

What happens if a request to the Convert Currency API fails?

The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

How do I convert an amount from one currency to another?

Send a GET request with three required parameters: have (the 3-character code of the currency you currently hold, e.g. GBP ), want (the 3-character code you want to convert to, e.g. AUD ), and amount (the quantity to convert). To pull the underlying rates directly instead, see the Exchange Rate API .

What does the Convert Currency API response include?

It returns a JSON object with old_amount and old_currency echoing your input, new_amount and new_currency giving the converted result, and a timestamp (Unix seconds) indicating when the exchange rate used for the conversion was applied. See the error codes page for what is returned on a failed request.

How fresh are the exchange rates, and which currencies are supported?

All supported currencies are available on the free tier, which returns once-daily exchange rates; premium plans add real-time rates. The API converts between fiat currencies only (for crypto, use a dedicated crypto endpoint). Each response includes a timestamp for the exchange rate used. For historical rates, see the Exchange Rate API .

What are some use cases for the Convert Currency API?

It is ideal for displaying localized prices in e-commerce checkouts, building travel budgeting tools, and normalizing multi-currency invoices or financial reports. For tracking how much a currency pair fluctuates over time, pair it with the Currency Volatility API .

Currency Conversion API

The Currency Conversion API converts an amount from one currency into another using up-to-date foreign exchange rates. Convert between hundreds of global currencies with a single request.

Note: This API converts between fiat currencies. For crypto-to-fiat conversions, use the Crypto Price API instead.

Working with FX risk? See the Currency Volatility API for realized volatility and forecasts on any pair. Premium only

Supported Currencies

Symbol	Currency	Symbol	Currency
`USD`	United States Dollar	`EUR`	Euro
`GBP`	British Pound	`JPY`	Japanese Yen
`AUD`	Australian Dollar	`CAD`	Canadian Dollar
`CHF`	Swiss Franc	`CNY`	Chinese Yuan
`INR`	Indian Rupee	`HKD`	Hong Kong Dollar
`SGD`	Singapore Dollar	`MXN`	Mexican Peso
`AED`	UAE Dirham	`AFN`	Afghan Afghani
`ALL`	Albanian Lek	`AMD`	Armenian Dram
`ANG`	Netherlands Antillean Gulden	`AOA`	Angolan Kwanza
`ARS`	Argentine Peso	`AWG`	Aruban Florin
`AZN`	Azerbaijani Manat	`BAM`	Bosnia And Herzegovina Konvertibilna Marka
`BBD`	Barbadian Dollar	`BDT`	Bangladeshi Taka
`BGN`	Bulgarian Lev	`BHD`	Bahraini Dinar
`BIF`	Burundi Franc	`BMD`	Bermudan Dollar
`BND`	Brunei Dollar	`BOB`	Bolivian Boliviano
`BRL`	Brazilian Real	`BSD`	Bahamian Dollar
`BTC`	Bitcoin	`BTN`	Bhutanese Ngultrum
`BWP`	Botswana Pula	`BYN`	New Belarusian Ruble
`BYR`	Belarusian Ruble	`BZD`	Belize Dollar
`CDF`	Congolese Franc	`CLF`	Chilean Unit Of Account
`CLP`	Chilean Peso	`COP`	Colombian Peso
`CRC`	Costa Rican Colon	`CUC`	Cuban Convertible Peso
`CUP`	Cuban Peso	`CVE`	Cape Verdean Escudo
`CZK`	Czech Koruna	`DJF`	Djiboutian Franc
`DKK`	Danish Krone	`DOP`	Dominican Peso
`DZD`	Algerian Dinar	`EGP`	Egyptian Pound
`ERN`	Eritrean Nakfa	`ETB`	Ethiopian Birr
`FJD`	Fijian Dollar	`FKP`	Falkland Islands Pound
`GEL`	Georgian Lari	`GGP`	Guernsey Pound
`GHS`	Ghanaian Cedi	`GIP`	Gibraltar Pound
`GMD`	Gambian Dalasi	`GNF`	Guinean Franc
`GTQ`	Guatemalan Quetzal	`GYD`	Guyanese Dollar
`HNL`	Honduran Lempira	`HRK`	Croatian Kuna
`HTG`	Haitian Gourde	`HUF`	Hungarian Forint
`IDR`	Indonesian Rupiah	`ILS`	Israeli New Sheqel
`IMP`	Manx pound	`IQD`	Iraqi Dinar
`IRR`	Iranian Rial	`ISK`	Icelandic Króna
`JEP`	Jersey Pound	`JMD`	Jamaican Dollar
`JOD`	Jordanian Dinar	`KES`	Kenyan Shilling
`KGS`	Kyrgyzstani Som	`KHR`	Cambodian Riel
`KMF`	Comorian Franc	`KPW`	North Korean Won
`KRW`	South Korean Won	`KWD`	Kuwaiti Dinar
`KYD`	Cayman Islands Dollar	`KZT`	Kazakhstani Tenge
`LAK`	Lao Kip	`LBP`	Lebanese Lira
`LKR`	Sri Lankan Rupee	`LRD`	Liberian Dollar
`LSL`	Lesotho Loti	`LVL`	Latvian Lats
`LYD`	Libyan Dinar	`MAD`	Moroccan Dirham
`MDL`	Moldovan Leu	`MGA`	Malagasy Ariary
`MKD`	Macedonian Denar	`MMK`	Myanma Kyat
`MNT`	Mongolian Tugrik	`MOP`	Macanese Pataca
`MRO`	Mauritanian Ouguiya	`MUR`	Mauritian Rupee
`MVR`	Maldivian Rufiyaa	`MWK`	Malawian Kwacha
`MYR`	Malaysian Ringgit	`MZN`	Mozambican Metical
`NAD`	Namibian Dollar	`NGN`	Nigerian Naira
`NIO`	Nicaraguan Cordoba	`NOK`	Norwegian Krone
`NPR`	Nepalese Rupee	`NZD`	New Zealand Dollar
`OMR`	Omani Rial	`PAB`	Panamanian Balboa
`PEN`	Peruvian Nuevo Sol	`PGK`	Papua New Guinean Kina
`PHP`	Philippine Peso	`PKR`	Pakistani Rupee
`PLN`	Polish Zloty	`PYG`	Paraguayan Guarani
`QAR`	Qatari Riyal	`RON`	Romanian Leu
`RSD`	Serbian Dinar	`RUB`	Russian Ruble
`RWF`	Rwandan Franc	`SAR`	Saudi Riyal
`SBD`	Solomon Islands Dollar	`SCR`	Seychellois Rupee
`SDG`	Sudanese Pound	`SEK`	Swedish Krona
`SHP`	Saint Helena Pound	`SLL, SLE`	Sierra Leonean Leone
`SOS`	Somali Shilling	`SRD`	Surinamese Dollar
`STD, STN`	Sao Tome And Principe Dobra	`SVC`	Salvadoran Colón
`SYP`	Syrian Pound	`SZL`	Swazi Lilangeni
`THB`	Thai Baht	`TJS`	Tajikistani Somoni
`TMT`	Turkmenistan Manat	`TND`	Tunisian Dinar
`TOP`	Paanga	`TRY`	Turkish New Lira
`TTD`	Trinidad and Tobago Dollar	`TWD`	New Taiwan Dollar
`TZS`	Tanzanian Shilling	`UAH`	Ukrainian Hryvnia
`UGX`	Ugandan Shilling	`UYU`	Uruguayan Peso
`UZS`	Uzbekistani Som	`VEF, VES`	Venezuelan Bolivar
`VND`	Vietnamese Dong	`VUV`	Vanuatu Vatu
`WST`	Samoan Tala	`XAF`	Central African CFA Franc
`XAG`	Silver (troy ounce)	`XCD`	East Caribbean Dollar
`XDR`	Special Drawing Rights	`XOF`	West African CFA Franc
`XPF`	CFP Franc	`YER`	Yemeni Rial
`ZAR`	South African Rand	`ZMK`	Old Zambian Kwacha
`ZMW`	Zambian Kwacha	`ZWG`	Zimbabwe Gold
`ZWL`	Zimbabwean Dollar

Online

(4.4)

From 5,079 users

2,800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
249ms	287ms	337ms	684ms	1101ms

Similar APIs

Exchange Rate Unit Conversion

Didn't find what you were looking for? Suggest an improvement

https://api.api-ninjas.com/v1/convertcurrency

Converts an existing currency and amount into a new currency.

Data freshness depends on your plan: free-tier accounts receive once-daily rates, while premium subscribers receive real-time rates.

Parameters

have required
Currency you currently hold. Must be 3-character currency code (e.g. USD).
want required
Currency you want to convert to. Must be 3-character currency code (e.g. USD).
amount required
Amount of currency to convert.

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v1/convertcurrency endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

old_amount
The original amount to convert (e.g. 5000).
old_currency
The original currency code (e.g. GBP).
new_amount
The converted amount in the new currency (e.g. 9559.32).
new_currency
The new currency code (e.g. AUD).
timestamp
Unix timestamp (in seconds) indicating the time at which the exchange rate used for the conversion was applied.

Live Demo

Live demo · no API key required

Query parameters

have

want

amount

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v1/convertcurrency?have=GBP&want=AUD&amount=5000

Sample response

{

"new_amount": 9417.04,

"new_currency": "AUD",

"old_currency": "GBP",

"old_amount": 5000,

"timestamp": 1779498871

}

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/convertcurrency?have=GBP&want=AUD&amount=5000" \
  -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

Can I use the Convert Currency API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Convert Currency API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
How do I get an API key and start using the Convert Currency API?
Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
What happens if a request to the Convert Currency API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
How do I convert an amount from one currency to another?
Send a GET request with three required parameters: have (the 3-character code of the currency you currently hold, e.g. GBP), want (the 3-character code you want to convert to, e.g. AUD), and amount (the quantity to convert). To pull the underlying rates directly instead, see the Exchange Rate API.
What does the Convert Currency API response include?
It returns a JSON object with old_amount and old_currency echoing your input, new_amount and new_currency giving the converted result, and a timestamp (Unix seconds) indicating when the exchange rate used for the conversion was applied. See the error codes page for what is returned on a failed request.
How fresh are the exchange rates, and which currencies are supported?
All supported currencies are available on the free tier, which returns once-daily exchange rates; premium plans add real-time rates. The API converts between fiat currencies only (for crypto, use a dedicated crypto endpoint). Each response includes a timestamp for the exchange rate used. For historical rates, see the Exchange Rate API.
What are some use cases for the Convert Currency API?
It is ideal for displaying localized prices in e-commerce checkouts, building travel budgeting tools, and normalizing multi-currency invoices or financial reports. For tracking how much a currency pair fluctuates over time, pair it with the Currency Volatility API.

Explore API integration use cases for recommended APIs and workflow examples.

Currency Conversion API

Parameters

`have` required

`want` required

`amount` required

Headers

`X-Api-Key` required

Response

`old_amount`

`old_currency`

`new_amount`

`new_currency`

`timestamp`

Live Demo

Code Examples

Frequently Asked Questions

Currency Conversion API

/v1/convertcurrencyGET

Parameters

have required

want required

amount required

Headers

X-Api-Key required

Response

old_amount

old_currency

new_amount

new_currency

timestamp

Live Demo

Code Examples

Frequently Asked Questions

`have` required

`want` required

`amount` required

`X-Api-Key` required

`old_amount`

`old_currency`

`new_amount`

`new_currency`

`timestamp`