This API provides an automation capability to our Forex Reference Suite service.
It provides an easy way to retrieve accurate and up to date currency exchange rates data.
This API is designed to be light, fast and easy to integrate.
With a single GET or POST request you may retrieve all 154 currency exchange rates for a given currency code.
2. Currency Exchange Rates API Requests
The accepted parameters by the API are listed in the table below:
Field Name
Length
Type
Description
currency
3
String
3 letter ISO currency code for which to retrieve the exchange rates. For example ( usd,eur,gbp ... etc )
xml is the response format. Also a json keyword can be specified for json formatted response.
Once an HTTP GET or POST request is made with the correct API key, the system will return the results in the specified format.
You can find an sample response in the next section “API Response Structure”
3. Currency Rates API Response
The API response default format is in JSON format ( XML format is also supported ). It is simplified and structured for easy access to all elements:
A detailed description of the response object fields returned can be seen in the table below:
Field Name
Length
Type
Description
base_currency
3
String
The currency ISO code of the base currency you submitted to the API.
time
19
String
This is the time of the latest update of the rates data from our data sources. This field is in human readable format.
timestamp
10
Integer
The same time of the latest update of the rates data as 'time'. This field is in Unix Time format
rates
154
Array
This element contains an array of the exchange rates for the requested base currency. Each element of the array has the currency ISO code as a key and the exchange rate as a value.
4. Supported Currencies
This is a list of the supported base currencies which can be submitted to the Exchange Rates API.
Currency Code
Number
Currency Name
Region
AED
784
United Arab Emirates Dirham
UNITED ARAB EMIRATES
AFN
971
Afghani
AFGHANISTAN
ALL
008
Albanian Lek
ALBANIA
AMD
051
Armenian Dram
ARMENIA
ANG
532
Netherlands Antillean Guilder
CURACAO
AOA
973
Angolan Kwanza
ANGOLA
ARS
032
Argentine Peso
ARGENTINA
AUD
036
Australian Dollar
AUSTRALIA
AWG
533
Aruban Florin
ARUBA
AZN
944
Azerbaijanian Manat
AZERBAIJAN
BAM
977
Convertible Mark
BOSNIA AND HERZEGOVINA
BBD
052
Barbados Dollar
BARBADOS
BDT
050
Bangladeshi Taka
BANGLADESH
BGN
975
Bulgarian Lev
BULGARIA
BHD
048
Bahraini Dinar
BAHRAIN
BIF
108
Burundi Franc
BURUNDI
BMD
060
Bermudian Dollar
BERMUDA
BND
096
Brunei Dollar
BRUNEI DARUSSALAM
BOB
068
Boliviano
BOLIVIA
BRL
986
Brazilian Real
BRAZIL
BSD
044
Bahamian Dollar
BAHAMAS (THE)
BTN
064
Bhutanese Ngultrum
BHUTAN
BWP
072
Botswanan Pula
BOTSWANA
BYR
974
Belarussian Ruble
BELARUS
BZD
084
Belize Dollar
BELIZE
CAD
124
Canadian Dollar
CANADA
CDF
976
Congolese Franc
CONGO
CHF
756
Swiss Franc
SWITZERLAND
CLP
152
Chilean Peso
CHILE
CNY
156
Yuan Renminbi
CHINA
COP
170
Colombian Peso
COLOMBIA
CRC
188
Costa Rican Colon
COSTA RICA
CUP
192
Cuban Peso
CUBA
CVE
132
Cabo Verde Escudo
CABO VERDE
CZK
203
Czech Koruna
CZECH REPUBLIC (THE)
DJF
262
Djibouti Franc
DJIBOUTI
DKK
208
Danish Krone
DENMARK
DOP
214
Dominican Peso
DOMINICAN REPUBLIC (THE)
DZD
012
Algerian Dinar
ALGERIA
EGP
818
Egyptian Pound
EGYPT
ERN
232
Eritrean Nakfa
ERITREA
ETB
230
Ethiopian Birr
ETHIOPIA
EUR
978
Euro
EUROPEAN UNION
FJD
242
Fiji Dollar
FIJI
FKP
238
Falkland Islands Pound
FALKLAND ISLANDS
GBP
826
Pound Sterling
GUERNSEY
GEL
981
Georgian Lari
GEORGIA
GHS
936
Ghana Cedi
GHANA
GIP
292
Gibraltar Pound
GIBRALTAR
GMD
270
Gambian Dalasi
GAMBIA (THE)
GNF
324
Guinea Franc
GUINEA
GTQ
320
Guatemalan Quetzal
GUATEMALA
GYD
328
Guyana Dollar
GUYANA
HKD
344
Hong Kong Dollar
HONG KONG
HNL
340
Honduran Lempira
HONDURAS
HRK
191
Croatian Kuna
CROATIA
HTG
332
Haitian Gourde
HAITI
HUF
348
Hungarian Forint
HUNGARY
IDR
360
Indonesian Rupiah
INDONESIA
ILS
376
New Israeli Sheqel
ISRAEL
INR
356
Indian Rupee
INDIA
IQD
368
Iraqi Dinar
IRAQ
IRR
364
Iranian Rial
IRAN (ISLAMIC REPUBLIC OF)
ISK
352
Iceland Krona
ICELAND
JMD
388
Jamaican Dollar
JAMAICA
JOD
400
Jordanian Dinar
JORDAN
JPY
392
Japanese Yen
JAPAN
KES
404
Kenyan Shilling
KENYA
KGS
417
Kyrgystani Som
KYRGYZSTAN
KHR
116
Cambodian Riel
CAMBODIA
KMF
174
Comoro Franc
COMOROS (THE)
KPW
408
North Korean Won
KOREA (THE DEMOCRATIC PEOPLE'S REPUBLIC OF)
KRW
410
South Korean Won
KOREA (THE REPUBLIC OF)
KWD
414
Kuwaiti Dinar
KUWAIT
KYD
136
Cayman Islands Dollar
CAYMAN ISLANDS (THE)
KZT
398
Kazakhstani Tenge
KAZAKHSTAN
LAK
418
Laotian Kip
LAO PEOPLE'S DEMOCRATIC REPUBLIC (THE)
LBP
422
Lebanese Pound
LEBANON
LKR
144
Sri Lanka Rupee
SRI LANKA
LRD
430
Liberian Dollar
LIBERIA
LSL
426
Lesotho Loti
LESOTHO
LYD
434
Libyan Dinar
LIBYA
MAD
504
Moroccan Dirham
MOROCCO
MDL
498
Moldovan Leu
MOLDOVA (THE REPUBLIC OF)
MGA
969
Malagasy Ariary
MADAGASCAR
MKD
807
Macedonian Denar
MACEDONIA
MMK
104
Myanma Kyat
MYANMAR
MNT
496
Mongolian Tugrik
MONGOLIA
MOP
446
Macanese Pataca
MACAO
MUR
480
Mauritius Rupee
MAURITIUS
MVR
462
Maldivian Rufiyaa
MALDIVES
MWK
454
Malawian Kwacha
MALAWI
MXN
484
Mexican Peso
MEXICO
MYR
458
Malaysian Ringgit
MALAYSIA
MZN
943
Mozambique Metical
MOZAMBIQUE
NAD
516
Namibia Dollar
NAMIBIA
NGN
566
Nigerian Naira
NIGERIA
NIO
558
Cordoba Oro
NICARAGUA
NOK
578
Norwegian Krone
NORWAY
NPR
524
Nepalese Rupee
NEPAL
NZD
554
New Zealand Dollar
NEW ZEALAND
OMR
512
Rial Omani
OMAN
PAB
590
Panamanian Balboa
PANAMA
PEN
604
Peruvian Nuevo Sol
PERU
PGK
598
Papua Kina
PAPUA NEW GUINEA
PHP
608
Philippine Peso
PHILIPPINES (THE)
PKR
586
Pakistan Rupee
PAKISTAN
PLN
985
Polish Zloty
POLAND
PYG
600
Paraguayan Guarani
PARAGUAY
QAR
634
Qatari Rial
QATAR
RON
946
Romanian Leu
ROMANIA
RSD
941
Serbian Dinar
SERBIA
RUB
643
Russian Ruble
RUSSIAN FEDERATION (THE)
RWF
646
Rwanda Franc
RWANDA
SAR
682
Saudi Riyal
SAUDI ARABIA
SBD
090
Solomon Islands Dollar
SOLOMON ISLANDS
SCR
690
Seychelles Rupee
SEYCHELLES
SDG
938
Sudanese Pound
SUDAN (THE)
SEK
752
Swedish Krona
SWEDEN
SGD
702
Singapore Dollar
SINGAPORE
SHP
654
Saint Helena Pound
SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
SLL
694
Leone
SIERRA LEONE
SOS
706
Somali Shilling
SOMALIA
SRD
968
Surinam Dollar
SURINAME
SVC
222
El Salvador Colon
EL SALVADOR
SYP
760
Syrian Pound
SYRIAN ARAB REPUBLIC
SZL
748
Swazi Lilangeni
SWAZILAND
THB
764
Thai Baht
THAILAND
TJS
972
Tajikistani Somoni
TAJIKISTAN
TMT
934
Turkmenistan New Manat
TURKMENISTAN
TND
788
Tunisian Dinar
TUNISIA
TOP
776
Tongan Paʻanga
TONGA
TRY
949
Turkish Lira
TURKEY
TTD
780
Trinidad and Tobago Dollar
TRINIDAD AND TOBAGO
TWD
901
New Taiwan Dollar
TAIWAN (PROVINCE OF CHINA)
TZS
834
Tanzanian Shilling
TANZANIA, UNITED REPUBLIC OF
UAH
980
Ukrainian Hryvnia
UKRAINE
UGX
800
Uganda Shilling
UGANDA
USD
840
US Dollar
UNITED STATES OF AMERICA
UYU
858
Peso Uruguayo
URUGUAY
UZS
860
Uzbekistan Sum
UZBEKISTAN
VEF
937
Venezuelan Bolivar
VENEZUELA (BOLIVARIAN REPUBLIC OF)
VND
704
Vietnamese Dong
VIET NAM
VUV
548
Vanuatu Vatu
VANUATU
WST
882
Samoan Tala
SAMOA
XAF
950
CFA Franc BEAC
CENTRAL AFRICAN
XCD
951
East Caribbean Dollar
EASTERN CARIBBEAN STATES
XDR
960
SDR (Special Drawing Right)
INTERNATIONAL MONETARY FUND (IMF)
XOF
952
CFA Franc BCEAO
WEST AFRICAN
XPF
953
CFP Franc
FRENCH COLONIES OF THE PACIFIC
YER
886
Yemeni Rial
YEMEN
ZAR
710
South African Rand
SOUTH AFRICA
ZMW
967
Zambian Kwacha
ZAMBIA
ZWL
932
Zimbabwe Dollar
ZIMBABWE
5. Currency Rates API errors
Upon an error, the API will return one of the following 'error' responses.
Status Code
Type
Description
Solution
401
Account Error
API Key is invalid
You need to supply a valid API key. Your API key can be found in your Client Area -> API Access section.
402
Account Error
Subscription expired
You need to renew your membership. This can be done from your Client Area -> My Services section.
406
Account Error
No queries available
Your account ran out of available credits. You need to refill your account by purchasing a new package.
403
Account Error
You have no access to this API
Your account has no access to this service, you need to purchase a plan for this service from your Client Area -> Purchase Plans section.
405
Account Error
IP Address not allowed
You had enabled the IP restriction in your Client Area -> Account -> Security Section. You need to allow the IP address of the computer/server making the request in your access list.
410
Input Validation Failed
Invalid currency code
You have submitted an invalid currency code as an input parameter. The supported currencies are available above in Section 4: Supported Currencies
400
Input Validation Failed
Bad Request ( Missing required parameters: api_key, currency )
You have not submitted all parameters required for retrieving currency exchange rate data.
500
Server Error
Internal Server Error. Contact Support.
An unexpected error occurred in our system. This error is caused by a problem on our end. Please contact our support if you encounter this error.