58 lines
2.6 KiB
C#
58 lines
2.6 KiB
C#
using System;
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
using FinlyticCore.Dtos.Bot;
|
|
using FinlyticCore.Dtos.TechnicalAnalysis;
|
|
|
|
namespace FinlyticBot.Services.Alpaca;
|
|
|
|
/// <summary>
|
|
/// Outcome of a confirmed Alpaca position liquidation (<see cref="IAlpacaTradingService.ClosePositionAsync"/>).
|
|
/// Only ever constructed after Alpaca's REST API has accepted the liquidation order — see the method's
|
|
/// XML doc for why callers may treat its mere existence as proof the broker confirmed the close.
|
|
/// </summary>
|
|
/// <param name="OrderId">The Alpaca order ID of the liquidation (market) order.</param>
|
|
/// <param name="OrderStatus">The Alpaca order status returned immediately after submission (e.g. "Accepted", "Filled").</param>
|
|
/// <param name="AverageFillPrice">
|
|
/// The average fill price if Alpaca already reports one at submission time; <see langword="null"/> when the
|
|
/// liquidation order has been accepted but not yet filled (e.g. outside market hours). Callers must fall back
|
|
/// to the position's last known synced price in that case rather than treating <see langword="null"/> as zero.
|
|
/// </param>
|
|
public record AlpacaPositionCloseResult(string OrderId, string OrderStatus, decimal? AverageFillPrice);
|
|
|
|
public interface IAlpacaTradingService
|
|
{
|
|
bool IsConfigured { get; }
|
|
|
|
Task<string> PlaceBracketOrderAsync(
|
|
string symbol,
|
|
SignalDirection direction,
|
|
decimal quantity,
|
|
decimal entryPrice,
|
|
decimal stopLossPrice,
|
|
decimal takeProfitPrice,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
Task UpdateStopLossAsync(
|
|
string alpacaOrderId,
|
|
decimal newStopLossPrice,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
Task CancelOrderAsync(
|
|
string alpacaOrderId,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// Liquidates the entire open position for <paramref name="symbol"/> at market price via Alpaca's native
|
|
/// position-close endpoint. Returns only once Alpaca has ACCEPTED the liquidation order — a caller (e.g.
|
|
/// the panic-close handler) must only mark the corresponding local position as closed AFTER this call
|
|
/// returns without throwing, never optimistically before calling it.
|
|
/// </summary>
|
|
/// <exception cref="InvalidOperationException">Alpaca is not configured/reachable.</exception>
|
|
Task<AlpacaPositionCloseResult> ClosePositionAsync(
|
|
string symbol,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
Task<AccountSummaryDto> GetPortfolioSummaryAsync(CancellationToken cancellationToken = default);
|
|
}
|