MT5Account · Positions & Orders Information - Overview

Open positions, pending orders, historical deals, order history. Use this page to choose the right API for position/order queries.

📁 What lives here

Current State

• PositionsTotal - count of open positions.
• OpenedOrders - full details of all open positions and pending orders.
• OpenedOrdersTickets - ticket numbers only (lightweight).

Historical Data

• OrderHistory - historical orders within time range (with pagination).
• PositionsHistory - closed positions within time range (with pagination).

---

📚 Step-by-step tutorials

Want detailed explanations with line-by-line code breakdown? Check these guides:

• PositionsTotal - How it works
• OpenedOrders - How it works
• OpenedOrdersTickets - How it works
• OrderHistory - How it works
• PositionsHistory - How it works

---

🧭 Plain English

• PositionsTotal → quick count of open positions.
• OpenedOrders → get full details of all open positions/orders.
• OpenedOrdersTickets → get ticket numbers only (faster than full details).
• OrderHistory → query historical orders (placed, canceled, filled).
• PositionsHistory → query closed positions (deals).

Rule of thumb: need quick count → PositionsTotal; need full details → OpenedOrders; need tickets only → OpenedOrdersTickets; need history → OrderHistory or PositionsHistory.

---

Quick choose

If you need…	Use	Returns	Key inputs
Count of open positions	PositionsTotal	PositionsTotalData (int32)	(none)
All open positions/orders (full details)	OpenedOrders	OpenedOrdersData	InputSortMode (optional; no symbol filter, filter on the client side)
Ticket numbers only (lightweight)	OpenedOrdersTickets	Two arrays of int64	(none: always all symbols)
Historical orders in time range	OrderHistory	OrdersHistoryData	InputFrom/InputFromUtc, InputTo/InputToUtc, InputSortMode, PageNumber, ItemsPerPage (or PageToken/PageSize)
Closed positions in time range	PositionsHistory	PositionsHistoryData	SortType, PositionOpenTimeFrom(Utc), PositionOpenTimeTo(Utc), PageNumber, ItemsPerPage (or PageToken/PageSize)

---

❌ Cross‑refs & gotchas

• Positions vs Orders - Positions = executed market positions; Orders = pending orders (limits, stops).
• OpenedOrders returns both - Returns open positions AND pending orders in separate arrays.
• Tickets - Unique identifier for each position/order.
• Pagination - OrderHistory and PositionsHistory support PageNumber/ItemsPerPage for large datasets.
• Time range - OrderHistory and PositionsHistory use google.protobuf.Timestamp (convert from time.Time using timestamppb.New()). The plain fields are broker server time; the *Utc fields take UTC (use them for values built from time.Now()).
• OpenedOrdersTickets - Much lighter than OpenedOrders if you only need ticket numbers.
• Historical data limits - Broker may limit how far back you can query.

---

🟢 Minimal snippets

// Count open positions
data, err := account.PositionsTotal(ctx)
if err != nil {
    log.Fatalf("Failed: %v", err)
}

fmt.Printf("Open positions: %d\n", data.TotalPositions)

// Get all open positions/orders
data, err := account.OpenedOrders(ctx, &pb.OpenedOrdersRequest{})
if err != nil {
    log.Fatalf("Failed: %v", err)
}

fmt.Printf("Pending orders: %d, Open positions: %d\n",
    len(data.OpenedOrders), len(data.PositionInfos))

for _, pos := range data.PositionInfos {
    fmt.Printf("#%d: %s %.2f lots @ %.5f, P/L: $%.2f\n",
        pos.Ticket,
        pos.Symbol,
        pos.Volume,
        pos.PriceOpen,
        pos.Profit)
}

// Get ticket numbers only (lightweight)
data, err := account.OpenedOrdersTickets(ctx, &pb.OpenedOrdersTicketsRequest{})
if err != nil {
    log.Fatalf("Failed: %v", err)
}

fmt.Printf("Pending order tickets: %v\n", data.OpenedOrdersTickets)
fmt.Printf("Position tickets: %v\n", data.OpenedPositionTickets)

// Get historical orders (last 7 days)
now := time.Now()
weekAgo := now.Add(-7 * 24 * time.Hour)

data, err := account.OrderHistory(ctx, &pb.OrderHistoryRequest{
    InputFromUtc: timestamppb.New(weekAgo),
    InputToUtc:   timestamppb.New(now),
    PageNumber:   1,
    ItemsPerPage: 100,
})
if err != nil {
    log.Fatalf("Failed: %v", err)
}

fmt.Printf("Historical orders: %d\n", len(data.HistoryData))

for _, item := range data.HistoryData {
    if item.HistoryOrder != nil {
        fmt.Printf("#%d: %s @ %.5f\n",
            item.HistoryOrder.Ticket,
            item.HistoryOrder.Symbol,
            item.HistoryOrder.PriceOpen)
    }
}

// Get closed positions (today)
now := time.Now()
startOfDay := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location())

page, perPage := int32(1), int32(100) // PageNumber/ItemsPerPage are *int32 here

data, err := account.PositionsHistory(ctx, &pb.PositionsHistoryRequest{
    PositionOpenTimeFromUtc: timestamppb.New(startOfDay),
    PositionOpenTimeToUtc:   timestamppb.New(now),
    PageNumber:              &page,
    ItemsPerPage:            &perPage,
})
if err != nil {
    log.Fatalf("Failed: %v", err)
}

fmt.Printf("Closed positions today: %d\n", len(data.HistoryPositions))

totalProfit := 0.0
for _, pos := range data.HistoryPositions {
    totalProfit += pos.Profit
    fmt.Printf("#%d: %s %.2f lots → $%.2f\n",
        pos.PositionTicket,
        pos.Symbol,
        pos.Volume,
        pos.Profit)
}

fmt.Printf("Total profit today: $%.2f\n", totalProfit)

---

See also

• Trading operations: OrderSend - place new orders
• Order management: OrderClose - close positions
• Real-time updates: OnTrade - subscribe to trade events