Skip to content

GoMT4 The documentary BASE

📑 Table of Contents

📊 Account

📈 Market Info

📦 Orders

🔧 Reliability & Connection

🧰 Utils & Helpers

✨ Introduction

What is GoMT4? A small, pragmatic bridge between MT4 Terminal and your Go code via gRPC.

Who is it for? Beginners , algo developers, ops teams who need a scriptable MT4 integration.

After reading you can:

  • Run a local demo.
  • Connect to MT4.
  • Subscribe to quotes.
  • Place & close an order safely.

Quick links: 👉 Your Easy Start · 👉 Beginner Run Guide · 👉 CLI Usage

⚙️ Setup & Environment

Goal: Run everything on Windows with MT4 installed.

Prerequisites

  • Windows 10/11, MT4 Terminal.
  • Go ≥ 1.21.
  • (Optional) VS Code + Go extension.

Install (draft)

  1. Clone the repo, run go mod tidy in examples/.
  2. Configure credentials (see Config Example).
  3. Open in VS Code and launch the debug profile.

🏗️ Architecture & Data Flow

Make the system non-magical:

  • 💻 MT4 Terminal ⇄ GoMT4 gRPC server ⇄ 🧑‍💻 client code.
  • Lifecycles: connect → use → disconnect.
  • Streams: Quotes, Orders; buffering & backpressure.
  • Where retries/backoff kick in.

See details: Architecture & Data Flow

🔒 Reliability: Timeouts, Reconnects, Backoff

  • context.WithTimeout for unary calls (2–5s baseline).
  • Treat io.EOF as transient on streams; reconnect with jitter.
  • Ensure cancelation closes goroutines.
  • Don’t leak streams; add health checks.

See recipes:

🛠️ Troubleshooting & FAQ

  • “Symbol not found EURUSD” → Try broker suffix EURUSD.m.
  • “Invalid volume” → Respect LotStep/LotMin and round.
  • “Digits mismatch” → Format prices using Digits.
  • “No connection” → Firewall/UAC, terminal path, server reachability.

Full page: Troubleshooting & FAQ

📚 Cookbook (Recipes)

Jump into ready-made snippets:

Full list: Cookbook index

🖥️ CLI Usage (Playground)

  • Subscribe to quotes
  • Dump symbol params
  • Close orders by filter

See: CLI Usage

📖 API Reference (Types & Enums)

Autogenerated types index with human-readable notes, units, ranges, and gotchas ⚠️.

⚡ Performance Notes

  • Batch calls when possible
  • Avoid per-tick RPCs
  • Track expected latencies
  • Simple load test plan

Performance Notes

🔑 Security & Secrets

  • .env handling (do not commit secrets)
  • Windows credentials vault tips

Security & Secrets

📊 Observability (Logs & Metrics)

  • Log format and levels
  • Metrics: latency, reconnects, dropped ticks

Observability

📘 Glossary (MT4 Terms)

  • Digits, Point, TickSize, TickValue, Lot, ContractSize
  • Hedging vs Netting (MT5 nuances)

Glossary

📊 Whoosh-and-it-works: get a quote, open an order, subscribe to ticks.

Quick start: Get one quote (Go) 
// examples/mt4/MT4_service.go has ShowQuote(ctx, symbol string)
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()

price, err := svc.ShowQuote(ctx, "EURUSD")
if err != nil {
    log.Fatalf("quote error: %v", err)
}
fmt.Printf("EURUSD  Bid: %.5f  Ask: %.5f  Time: %s\n",
    price.Bid, price.Ask, price.Time.Format(time.RFC3339))
Place market order safely (uses rounding & symbol params) 
// See Cookbook/Orders/PlaceMarketOrder.md and ShowOrderSendExample in MT4_service.go
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

ticket, err := svc.ShowOrderSendExample(ctx, "EURUSD")
if err != nil {
    log.Fatalf("order send failed: %v", err)
}
fmt.Println("✅ Order ticket:", ticket)
Stream live quotes (local terminal) 
// Based on StreamQuotes in MT4_service.go
ctx, cancel := context.WithCancel(context.Background())
defer cancel()

updates, errCh := svc.StreamQuotes(ctx, []string{"EURUSD","GBPUSD"})
for {
    select {
    case q := <-updates:
        fmt.Printf("[Tick] %s  Bid: %.5f  Ask: %.5f\n", q.Symbol, q.Bid, q.Ask)
    case err := <-errCh:
        log.Printf("stream error: %v (reconnect logic in cookbook)", err)
        return
    }
}