This is a package created as a group project for DSCI_524 Collaborative Software Development of UBC Master of Data Science (MDS) program 2022-2023. Based on the foreign exchange data in Yahoo Finance, this package allows user to perform currency conversion based on the latest available exchange rate, lookup a target exchange rate from historical data as well plotting exchange rate history and profit/loss percentage history by specifying a currency pair (and other input parameters).
The full documentation of this package can also be found on https://fxtracker.readthedocs.io/en/latest/
fx_conversion
Convert the input amount of currency 1 to currency 2 based on the latest available exchange rate.fx_rate_lookup
Lookup for the most recent date on which the input target rate of a currency pair is within the day's high/low.price_trend_viz
Plot the historical exchange rate of the input currency pair for a specific period of time.pl_trend_viz
Plot the historical profit/loss percentage of the input currency pair for a specific period of time.
There is a python package (forex-python) relevant to foreign exchange. That package is basically for retrieving exchange rates and bitcoin prices in plain text as well as performing conversion. It does not provide visualizations and lookup function like fxtracker does. fxtracker allows user to visualize the trends and understand if a target price of a currency pair of interest is within a reasonable range.
$ pip install fxtrackerIf the package is installed successfully, users then need the following nine input parameters:
curr, target_px, start_date, end_date, chart_type, option, curr1, curr2, amt. The output of the functions will be in forms of a datetime string, a float and interactive plots from the "altair" package.
fxtracker can be used to convert a specific amount of money from one currency to another, find the most recent date on which the target price falling between day high and day low of that day, visualize the trend of the exchange rate of a currency pair and the trend of the profit and loss of a currency pair between the selected start date and end date.
The functions can be imported from the package as follows:
from fxtracker.fxtracker import fx_conversion
from fxtracker.fxtracker import fx_rate_lookup
from fxtracker.fxtracker import price_trend_viz
from fxtracker.fxtracker import pl_trend_vizfx_conversion('EUR', 'USD', 150.75)
163.68
To look up the most recent date on which the target price falling between day high and day low of that day:
fx_rate_lookup('EURUSD', 1.072)
'2023-01-10'
To visualize the trend of the exchange rate of a currency pair between the selected start date and end date:
price_trend_viz('EURUSD', '2018-12-01', '2022-12-01', 'High').show()
To visualize the trend of the profit and loss of a currency pair between the selected start date and end date:
If a line chart is specified in the input:
pl_trend_viz("EURUSD", "2020-01-01", "2022-01-01", 'line').show()
If an area chart is specified in the input:
pl_trend_viz("EURUSD", "2020-01-01", "2022-01-01", 'area').show()
- python = "^3.9"
- pandas = "^1.5.2"
- altair = "^4.2.0"
- numpy = "^1.24.1"
- plotly = "^5.12.0"
- yfinance = "^0.2.3"
- ipykernel = "^6.20.2"
- altair-viewer = "^0.4.0"
Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
fxtracker was created by Sarah Abdelazim, Markus Nam, Crystal Geng and Lennon Au-Yeung. It is licensed under the terms of the MIT license.
fxtracker was created with cookiecutter and the py-pkgs-cookiecutter template.