You can easily integrate the latest currency exchange rates and currency conversions for over 150 currencies into your personal and commercial website and application by using our free currency API.
Our currency API is available in JSON format and easily accessible through a simple API request over a secure HTTPS connection.
The base URL for our currency API is
https://www.amdoren.com/api/currency.php
Request Parameters
| Parameter | Description |
|---|---|
| api_key | Your assigned API key. This parameter is required. |
| from | The currency you would like to convert from. This parameter is required. |
| to | The currency you would like to convert to. This parameter is required. |
| amount | The amount to convert from. This parameter is optional. Default is a value of 1. |
You can find the list of over 150 supported currencies here.You can also retrieve the list of currencies using the currency list API.
Example:
To get the latest exchange rate in EUR for 1 USD:
https://www.amdoren.com/api/currency.php?api_key=IBZzdLmM2yCYaXjgTZ6x&from=USD&to=EUR
Example:
To convert 50 EUR to GBP:
https://www.amdoren.com/api/currency.php?api_key=IBZzdLmM2yCYaXjgTZ6x&from=EUR&to=GBP&amount=50
| Element | Description |
|---|---|
| error | Error code. Value greater than zero indicates an error. See list below. |
| error_message | Short decription of the error. See list below. |
| amount | The exchange rate or amount converted. |
Example:
JSON data returned from our currency API request:
{ "error" : 0, "error_message" : "-", "amount" : 0.90168 }
| Error Code | Description |
|---|---|
| 0 | No error. |
| 100 | API key not provided. |
| 110 | Invalid API key. |
| 200 | From currency not provided. |
| 210 | Invalid from currency. |
| 250 | To currency not provided. |
| 260 | Invalid to currency. |
| 300 | Amount must be numeric. |
| 310 | Invalid amount. |
| 320 | Amount cannot be zero. |
| 400 | API limit reached for the month. |
Our free currency API is highly stable & reliable. See our uptime
