JoinQuant 高级功能：如何在不同子账户（SubPortfolio）间划转资金？

在聚宽（JoinQuant）策略中，要在不同的子账户（subportfolios）之间转移资金，主要使用 transfer_cash 函数。

在此之前，您必须在 initialize 函数中通过 set_subportfolios 初始化多个子账户。

以下是详细的步骤和代码示例：

1. 核心函数说明

transfer_cash(from_pindex, to_pindex, cash)

• 功能：从序号为 from_pindex 的子账户转移资金到序号为 to_pindex 的子账户。资金转移是即时到账的。
• 参数：
  • from_pindex (int): 转出资金的子账户索引（从 0 开始）。
  • to_pindex (int): 转入资金的子账户索引（从 0 开始）。
  • cash (float): 转移的金额。

2. 完整策略代码示例

下面的示例展示了如何初始化两个子账户（一个股票账户，一个期货账户），并在运行过程中将资金从股票账户转移到期货账户。

# -*- coding: utf-8 -*-
from jqdata import *

def initialize(context):
    # 1. 设定基准
    set_benchmark('000300.XSHG')
    
    # 2. 获取初始总资金
    init_cash = context.portfolio.starting_cash
    
    # 3. 初始化子账户 (必须步骤)
    # 这里我们将资金分为两部分，分别用于股票和期货
    # subportfolios[0]: 股票账户，分配 50% 资金
    # subportfolios[1]: 期货账户，分配 50% 资金
    set_subportfolios([
        SubPortfolioConfig(cash=init_cash * 0.5, type='stock'),
        SubPortfolioConfig(cash=init_cash * 0.5, type='futures')
    ])
    
    # 打印初始资金情况
    run_daily(check_and_transfer, time='open')

def check_and_transfer(context):
    # 获取两个子账户的对象
    sub0 = context.subportfolios[0]
    sub1 = context.subportfolios[1]
    
    log.info("转移前 - 账户0(股票)可用资金: %.2f" % sub0.available_cash)
    log.info("转移前 - 账户1(期货)可用资金: %.2f" % sub1.available_cash)
    
    # 示例逻辑：如果账户0的资金大于 100,000，则转移 50,000 到账户1
    transfer_amount = 50000
    
    if sub0.available_cash > transfer_amount:
        log.info("开始执行资金转移...")
        
        # 调用 transfer_cash 进行转账
        # 参数：从索引0转出，转入索引1，金额 transfer_amount
        transfer_cash(from_pindex=0, to_pindex=1, cash=transfer_amount)
        
        log.info("转移后 - 账户0(股票)可用资金: %.2f" % sub0.available_cash)
        log.info("转移后 - 账户1(期货)可用资金: %.2f" % sub1.available_cash)
    else:
        log.info("账户0资金不足，不进行转移。")

def handle_data(context, data):
    pass

3. 注意事项

1. 初始化要求：transfer_cash 仅在您使用 set_subportfolios 配置了多个仓位时才有效。默认情况下策略只有一个仓位（索引为0），此时无法进行转移。
2. 资金检查：在转移前，建议检查转出账户（from_pindex）是否有足够的 available_cash（可用资金）。
3. 索引对应：pindex 对应的是 set_subportfolios 列表中配置的顺序，索引从 0 开始。
4. 即时性：该函数执行后资金立即划转，无需等待下一个交易日。

Q&A

Q: 如果我没有使用 set_subportfolios，可以直接使用 transfer_cash 吗？
A: 不可以。默认情况下策略只有一个账户（subportfolios[0]），没有其他账户可以作为转入或转出的对象。必须先初始化多个子账户。

Q: transfer_cash 可以转移持仓（股票或合约）吗？
A: 不可以。transfer_cash 仅用于转移现金。如果需要调整持仓，需要在对应的子账户中分别进行买卖操作（使用 pindex 参数指定下单账户）。

Q: 资金转移后，context.portfolio.total_value（总资产）会变吗？
A: 不会。资金转移只是在内部子账户之间流动，策略的总权益（Total Value）保持不变。

Q: 可以在回测和模拟交易中使用这个功能吗？
A: 是的，transfer_cash 在回测和模拟交易环境中均可使用。