PortfolioStatistics

API documentation for tradeexecutor.state.statistics.PortfolioStatistics Python class in Trading Strategy framework.

class PortfolioStatistics

Bases: object

Portfolio statistics for each timepoint.

Updated with regular ticks for a live strategy.

If backtesting, only calculated_at and total_equity are necessary for later visualisations and metrics If livetrading, then all attributes should be specified so that for displaying updated metrics after each trade

See Statistics.portfolio for reading.

__init__(calculated_at, total_equity, net_asset_value=None, unrealised_profitability=None, share_count=None, share_price_usd=None, free_cash=None, open_position_count=None, open_position_equity=None, frozen_position_count=None, frozen_position_equity=None, closed_position_count=None, unrealised_profit_usd=None, first_trade_at=None, last_trade_at=None, realised_profit_usd=0, summary=None)

Parameters:

• calculated_at (datetime) –

• total_equity (float) –

• net_asset_value (Optional[float]) –

• unrealised_profitability (Optional[float]) –

• share_count (Optional[Decimal]) –

• share_price_usd (Optional[float]) –

• free_cash (Optional[float]) –

• open_position_count (Optional[int]) –

• open_position_equity (Optional[float]) –

• frozen_position_count (Optional[int]) –

• frozen_position_equity (Optional[float]) –

• closed_position_count (Optional[int]) –

• unrealised_profit_usd (Optional[float]) –

• first_trade_at (Optional[datetime]) –

• last_trade_at (Optional[datetime]) –

• realised_profit_usd (Optional[float]) –

• summary (Optional[TradeSummary]) –

Return type:

None

Methods

__init__(calculated_at, total_equity[, ...])
from_dict(kvs, *[, infer_missing])
from_json(s, *[, parse_float, parse_int, ...])
get_value()
schema(*[, infer_missing, only, exclude, ...])
to_dict([encode_json])
to_json(*[, skipkeys, ensure_ascii, ...])

Attributes

calculated_at	Real-time clock when these stats were calculated
total_equity
net_asset_value	How much was TVL equivalent
unrealised_profitability	The unrealised all-time profitability of this strategy at this point of time
share_count	Number of issued shares
share_price_usd	Share price
free_cash
open_position_count
open_position_equity
frozen_position_count
frozen_position_equity
closed_position_count
unrealised_profit_usd
first_trade_at
last_trade_at
realised_profit_usd
summary

calculated_at: datetime

Real-time clock when these stats were calculated

net_asset_value: Optional[float]

How much was TVL equivalent

unrealised_profitability: Optional[float]

The unrealised all-time profitability of this strategy at this point of time

See tradeexecutor.visualisation.equity_curve.calculate_compounding_unrealised_trading_profitability()

Set to 0 if cannot be calculated yet.

share_count: Optional[Decimal]

Number of issued shares

share_price_usd: Optional[float]

Share price

Derived from net asset value / share count

__init__(calculated_at, total_equity, net_asset_value=None, unrealised_profitability=None, share_count=None, share_price_usd=None, free_cash=None, open_position_count=None, open_position_equity=None, frozen_position_count=None, frozen_position_equity=None, closed_position_count=None, unrealised_profit_usd=None, first_trade_at=None, last_trade_at=None, realised_profit_usd=0, summary=None)

Parameters:

• calculated_at (datetime) –

• total_equity (float) –

• net_asset_value (Optional[float]) –

• unrealised_profitability (Optional[float]) –

• share_count (Optional[Decimal]) –

• share_price_usd (Optional[float]) –

• free_cash (Optional[float]) –

• open_position_count (Optional[int]) –

• open_position_equity (Optional[float]) –

• frozen_position_count (Optional[int]) –

• frozen_position_equity (Optional[float]) –

• closed_position_count (Optional[int]) –

• unrealised_profit_usd (Optional[float]) –

• first_trade_at (Optional[datetime]) –

• last_trade_at (Optional[datetime]) –

• realised_profit_usd (Optional[float]) –

• summary (Optional[TradeSummary]) –

Return type:

None