Skip to content

CSharpMT5 CLI — Shortcasts & Live Examples 🚀

⚙️ General launch pattern (PowerShell / CMD):

dotnet run -- <command> [options]

🌍 Global Options

Option Meaning Notes
-p, --profile <name> Profile from profiles.json (default: default) Switch accounts quickly
-s, --symbol <SYM> Instrument/ticker, e.g., EURUSD Default taken from profile
-v, --volume <lots> Order volume in lots
--deviation <pts> Max slippage in points
`-o, --output text json` Output format text or json (machine-friendly)
--timeout-ms <ms> Per-RPC timeout (default: 30000) Avoids hangs
--dry-run Don’t send anything, just show what would be done Great for testing
--verbose / --trace Extended logging Debug / trace everything

💡 Tip: set password via environment variable MT5_PASSWORD instead of hardcoding in files.

📑 Command Reference (Shortcasts)

Format: command — aliases — what it does

👤 Profiles

  • profiles list — ls → list profile names
  • profiles show — view → show profile parameters (uses MT5_PASSWORD)

📊 General / Info

  • info — i → account summary
  • quote — q → one-shot spot quote (Bid/Ask/Time)
  • health — ping → connectivity diagnostics
  • stream — st → tick/event stream (auto-reconnect)

💹 Market Orders

  • buy — b → market buy
  • sell — s → market sell

🔄 Closing / Reversing

  • close — c → close by ticket (exact/normalized volume)
  • close.percent — cpp → close by percent
  • close.half — ch → close half (50%)
  • close.partial — cp → close exact volume
  • close-all — flatten → close all open positions
  • close-symbol — cs → close all positions for a symbol
  • reverse — rv → reverse net position (--mode net|flat)
  • reverse.ticket — rvt → reverse a specific ticket

🎯 SL/TP & Safety

  • position.modify — posmod → set SL/TP by price
  • position.modify.points — pmp → set SL/TP by points
  • breakeven — be → move SL to breakeven ± offset
  • trail.start → start a local trailing stop
  • trail.stop → stop trailing

📌 Pending Orders

  • place — pl → place pending (limit/stop/stop-limit)
  • pending.modify — pm → change pending params
  • pending.move — pmove → shift price(s) by ±N pts
  • pending list — ls → list pending tickets
  • cancel — x → delete pending by ticket
  • cancel.all — ca → delete all pendings (with filters)

🎟 Tickets / Symbols / Lists

  • ticket show — tsh → show info for a ticket (open/recent)
  • positions — pos → active positions
  • orders — ord → open orders + positions tickets
  • symbol ensure — en → make symbol visible
  • symbol limits — lim → lot min/step/max
  • symbol show — sh → symbol card (quote + limits)

📜 History / Tools

  • history — h → orders/deals history for N days
  • history.export — hexport → export history (CSV/JSON)
  • lot.calc — lc → lot size from risk% & SL pts
  • panic → close all + cancel all pendings

🚀 Quick Start

# Profiles
dotnet run -- profiles list
dotnet run -- profiles show -p demo

# Connectivity
dotnet run -- health -p demo

# One quote
dotnet run -- q -p demo -s EURUSD

🛠 Practical Scenarios

1️⃣ Open & Manage Position

dotnet run -- buy -p demo -s EURUSD -v 0.10 --sl 1.0700 --tp 1.0800 --deviation 10
dotnet run -- breakeven -p demo -t 123456 --offset-points 2
dotnet run -- position.modify.points -p demo -t 123456 --sl-points 150 --tp-points 250
dotnet run -- trail.start -p demo -t 123456 --distance 150 --step 20
dotnet run -- trail.stop -p demo -t 123456

2️⃣ Partial Close & Reverse

dotnet run -- close.half -p demo -t 123456
dotnet run -- close.percent -p demo -t 123456 --pct 30
dotnet run -- close.partial -p demo -t 123456 --volume 0.05
dotnet run -- reverse -p demo -s EURUSD --mode net  --sl 1.0700 --tp 1.0850
dotnet run -- reverse.ticket -p demo -t 123456 --sl 1.0700 --tp 1.0850

3️⃣ Pendings

dotnet run -- place -p demo --type buylimit  -s EURUSD --price 1.0750 --sl 1.0700 --tp 1.0800
dotnet run -- pending.modify -p demo -t 778899 --price 1.0765 --sl 1.0745
dotnet run -- pending.move -p demo -t 778899 --by-points 15
dotnet run -- pending list -p demo
dotnet run -- cancel -p demo -t 778899 -s EURUSD
dotnet run -- cancel.all -p demo --symbol EURUSD

4️⃣ Lists & Symbols

dotnet run -- positions -p demo -o json
dotnet run -- orders -p demo
dotnet run -- symbol show -p demo -s EURUSD
dotnet run -- symbol ensure -p demo -s GBPUSD
dotnet run -- symbol limits -p demo -s USDJPY

5️⃣ Tickets & History

dotnet run -- ticket show -p demo -t 123456 --days 30
dotnet run -- history -p demo -d 7
dotnet run -- history.export -p demo -d 30 --to csv  --file C:\temp\hist.csv

6️⃣ Risk & Panic

dotnet run -- lot.calc -s EURUSD --risk-pct 1 --sl-points 150 --balance 1000
dotnet run -- panic -p demo

🔎 Debugging & Tips

  • Profile not found: check profiles.json placement
  • Hidden symbol: run symbol ensure
  • Timeouts: bump --timeout-ms or add --trace