namespace IBKRTrader.Core.Trading;

/// <summary>
/// Broker-Abstraktion (Kurse, Konto, Order-Ausführung).
/// Externer Seam: in Tests gemockt, produktiv von einem IBKR-Adapter implementiert.
/// </summary>
public interface IBrokerClient
{
    /// <summary>Aktuelle Kurs-Momentaufnahme oder null, wenn nicht verfügbar.</summary>
    Task<Quote?> GetQuoteAsync(string symbol, CancellationToken ct = default);

    /// <summary>Kontostand-Momentaufnahme.</summary>
    Task<AccountState> GetAccountStateAsync(CancellationToken ct = default);

    /// <summary>Platziert eine Order und gibt das Ergebnis zurück.</summary>
    Task<OrderResult> PlaceOrderAsync(OrderRequest request, CancellationToken ct = default);
}