tsitsiflora / currency_converter

A currency convertor

A currency convertor API

Prerequisites

1. Get a free API key from API Layer["https://apilayer.com/marketplace/exchangerates_data-api"] for the Exchange rates API. The Exchange rates API gives real time foreign exchange rates. To obtain an API key you must create an account.

How to start the API

1. Clone the git repository using the command

git clone https://github.com/tsitsiflora/currency_converter.git

2. Traverse into the convertor directory
3. Create a virtual environment for the project:

python3 -m venv venv

4. Install the requirements:

pip3 install -R requirements.txt

5. Make a file call ACCESS_KEY.py and put your API key in there. For example:

YOUR_ACCESS_KEY = "randomstringhere"

6. Start the API using

uvicorn main:app --reload

7. The API will run at 127.0.0.1:8000. You can visit the address in your browser
8. You can use the docs at 127.0.0.1:8000/docs to test the API or use curl

API Endpoints

• /: this is the index point
• /all: this retrieves all currencies supported by the API
• /convert: this converts one currency into another