Skip to content

✅ Get Symbol Quote Session Times

Request: get start and end times of quote session for symbol on specified day of week.

API Information:

  • Low-level API: MT5Account.SymbolInfoSessionQuote(...) (from Go package github.com/MetaRPC/GoMT5/package/Helpers)
  • gRPC service: mt5_term_api.MarketInfo
  • Proto definition: SymbolInfoSessionQuote (defined in mt5-term-api-market-info.proto)

RPC

  • Service: mt5_term_api.MarketInfo
  • Method: SymbolInfoSessionQuote(SymbolInfoSessionQuoteRequest) → SymbolInfoSessionQuoteReply
  • Low‑level client (generated): MarketInfoClient.SymbolInfoSessionQuote(ctx, request, opts...)

💬 Just the essentials

  • What it is. Returns when quotes are available for a symbol on specific days.
  • Why you need it. Check market hours, validate trading times, schedule operations.
  • Time format. Returns seconds from midnight (0 = 00:00, 3600 = 01:00, etc).

🎯 Purpose

Use it to:

  • Check when quotes are available for symbols
  • Validate if market is open before requesting prices
  • Schedule quote monitoring operations
  • Build trading session calendars
  • Determine quote availability windows
package mt5

type MT5Account struct {
    // ...
}

// SymbolInfoSessionQuote retrieves quote session times for a symbol.
// Returns From and To times in seconds from day start.
func (a *MT5Account) SymbolInfoSessionQuote(
    ctx context.Context,
    req *pb.SymbolInfoSessionQuoteRequest,
) (*pb.SymbolInfoSessionQuoteData, error)

Request message:

SymbolInfoSessionQuoteRequest {
  string Symbol = 1;       // Trading symbol
  int32 DayOfWeek = 2;     // Day of week (0=Sunday to 6=Saturday)
  int32 SessionIndex = 3;  // Session index (usually 0)
}

🔽 Input

Parameter Type Description
ctx context.Context Context for deadline/timeout and cancellation
req *pb.SymbolInfoSessionQuoteRequest Request with Symbol, DayOfWeek, SessionIndex

Request fields:

Field Type Description
Symbol string Trading symbol (e.g., "EURUSD")
DayOfWeek int32 Day of week (see enum below)
SessionIndex int32 Session index (usually 0 for main session)

DayOfWeek enum values:

Value Protobuf Enum Description
0 pb.DayOfWeek_SUNDAY Sunday
1 pb.DayOfWeek_MONDAY Monday
2 pb.DayOfWeek_TUESDAY Tuesday
3 pb.DayOfWeek_WEDNESDAY Wednesday
4 pb.DayOfWeek_THURSDAY Thursday
5 pb.DayOfWeek_FRIDAY Friday
6 pb.DayOfWeek_SATURDAY Saturday

Usage: Can use either numeric value or protobuf enum constant

⬆️ Output — SymbolInfoSessionQuoteData

Field Type Go Type Description
From google.protobuf.Timestamp *timestamppb.Timestamp Session start time (use .AsTime() to convert)
To google.protobuf.Timestamp *timestamppb.Timestamp Session end time (use .AsTime() to convert)

Note: To get seconds from day start, convert using: 

fromTime := data.From.AsTime()
fromSeconds := fromTime.Hour()*3600 + fromTime.Minute()*60 + fromTime.Second()

📚 Tutorial

For a detailed line-by-line explanation with examples, see: → SymbolInfoSessionQuote - How it works

🧩 Notes & Tips

  • Automatic reconnection: All MT5Account methods have built-in protection against transient gRPC errors with automatic reconnection via ExecuteWithReconnect.
  • Default timeout: If context has no deadline, a default 3s timeout is applied automatically.
  • Nil context: If you pass nil context, context.Background() is used automatically.
  • Time format: Session times are in seconds from midnight (00:00:00 = 0, 23:59:59 = 86399).
  • Multiple sessions: Some symbols have multiple quote sessions per day (SessionIndex 0, 1, etc).
  • Weekend: Most symbols have no quote sessions on Saturday and Sunday.

🔗 Usage Examples

1) Get Monday quote session

package main

import (
    "context"
    "fmt"
    "time"

    pb "github.com/MetaRPC/GoMT5/package"
    "github.com/MetaRPC/GoMT5/package/Helpers"
)

func main() {
    account, _ := mt5.NewMT5Account(12345, "password", "mt5.mrpc.pro:443", uuid.New())
    defer account.Close()

    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()

    data, err := account.SymbolInfoSessionQuote(ctx, &pb.SymbolInfoSessionQuoteRequest{
        Symbol:       "EURUSD",
        DayOfWeek:    1, // Monday
        SessionIndex: 0,
    })
    if err != nil {
        panic(err)
    }

    fromTime := data.From.AsTime()
    toTime := data.To.AsTime()

    fromSeconds := fromTime.Hour()*3600 + fromTime.Minute()*60 + fromTime.Second()
    toSeconds := toTime.Hour()*3600 + toTime.Minute()*60 + toTime.Second()

    fmt.Printf("EURUSD Monday quote session: %02d:%02d - %02d:%02d\n",
        fromSeconds/3600, (fromSeconds%3600)/60, toSeconds/3600, (toSeconds%3600)/60)
}

2) Get week schedule

func GetWeeklyQuoteSchedule(account *mt5.MT5Account, symbol string) {
    ctx := context.Background()

    days := []string{"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"}

    fmt.Printf("Quote sessions for %s:\n", symbol)
    for day := 0; day <= 6; day++ {
        data, err := account.SymbolInfoSessionQuote(ctx, &pb.SymbolInfoSessionQuoteRequest{
            Symbol:       symbol,
            DayOfWeek:    int32(day),
            SessionIndex: 0,
        })
        if err != nil {
            fmt.Printf("  %s: Not available\n", days[day])
            continue
        }

        fromStr := formatTime(data.From)
        toStr := formatTime(data.To)
        fmt.Printf("  %s: %s - %s\n", days[day], fromStr, toStr)
    }
}

func formatTime(ts *timestamppb.Timestamp) string {
    t := ts.AsTime()
    seconds := t.Hour()*3600 + t.Minute()*60 + t.Second()
    hours := seconds / 3600
    mins := (seconds % 3600) / 60
    return fmt.Sprintf("%02d:%02d", hours, mins)
}

3) Check if quotes available now

func AreQuotesAvailableNow(account *mt5.MT5Account, symbol string) (bool, error) {
    ctx := context.Background()

    now := time.Now()
    dayOfWeek := int32(now.Weekday())
    currentSeconds := int64(now.Hour()*3600 + now.Minute()*60 + now.Second())

    data, err := account.SymbolInfoSessionQuote(ctx, &pb.SymbolInfoSessionQuoteRequest{
        Symbol:       symbol,
        DayOfWeek:    dayOfWeek,
        SessionIndex: 0,
    })
    if err != nil {
        return false, err
    }

    fromTime := data.From.AsTime()
    toTime := data.To.AsTime()
    fromSeconds := int64(fromTime.Hour()*3600 + fromTime.Minute()*60 + fromTime.Second())
    toSeconds := int64(toTime.Hour()*3600 + toTime.Minute()*60 + toTime.Second())

    available := currentSeconds >= fromSeconds && currentSeconds <= toSeconds

    fmt.Printf("%s quotes available now: %v\n", symbol, available)
    return available, nil
}

📚 See Also