MT5Service - History Convenience Methods

3 simplified history methods with sensible defaults for common scenarios

---

🎯 Why These Methods Exist

Problem: Getting order history in MT5Account requires many parameters:

var history = await account.OrderHistoryAsync(
    from: DateTime.UtcNow.AddDays(-7),
    to: DateTime.UtcNow,
    sortMode: BMT5_ENUM_ORDER_HISTORY_SORT_TYPE.Bmt5SortByCloseTimeDesc,
    pageNumber: 0,
    itemsPerPage: 100,
    deadline: null,
    cancellationToken: default);

7 parameters just to get last week's orders!

Solution: MT5Service provides simplified methods with defaults:

var history = await service.GetRecentOrdersAsync(days: 7);
var today = await service.GetTodayOrdersAsync();

Simple, clear intent!

Benefits:

• ✅ Sensible defaults (no need to specify every parameter)
• ✅ Clear method names (GetTodayOrders vs manual date calculation)
• ✅ Less code for common scenarios
• ✅ Built-in boolean check for trading permissions

---

📋 All 3 History Methods

Method	What It Does	Default Parameters
GetRecentOrdersAsync(days, limit)	Get orders from last N days	7 days, 100 orders, sorted by close time desc
GetTodayOrdersAsync()	Get today's orders only	1 day, 1000 orders, sorted by close time desc
IsTradingAllowedAsync()	Check if trading is enabled	Returns bool (1 = allowed)

---

💡 Usage Examples

Example 1: Get Recent Orders (Last 7 Days)

// ❌ BEFORE (MT5Account) - 7 parameters:
var history = await account.OrderHistoryAsync(
    from: DateTime.UtcNow.AddDays(-7),
    to: DateTime.UtcNow,
    sortMode: BMT5_ENUM_ORDER_HISTORY_SORT_TYPE.Bmt5SortByCloseTimeDesc,
    pageNumber: 0,
    itemsPerPage: 100,
    deadline: null,
    cancellationToken: default);

// ✅ AFTER (MT5Service) - 1 parameter:
var history = await service.GetRecentOrdersAsync(days: 7);

// Display results
foreach (var order in history.ClosedOrders)
{
    Console.WriteLine($"[{order.TimeClose.ToDateTime():yyyy-MM-dd HH:mm:ss}] " +
                      $"{order.OrderSymbol} {order.OrderType} " +
                      $"Vol: {order.OrderVolumeCurrent} " +
                      $"P/L: ${order.Profit:F2}");
}

Code reduction: 86% (7 parameters → 1 parameter)

---

Example 2: Get Today's Orders

// ❌ BEFORE (MT5Account):
var history = await account.OrderHistoryAsync(
    from: DateTime.UtcNow.Date,                // Start of today (UTC)
    to: DateTime.UtcNow,                       // Now
    sortMode: BMT5_ENUM_ORDER_HISTORY_SORT_TYPE.Bmt5SortByCloseTimeDesc,
    pageNumber: 0,
    itemsPerPage: 1000,
    deadline: null,
    cancellationToken: default);

// ✅ AFTER (MT5Service):
var history = await service.GetTodayOrdersAsync();

Console.WriteLine($"Today's orders: {history.ClosedOrders.Count}");

Readability: Intent is crystal clear!

---

Example 3: Custom Date Range (Still Available!)

// You can still customize if needed:
var lastMonth = await service.GetRecentOrdersAsync(days: 30, limit: 500);
var lastWeek = await service.GetRecentOrdersAsync(days: 7, limit: 100);
var yesterday = await service.GetRecentOrdersAsync(days: 1, limit: 50);

Console.WriteLine($"Last month: {lastMonth.ClosedOrders.Count} orders");
Console.WriteLine($"Last week:  {lastWeek.ClosedOrders.Count} orders");
Console.WriteLine($"Yesterday:  {yesterday.ClosedOrders.Count} orders");

Flexibility: Defaults work for 90% of cases, but customizable when needed!

---

Example 4: Checking Trading Permissions

// ❌ BEFORE (MT5Account) - unwrapping + comparison:
var allowedData = await account.AccountInfoIntegerAsync(
    AccountInfoIntegerPropertyType.AccountTradeAllowed);
bool tradingAllowed = allowedData.Value == 1;

