🚦 Beginner Run Guide for GoMT4¶

This guide is based on your examples/main.go. Code is already wired; just enter your credentials in config/config.json and uncomment what you want to run.

⚡ How to Run¶

cd examples
go run .

The entry point is examples/main.go.

🧪 Safe First Steps (read‑only)¶

Uncomment one or more — these do not change account state:

// Account snapshot
svc.ShowAccountSummary(ctx)

// Discover all instruments
svc.ShowAllSymbols(ctx)

// One‑shot quote for your default symbol
svc.ShowQuote(ctx, cfg.DefaultSymbol)

// Live quotes for predefined symbols (stops by timeout in example)
svc.StreamQuotes(ctx)

📊 Getting Data (account & market)¶

Handy readers to inspect the environment:

// Recent closed orders (default window inside helper)
svc.ShowOrdersHistory(ctx)

// All active orders (incl. pending)
svc.ShowOpenedOrders(ctx)

// Full instrument profile
svc.ShowSymbolParams(ctx, cfg.DefaultSymbol)

// Monetary metrics for sizing
svc.ShowTickValues(ctx, []string{"EURUSD", "GBPUSD", "USDJPY"})

// Multi‑symbol snapshot quotes
svc.ShowQuotesMany(ctx, []string{"EURUSD", "GBPUSD", "USDJPY"})

// Historical OHLC for charting
svc.ShowQuoteHistory(ctx, cfg.DefaultSymbol)

⚠️ Trading Operations (danger zone)¶

These modify state (even on demo). Use real tickets from output of previous steps.

// Place an order (order type configured inside helper)
svc.ShowOrderSendExample(ctx, cfg.DefaultSymbol)

// Modify SL/TP — requires a valid ticket
svc.ShowOrderModifyExample(ctx, 12345678)

// Close order by ticket
svc.ShowOrderCloseExample(ctx, 12345678)

// Close by opposite order (two tickets)
svc.ShowOrderCloseByExample(ctx, 12345678, 12345679)

// Delete a pending order by ticket
svc.ShowOrderDeleteExample(ctx, 111222)

Replace placeholders with actual tickets printed by ShowOpenedOrders or ShowOpenedOrderTickets.

📡 Streaming¶

Real‑time subscriptions with graceful cancellation inside examples:

// Live price updates (ticks)
svc.StreamQuotes(ctx)

// Floating P/L per opened order (interval inside helper)
svc.StreamOpenedOrderProfits(ctx)

// Ticket IDs of open orders only
svc.StreamOpenedOrderTickets(ctx)

// Trade activity events
svc.StreamTradeUpdates(ctx)

🎬 Combo Scenarios¶

A) Read‑only dashboard (safe)¶

svc.ShowAccountSummary(ctx)
svc.ShowQuote(ctx, cfg.DefaultSymbol)
svc.ShowOpenedOrders(ctx)
svc.StreamQuotes(ctx)
svc.StreamOpenedOrderProfits(ctx)

B) Adjust risk → then close¶

// 1) Inspect active orders and pick a ticket
svc.ShowOpenedOrders(ctx)

// 2) Update SL/TP for that ticket
svc.ShowOrderModifyExample(ctx, /*ticket=*/ 12345678)

// 3) Close when ready
svc.ShowOrderCloseExample(ctx, /*ticket=*/ 12345678)

C) Tickets stream + lazy details¶

// Low‑overhead ticket stream
svc.StreamOpenedOrderTickets(ctx)

// Fetch full details on change
svc.ShowOpenedOrders(ctx)

D) History snapshot (safe)¶

svc.ShowOrdersHistory(ctx)

🧠 Tips¶

Begin with safe readers before trading helpers.
Never hardcode tickets; copy from console output.
Protect config/config.json — it contains credentials.
Prefer demo until you are confident.
For price formatting, use Digits from ShowSymbolParams; keep raw values for math.