No project description provided
Project description
Forex Dashboard
Project Status
Testing | CI - Test Coverage |
---|---|
Package | Meta |
---|---|
Overview
Forex Dashboard is a comprehensive tool designed for Forex traders to monitor and analyze their trading performance metrics. By seamlessly integrating with the MT5 terminal on Windows, the tool extracts trading deals, processes the data, and presents it in a user-friendly dashboard using Streamlit. This dashboard provides traders with insights into their daily wins, traded commodities, profit margins, and overall growth percentages.
Features
- ETL Process: Extracts trading data from the MT5 terminal, transforms it for analysis, and loads it into a CSV file.
- Streamlit Dashboard: Displays key performance metrics, including:
- Daily wins and losses.
- Traded commodities breakdown.
- Profit gains and losses.
- Daily and overall portfolio growth.
- Commissions paid.
- Daily and Total Trades executed.
- Weekly and Monthly gains.
Prerequisites
- Operating System: Windows (Tested on Windows 11)
- MT5 terminal installed on a Windows machine.
- Python >= 3.11 environment with necessary packages.
Setup and Usage
-
Create a Conda Environment:
conda create --name <env_name> python=3.11.6
-
Clone the Repository:
pip install fx_analytics pip install MetaTrader5 -> required to access MT5 for your historical trade deals!
-
To extract all your historical trades data from MT5 Terminal:
import fx_analytics from fx_analytics.main_functions import ETL # replace '****' with your login credential from MT5 terminal! mt5_credentials = {'login': '******', 'server':'******','password':'******'} df = ETL(from_date='2023-09-01', mt5_credentials = mt5_credentials) print(df)
-
To use/test the streamlit app from the package: To test app you can download the example data which was extracted from MT5, download data.
- Copy the below code into .py file
import fx_analytics from fx_analytics.app import main main('fx_history.csv')
To Run this file from CLI:
streamlit run {file_name.py}
-
To run both ETL to extract your data from MT5 and view the analytics streamlit dashboard
- create a python script 'app.py' and copy and past the below code, change the 'from_date' with your desired date and 'data_file_path', where you choose to stores the data extracted from ETL function, I prefer to use a data folder eg: 'data/{file_name.csv}'
import fx_analytics from fx_analytics.app import main from fx_analytics.main_functions import ETL # replace '****' with your login credential from MT5 terminal! mt5_credentials = {'login': '******', 'server':'******','password':'******'} df = ETL(from_date='2023-09-28', mt5_credentials = mt5_credentials) df.to_csv('data_file_path') main('data_file_path')
To Run this file from CLI:
streamlit run app.py
Output
- streamlit app preview:
Feedback and Contribution
- We welcome feedback and contributions! If you encounter any issues or have suggestions, please open an issue. If you'd like to contribute, please create a pull request.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fx_analytics-1.5.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cdd11cfcb6fe7e9c9af4278e0a5add5994d27e52a8f54e951f82a21ae5809f91 |
|
MD5 | 2bcc826270195770d0a6b0b392177541 |
|
BLAKE2b-256 | 0655ddbab1f52bea4b6df52502ac8487c1964c80a81ecd2aaef041f924e8a7cf |