Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin

The AutoGPT MetaTrader Plugin is a software tool that enables traders to connect their MetaTrader 4 or 5 trading account to Auto-GPT.
https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin

autogpt crypto finance forex gpt-3 gpt-4 metatrader metatrader-4 metatrader-5 metatrader5 mt4 mt5 stocks trading

Last synced: 3 months ago
JSON representation

The AutoGPT MetaTrader Plugin is a software tool that enables traders to connect their MetaTrader 4 or 5 trading account to Auto-GPT.

Awesome Lists containing this project

README

        

# Auto-GPT MetaTrader Plugin ๐Ÿ“ˆ
The AutoGPT MetaTrader Plugin is a software tool that enables traders to connect their MetaTrader 4 or 5 trading account to Auto-GPT.

[Try MetaTrader GPT on ChatGPT](https://chat.openai.com/g/g-sZE9jEsXA-metatrader-gpt)

[![GitHub Repo stars](https://img.shields.io/github/stars/isaiahbjork/Auto-GPT-MetaTrader-Plugin?style=social)](https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin/stargazers)

๐Ÿ’– Help Support Auto-GPT Plugin's Development ๐Ÿ’–



If you can spare a coffee, you can help to cover the costs of developing Auto-GPT Plugins and help to push the boundaries of fully autonomous AI!
Your support is greatly appreciated. Development of this free, open-source project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here.

Crypto Donations: 0x2457e8746EFa5894b70aE06a1b391474bc928B05

## ๐Ÿ’ก Key Features:
- ๐Ÿ’ฐ **Place Trades**
- โ„น๏ธ **Account Information**
- โ›”๏ธ **Close Trade**
- โŒ **Close All Trades**
- ๐Ÿ•ฏ **Candlestick Data**
- ๐Ÿ“ˆ **Stock of The Day**
- ๐Ÿ“‚ **Red Folder News**
- ๏ผ… **Community Sentiment** (In-Progress)
- ๐Ÿ“ **Modify Trades** (In-Progress)
## ๐Ÿ”ง Installation

Follow these steps to configure the Auto-GPT MetaTrader Plugin:

### 1. Clone the Auto-GPT-MetaTrader-Plugin repository
Clone this repository and navigate to the `Auto-GPT-MetaTrader-Plugin` folder in your terminal:

```bash
git clone https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin.git
```

### 2. Install required dependencies
Execute the following command to install the necessary dependencies:

```bash
pip install -r requirements.txt
```

### 3. Package the plugin as a Zip file
Compress the `Auto-GPT-MetaTrader-Plugin` folder or [download the repository as a zip file](https://github.com/isaiahbjork/Auto-GPT-MetaTrader-Plugin/archive/refs/heads/master.zip).

### 4. Install Auto-GPT
If you haven't already, clone the [Auto-GPT](https://github.com/Significant-Gravitas/Auto-GPT) repository, follow its installation instructions, and navigate to the `Auto-GPT` folder.

You might have to run this in the Auto-GPT file if you get an error saying "No Module Found".

```bash
pip install ta myfxbook
```
### 5. Copy the Zip file into the Auto-GPT Plugin folder
Transfer the zip file from step 3 into the `plugins` subfolder within the `Auto-GPT` repo.

### 6. Locate the `.env.template` file
Find the file named `.env.template` in the main `/Auto-GPT` folder.

### 7. Create and rename a copy of the file
Duplicate the `.env.template` file and rename the copy to `.env` inside the `/Auto-GPT` folder.

### 8. Edit the `.env` file
Open the `.env` file in a text editor. Note: Files starting with a dot might be hidden by your operating system.

### 9. Add MetaTrader configuration settings
Append the following configuration settings to the end of the file:

```ini
################################################################################
### METATRADER
################################################################################
META_API_ACCOUNT_ID=
META_API_TOKEN=
META_API_REGION=
LUNAR_CRUSH_API_KEY=
MY_FX_BOOK_USERNAME=
MY_FX_BOOK_PASSWORD=
FCS_API_KEY=
```
- Create a [MetaAPI](https://metaapi.cloud) account and connect to your broker.
- MT5 accounts will need to have a paid account to access candlestick data.
- Create a [MyFxBook](https://myfxbook.com) account and connect to your trading accounts.
- Create a [FCS API](https://fcsapi.com) account. (500 calls/mo for free)
- Set `META_API_ACCOUNT_ID` to your MetaAPI account ID.
- Set `META_API_TOKEN` to your MetaAPI token.
- Set `META_API_REGION` to your MetaAPI region (new-york, london, singapore).
- Set `LUNAR_CRUSH_API_KEY` to your LunarCrush API Key.
- Set `MY_FX_BOOK_USERNAME` to your MyFxBook username/email.
- Set `MY_FX_BOOK_PASSWORD` to your MyFxBook password.
- Set `FCS_API_KEY` to your FCS API KEY.
### 10. Allowlist Plugin
In your `.env` search for `ALLOWLISTED_PLUGINS` and add this Plugin:

```ini
################################################################################
### ALLOWLISTED PLUGINS
################################################################################
#ALLOWLISTED_PLUGINS - Sets the listed plugins that are allowed (Example: plugin1,plugin2,plugin3)
ALLOWLISTED_PLUGINS=AutoGPTMetaTraderPlugin
```
### 11. Review Available Commands
You can review the available commands and indicators [here](/src/auto_gpt_metatrader/commands.txt).

## ๐Ÿงช Test the Auto-GPT MetaTrader Plugin

Experience the plugin's capabilities by testing it for placing trades, managing your account, closing trades, and fetching candlestick data.

### Test Fetching Candlestick Data

1. **Configure Auto-GPT:**
Set up Auto-GPT with the following parameters:
- Name: `TradeGPT`
- Role: `fetch candlestick data`
- Goals:
1. Goal 1: `fetch candlestick data for the 1 hour chart on EURUSD`
2. Goal 2: `Terminate`

2. **Run Auto-GPT:**
Launch Auto-GPT, which should use the MetaTrader plugin and it should load the candlestick data.

3. **Sample response:**
auto-gpt-email-plugin

## ๐Ÿ“‰ Indicators (In-Progress):
- **Relative Strength Index (RSI)**
- **Volume**
- **Moving Averages (SMA, EMA, WMA, MAE, OsMA, MACD)**
- **Fibonacci Retracement**
- **Bollinger Bands**
- **Money Fund Index (MFI)**