# Convert Currency

## /convert-currency

This endpoint performs currency conversion from one currency to another based on the provided parameters. It accepts a GET request with query parameters including the `value`, `fromCurrency`, and `toCurrency`. If any of these parameters are missing, it returns a custom HTML page indicating missing parameters. If the conversion is successful, it returns the converted value. If the `format` parameter is set to 'true', the converted value will be formatted with the currency symbol. If the conversion fails or an error occurs, it returns a corresponding error message with a status code of 400 or 500.

### Query Parameters

| Parameter    | Type   | Description                                                                                  |
| ------------ | ------ | -------------------------------------------------------------------------------------------- |
| value        | number | The value to be converted.                                                                   |
| fromCurrency | string | The currency code of the value to be converted from.                                         |
| toCurrency   | string | The currency code of the value to be converted to.                                           |
| format       | string | (Optional) If set to 'true', the converted value will be formatted with the currency symbol. |

### Response

```json
{
  "convertedValue": "string | number"
}
```

### Example

```
GET /convert-currency?value=100&fromCurrency=USD&toCurrency=EUR&format=true
```

### Supported Currency Codes and Symbols

* **USD**: United States Dollar ($)
* **EUR**: Euro (€)
* **GBP**: British Pound Sterling (£)
* **JPY**: Japanese Yen (¥)
* **CNY**: Chinese Yuan (¥)
* **AUD**: Australian Dollar (A$)
* **CAD**: Canadian Dollar (C$)
* **CHF**: Swiss Franc (CHF)
* **SEK**: Swedish Krona (kr)
* **NZD**: New Zealand Dollar (NZ$)
* **KRW**: South Korean Won (₩)
* **SGD**: Singapore Dollar (S$)
* **NOK**: Norwegian Krone (kr)
* **MXN**: Mexican Peso (Mex$)
* **INR**: Indian Rupee (₹)
* **RUB**: Russian Ruble (₽)
* **ZAR**: South African Rand (R)
* **HKD**: Hong Kong Dollar (HK$)
* **TRY**: Turkish Lira (₺)
* **BRL**: Brazilian Real (R$)
* **TWD**: New Taiwan Dollar (NT$)
* **DKK**: Danish Krone (kr)
* **PLN**: Polish Złoty (zł)
* **THB**: Thai Baht (฿)
* **CZK**: Czech Crown (Kč)

### Notes

* If the conversion is successful, the converted value will be returned as a JSON response. Optionally formatted with the currency symbol if requested.
* If the provided currency codes are invalid or not supported, a 400 error response with an error message will be returned.
* If any error occurs during currency conversion, a 500 error response with an error message will be returned.
* If the symbol is not available for the wanted currency you will receive a message like:\
  `This currency doesn't have a symbol`