if (!tradingAllowed)
{
    Console.WriteLine("❌ Trading not allowed on this account!");
    return;
}

// ✅ AFTER (MT5Service) - direct boolean:
bool tradingAllowed = await service.IsTradingAllowedAsync();

if (!tradingAllowed)
{
    Console.WriteLine("❌ Trading not allowed on this account!");
    return;
}

Console.WriteLine("✅ Trading is enabled");

Simplicity: Boolean check, no unwrapping, no comparison!

---

Example 5: Daily Trading Report

// Generate report of today's trading activity
var today = await service.GetTodayOrdersAsync();

double totalProfit = 0;
int winningTrades = 0;
int losingTrades = 0;

foreach (var order in today.ClosedOrders)
{
    totalProfit += order.Profit;

    if (order.Profit > 0)
        winningTrades++;
    else if (order.Profit < 0)
        losingTrades++;
}

Console.WriteLine("═══════════════════════════════════");
Console.WriteLine("       Today's Trading Report      ");
Console.WriteLine("═══════════════════════════════════");
Console.WriteLine($"Total Trades:    {today.ClosedOrders.Count}");
Console.WriteLine($"Winning Trades:  {winningTrades}");
Console.WriteLine($"Losing Trades:   {losingTrades}");
Console.WriteLine($"Win Rate:        {(double)winningTrades / today.ClosedOrders.Count * 100:F1}%");
Console.WriteLine($"Total P/L:       ${totalProfit:F2}");
Console.WriteLine("═══════════════════════════════════");

---

Example 6: Recent Performance Analysis

// Analyze last 7 days performance by symbol
var recent = await service.GetRecentOrdersAsync(days: 7);

var symbolStats = recent.ClosedOrders
    .GroupBy(o => o.OrderSymbol)
    .Select(g => new
    {
        Symbol = g.Key,
        Trades = g.Count(),
        TotalProfit = g.Sum(o => o.Profit),
        AvgProfit = g.Average(o => o.Profit),
        WinRate = g.Count(o => o.Profit > 0) / (double)g.Count() * 100
    })
    .OrderByDescending(s => s.TotalProfit);

Console.WriteLine("Last 7 Days - Performance by Symbol:");
Console.WriteLine("────────────────────────────────────────────────────────");
foreach (var stat in symbolStats)
{
    Console.WriteLine($"{stat.Symbol,-10} " +
                      $"Trades: {stat.Trades,3} " +
                      $"P/L: ${stat.TotalProfit,8:F2} " +
                      $"Avg: ${stat.AvgProfit,7:F2} " +
                      $"Win%: {stat.WinRate,5:F1}%");
}

---

Example 7: Pre-Trade Check (Combined with Other Methods)

// Complete pre-trade validation
public async Task<bool> CanTradeAsync()
{
    // 1. Check trading is enabled
    bool tradingAllowed = await service.IsTradingAllowedAsync();
    if (!tradingAllowed)
    {
        Console.WriteLine("❌ Trading not allowed on account");
        return false;
    }

    // 2. Check account has free margin
    double freeMargin = await service.GetFreeMarginAsync();
    if (freeMargin < 100.0)
    {
        Console.WriteLine($"❌ Insufficient free margin: ${freeMargin:F2}");
        return false;
    }

    // 3. Check daily loss limit
    var today = await service.GetTodayOrdersAsync();
    double todayProfit = today.ClosedOrders.Sum(o => o.Profit);
    if (todayProfit < -500.0)
    {
        Console.WriteLine($"❌ Daily loss limit reached: ${todayProfit:F2}");
        return false;
    }

    // 4. Check daily trade limit
    if (today.ClosedOrders.Count >= 50)
    {
        Console.WriteLine($"❌ Daily trade limit reached: {today.ClosedOrders.Count}");
        return false;
    }

    Console.WriteLine("✅ All checks passed, ready to trade!");
    return true;
}

---

Example 8: Export Recent Orders to CSV

// Export last 30 days to CSV file
var history = await service.GetRecentOrdersAsync(days: 30, limit: 1000);

