## 提示

- `live-or-trading-module-only`
- `backtest-only`


## 条目定义

**类型：** 对象属性与字段定义

**官方名称：** `Portfolio`

本条目不是独立可调用函数，用于说明对象属性、数据字段、枚举、日志或平台约定。

## 释义

Portfolio 是 PTrade 文档中的资产对象参考条目。

研究：不支持；回测：支持；模拟：官方目录未明确；实盘：支持。

## 参数

本条目没有独立函数参数。字段、取值或对象属性请查看下方官方详细说明。

## 返回值

本条目不是独立可调用函数，没有单独返回值。

## 示例

```python
def initialize(context):

g.security = "600570.SS"

set_universe([g.security])

def handle_data(context, data):

log.info(context.portfolio.portfolio_value)
```

## 详细说明

### 使用场景

该对象仅支持回测、交易模块。

对象说明

对象数据包含账户当前的资金，标的信息，即所有标的操作仓位的信息汇总

### 注意事项

交易中对象内的数据更新周期默认为6s(具体配置需咨询所在券商)，即上一次账户资金、委托、持仓查询并更新到对象中后，间隔6s发起下一次查询。数据更新时间范围为before_trading_start-after_trading_end。

内容

股票账户返回

cash 当前可用资金(不包含冻结资金)

positions 当前持有的标的(包含不可卖出的标的)，dict类型，key是标的代码，value是Position对象

portfolio_value 当前持有的标的和现金的总价值

positions_value 持仓价值

capital_used 已使用的现金

returns 当前的收益比例, 相对于初始资金

pnl 当前账户总资产-初始账户总资产

start_date 开始时间

期货账户返回：

cash 当前可用资金(不包含冻结资金)

positions 当前持有的标的(包含不可卖出的标的)，dict类型，key是标的代码，value是Position对象

portfolio_value 当前持有的保证金和现金的总价值

positions_value 持仓价值

returns 当前的收益比例, 相对于初始资金

pnl 当前账户总资产-初始账户总资产

start_date 开始时间

margin 保证金