OpenBB/website/content/sdk/reference/portfolio/po/property.md

title, description, keywords

title	description	keywords
property	This documentation discusses the use of 'property' function in OpenBB Terminal's portfolio optimization module. It elaborates on how to call this function with different parameters, its returns, and provides usage examples.	Portfolio Optimization Financial Data OpenBB Portfolio Property Function

import HeadTitle from '@site/src/components/General/HeadTitle.tsx';

Optimize weighted according to property

Source Code: [link]

openbb.portfolio.po.property(symbols: List[str] = None, portfolio_engine: portfolio_optimization.po_engine.PoEngine = None, prop: str = "marketCap", kwargs: Any)

---

Parameters

Name	Type	Description	Default	Optional
portfolio_engine	PoEngine	Portfolio optimization engine, by default None Use portfolio.po.load to load a portfolio engine	None	True
symbols	List[str]	List of symbols, by default None	None	True
prop	str	Property to use for optimization, by default 'marketCap' Use `portfolio.po.get_properties() to get a list of available properties	marketCap	True
interval	str	Interval to get data, by default '3y'	None	True
start_date	str	If not using interval, start date string (YYYY-MM-DD), by default ""	None	True
end_date	str	If not using interval, end date string (YYYY-MM-DD). If empty use last weekday, by default ""	None	True
log_returns	bool	If True use log returns, else arithmetic returns, by default False	None	True
freq	str	Frequency of returns, by default 'D'. Options: 'D' for daily, 'W' for weekly, 'M' for monthly	None	True
maxnan	float	Maximum percentage of NaNs allowed in the data, by default 0.05	None	True
threshold	float	Value used to replace outliers that are higher than threshold, by default 0.0	None	True
method	str	Method used to fill nan values, by default 'time' For more information see interpolate <https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.interpolate.html>__.	None	True
value	float	Amount to allocate to portfolio in long positions, by default 1.0	None	True

---

Returns

Type	Description
Tuple[pd.DataFrame, Dict]	Tuple with weights and performance dictionary

---

Examples

from openbb_terminal.sdk import openbb
openbb.portfolio.po.property(symbols=["AAPL", "MSFT", "AMZN"], prop="forwardPE")

(         value
 AAPL  0.223192
 MSFT  0.215707
 AMZN  0.561101,
 {'Return': 0.18287266638517774,
  'Volatility': 0.3386418179319469,
  'Sharpe ratio': 0.5400179679578959})

from openbb_terminal.sdk import openbb
p = openbb.portfolio.po.load(symbols_file_path="~/openbb_terminal/miscellaneous/portfolio_examples/allocation/60_40_Portfolio.xlsx")
weights, performance = openbb.portfolio.po.property(portfolio_engine=p, prop="forwardPE")

---