interface

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# Interface

Use this skill for the local MT5 Python CLI wrapper located at:

`C:\Users\kecom\AppData\Roaming\MetaQuotes\Terminal\D0E8209F77C8CF37AD8BF550E51FF075\MQL5\Scripts\interface.py`

The script is intended to operate MetaTrader 5 through the Python `MetaTrader5` package. Treat it as a live-trading interface: do not submit market, pending, close, edit, or cancel commands unless the user explicitly asked for that action and the target account/symbol/ticket/volume/stops are clear.

## Before Running

1. Work from the script directory unless there is a reason not to:

```powershell
cd C:\Users\kecom\AppData\Roaming\MetaQuotes\Terminal\D0E8209F77C8CF37AD8BF550E51FF075\MQL5\Scripts
```

2. Confirm a real Python executable is available. If `python` resolves to `C:\Users\kecom\AppData\Local\Microsoft\WindowsApps\python.exe`, it may hang or open the Microsoft Store alias instead of running scripts.

3. Confirm the package is installed when execution is required:

```powershell
python -m pip install MetaTrader5
```

4. Confirm MetaTrader 5 is installed, logged in, and allowed to trade. If needed, pass `--terminal`, `--login`, `--password`, and `--server`.

5. For read-only inspection, prefer `--cmd=help`, `--cmd=opened`, `--cmd=orders`, `--cmd=history`, `--cmd=account`, and `--cmd=symbol`.

## Core Commands

Show the built-in help:

```powershell
python interface.py --cmd=help
```

Open a market buy using SL/TP distances in points:

```powershell
python interface.py --cmd=open --type=buy --market=EURUSD --lot=0.10 --sl-points=200 --tp-points=400
```

Open a pending buy limit using absolute SL/TP prices:

```powershell
python interface.py --cmd=open --type=buylimit --market=EURUSD --lot=0.10 --price=1.08000 --SL=1.07500 --TP=1.09000
```

Close one open position by ticket:

```powershell
python interface.py --cmd=close --id=322334
```

Close all positions, optionally filtered by market:

```powershell
python interface.py --cmd=close --all --market=EURUSD
```

Edit SL/TP on an open position or pending order:

```powershell
python interface.py --cmd=edit --id=23232 --TP=1.09250
python interface.py --cmd=edit --id=23232 --sl-points=150 --tp-points=300
```

Cancel a pending order:

```powershell
python interface.py --cmd=cancel --id=998877
```

List current positions:

```powershell
python interface.py --cmd=opened
python interface.py --cmd=opened --market=EURUSD
```

List pending orders:

```powershell
python interface.py --cmd=orders
python interface.py --cmd=orders --market=EURUSD
```

Read recent history. The misspelled alias `hystory` is accepted for compatibility:

```powershell
python interface.py --cmd=history --last=10
python interface.py --cmd=hystory --last=10 --market=EURUSD
```

Check account or symbol details:

```powershell
python interface.py --cmd=account
python interface.py --cmd=symbol --market=EURUSD
```

## Parameter Rules

Use `--SL` and `--TP` for absolute prices only. Example: `--SL=1.07500`, not `--SL=23` unless 23 is truly the broker price.

Use distance parameters when the user describes stops in points or pips:

```powershell
--sl-points=200 --tp-points=400
--sl-pips=20 --tp-pips=40
```

Use `--price` for pending order entry price. Market orders can omit `--price`; the script uses the current ask for buys and bid for sells.

Use `--stoplimit` for `buystoplimit` and `sellstoplimit` orders.

Use `--lot` or `--volume` for trade volume.

Use `--deviation` for allowed slippage in points on market entries and closes.

From kecoma1/MQL5-SKILLS, MIT.

More from kecoma1/MQL5-SKILLS