This is a simple Currency Converter CLI and web API application implemented in Python3.5.

KiwiRate supports the following currencies:

See the requirements.txt file.

This project makes use of the Fixer API to get currency exchange rates. It provides the latest official rates published by the European Central Bank. The reference rates are usually updated around 4PM CET on every working day.

An example query to get the EUR exchange rate looks like:

https://api.fixer.io/latest?base=EUR

The conversion rates are cached to reduce server load.

This project also makes use of the web framework Flask. Parameters host and port are set to default values: 127.0.0.1 and 5000 respectively.

JSON with following structure:

{
  "input": {
    "amount": <float value>, 
    "currency": <a three letter input currency code>
  }, 
  "output": {
    <a three letter output currency code>: <float value>
  }
}

JSON with following structure

{
  "error_code": <error code>, 
  "error_message": <error message>
}

See the implementation: currency_converter.py

 ./currency_converter.py [--amount <value>] --input_currency <currencyCode_or_Symbol> [--output_currency <currencyCode_or_Symbol>]

The order of parameters does not matter.

Input:
./currency_converter.py --amount 15 --input_currency $ --output_currency EUR

Output:

{
  "input": {
    "amount": 15.0, 
    "currency": "USD"
  }, 
  "output": {
    "EUR": 12.06
  }
}

Input:
./currency_converter.py --amount 9 --input_currency zł

Output:

{
  "input": {
    "amount": 9.0, 
    "currency": "PLN"
  }, 
  "output": {
    "AUD": 3.34, 
    "BGN": 4.25, 
    "BRL": 8.51, 
    "CAD": 3.33,
    ...
    "USD": 2.7, 
    "ZAR": 32.13
  }
}

Input:
./currency_converter.py --input_currency € --output_currency PLN

Output:

{
  "input": {
    "amount": 1.0, 
    "currency": "EUR"
  }, 
  "output": {
    "PLN": 4.14
  }
}

See the implementation: currency_converter_API.py

BaseURL

GET http://127.0.0.1:5000/currency_converter

The following URL encoded parameters are accepted:

Input:
GET /currency_converter?amount=10&output_currency=czk&input_currency=€ HTTP/1.1

Output:

{
  "input": {
    "amount": 10.0, 
    "currency": "EUR"
  }, 
  "output": {
    "CZK": 253.57
  }
}

Input:
GET /currency_converter?amount=1000.25&input_currency=HUF HTTP/1.1

Output:

{
  "input": {
    "amount": 1000.25, 
    "currency": "HUF"
  }, 
  "output": {
    "AUD": 4.97, 
    "BGN": 6.31, 
    "BRL": 12.64, 
    "CAD": 4.95,
    ...
    "USD": 4.02, 
    "ZAR": 47.75
  }
}

Input:
GET /currency_converter?input_currency=CAD&output_currency=USD HTTP/1.1

Output:

{
  "input": {
    "amount": 1.0, 
    "currency": "CAD"
  }, 
  "output": {
    "USD": 0.81
  }
}