Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

3.4 KB
Raw Blame
// src/algo_engine/PositionManager.h
#pragma once
#include "algo_engine/AlgoEngineTypes.h"

#include <QMutex>

#include <optional>

namespace fincept::algo {

class PositionManager {
  public:
    explicit PositionManager(const QString& deployment_id, double stop_loss_pct, double take_profit_pct,
                             double trailing_stop_pct, double max_order_value, double max_daily_loss);

    std::optional<AlgoOrderSignal> check_risk(double current_price);

    void record_entry(PositionSide side, double qty, double price, int64_t time_ms);
    double record_exit(double qty, double price, int64_t time_ms);

    // Re-seed position + cumulative metrics after an app restart so a resumed
    // deployment continues its open position instead of starting flat.
    void restore_state(PositionSide side, double qty, double entry_price, double total_pnl, int total_trades,
                       double win_rate, double max_drawdown);

    bool has_position() const;
    bool is_paused() const;
    bool validate_order_value(double qty, double price) const;
    // Same ceiling as validate_order_value, for a pre-computed notional. The
    // multi-leg F&O basket path has no single (qty × price) — its notional is a
    // sum over the legs — so it checks the limit through here.
    bool validate_order_notional(double notional) const;

    AlgoPosition position() const;
    AlgoMetrics metrics() const;
    RiskState risk_state() const;
    void update_price(double price);
    void reset_daily();
    // Clears the daily P&L and the loss-limit latch once the local trading date
    // has moved past day_start_epoch; returns true when that rollover happened.
    // Without a caller for this the "daily" loss limit latches for the lifetime
    // of the process — a lifetime limit, not a daily one. The date is taken in
    // local time, matching how day_start_epoch is stamped in the constructor.
    bool reset_daily_if_new_day();

    // Multi-leg (F&O basket) mode — parallel to the single-position equity path.
    void record_entry_legs(const QVector<fincept::algo::AlgoLegPosition>& legs, int64_t time_ms);
    double record_exit_legs(int64_t time_ms);                 // realizes basket P&L, clears legs
    void update_leg_price(const QString& symbol, double ltp); // marks one leg, recomputes basket unrealized
    bool has_legs() const;                                    // multi_leg_ && !legs_.isEmpty()
    QVector<fincept::algo::AlgoLegPosition> legs() const;     // mutex copy

  private:
    void update_drawdown();
    // Raises paused_by_loss_limit once realized daily P&L breaches max_daily_loss_.
    // Assumes mutex_ is already held.
    void latch_daily_loss_if_breached();
    // Body of reset_daily(); assumes mutex_ is already held (QMutex is not
    // recursive, so reset_daily_if_new_day() cannot call reset_daily()).
    void reset_daily_locked();

    QString deployment_id_;
    AlgoPosition position_;
    RiskState risk_;
    AlgoMetrics metrics_;

    double stop_loss_pct_;
    double take_profit_pct_;
    double trailing_stop_pct_;
    double max_order_value_;
    double max_daily_loss_;

    // Multi-leg basket state (P3)
    QVector<fincept::algo::AlgoLegPosition> legs_;
    bool multi_leg_ = false;
    double basket_entry_value_ = 0; // Σ |entry_price * quantity| at entry
    double basket_peak_pnl_ = 0;    // trailing-stop high-water mark (basket P&L)

    mutable QMutex mutex_;
};

} // namespace fincept::algo