using (var writer = new StreamWriter("trading_history.csv"))
{
    // Header
    writer.WriteLine("CloseTime,Symbol,Type,Volume,OpenPrice,ClosePrice,Profit,Comment");

    // Data rows
    foreach (var order in history.ClosedOrders)
    {
        writer.WriteLine($"{order.TimeClose.ToDateTime():yyyy-MM-dd HH:mm:ss}," +
                         $"{order.OrderSymbol}," +
                         $"{order.OrderType}," +
                         $"{order.OrderVolumeCurrent}," +
                         $"{order.PriceOpen}," +
                         $"{order.PriceCurrent}," +
                         $"{order.Profit}," +
                         $"\"{order.OrderComment}\"");
    }
}

Console.WriteLine($"✅ Exported {history.ClosedOrders.Count} orders to trading_history.csv");

---

🔑 Key Benefits

Aspect	MT5Account (Low-Level)	MT5Service (Convenience)
Parameters	7 required parameters	0-2 parameters with defaults
Date calculation	Manual DateTime.UtcNow.AddDays(-7)	Built-in days: 7
Sort mode	Must specify enum	✅ Sensible default (close time desc)
Page size	Must specify	✅ Sensible default (100/1000)
Intent	OrderHistoryAsync(from, to, ...)	GetTodayOrdersAsync()
Trading check	Integer unwrap + compare	✅ Direct boolean

---

📊 Method Signatures

// Get recent orders
Task<OrdersHistoryData> GetRecentOrdersAsync(
    int days = 7,                         // Default: last 7 days
    int limit = 100,                      // Default: 100 orders
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)

// Get today's orders
Task<OrdersHistoryData> GetTodayOrdersAsync(
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)

// Check trading permission
Task<bool> IsTradingAllowedAsync(
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)

---

📊 Code Reduction Statistics

Task	Lines (MT5Account)	Lines (MT5Service)	Reduction
Get last 7 days	7 parameters	1 parameter	86%
Get today's orders	7 parameters	0 parameters	100%
Check trading allowed	3 lines	1 line	67%

Average reduction: 84% for history operations!

---

🎓 When to Use

✅ Use MT5Service when:

• Need recent history (last N days)
• Want today's orders specifically
• Checking if trading is enabled
• Building reports/analytics
• Common scenarios (90% of cases)

⚠️ Use MT5Account when:

• Need exact date range (not relative days)
• Need custom sort order
• Need pagination (page numbers)
• Building advanced history management

---

💡 Implementation Details

GetRecentOrdersAsync

// What it does internally:
public Task<OrdersHistoryData> GetRecentOrdersAsync(
    int days = 7,
    int limit = 100,
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)
{
    return OrderHistoryAsync(
        from: DateTime.UtcNow.AddDays(-days),
        to: DateTime.UtcNow,
        sortMode: BMT5_ENUM_ORDER_HISTORY_SORT_TYPE.Bmt5SortByCloseTimeDesc,
        pageNumber: 0,
        itemsPerPage: limit,
        deadline: deadline,
        cancellationToken: cancellationToken
    );
}

GetTodayOrdersAsync

// Simply calls GetRecentOrdersAsync with days: 1
public Task<OrdersHistoryData> GetTodayOrdersAsync(
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)
    => GetRecentOrdersAsync(days: 1, limit: 1000, deadline, cancellationToken);

IsTradingAllowedAsync

// Checks AccountTradeAllowed and returns boolean
public async Task<bool> IsTradingAllowedAsync(
    DateTime? deadline = null,
    CancellationToken cancellationToken = default)
{
    var allowed = await AccountInfoIntegerAsync(
        AccountInfoIntegerPropertyType.AccountTradeAllowed,
        deadline,
        cancellationToken);
    return allowed == 1;
}

---

🔗 See Also

• MT5Service Overview - Complete MT5Service improvements
• Account Convenience Methods - Account shortcuts
• Symbol Convenience Methods - Symbol shortcuts
• Trading Convenience Methods - Trading shortcuts
• MT5Account History - Low-level reference

---

💡 Summary

3 history methods with sensible defaults for common scenarios:

// Get recent history - simple!
var lastWeek = await service.GetRecentOrdersAsync(days: 7);
var today = await service.GetTodayOrdersAsync();

// Check trading permission - boolean!
if (await service.IsTradingAllowedAsync())
{
    // Ready to trade!
}

// Custom if needed:
var lastMonth = await service.GetRecentOrdersAsync(days: 30, limit: 500);

Sensible defaults, flexible when needed! 🚀