# 模组函数

模组函数只能在paper_trading 模式下使用。其他模式下无效。

# get_group_count 得到当前已设置模组的数量

get_group_count()

得到当前已设置模组的数量

返回值

​失败返回NONE

范例
#得到模组账户的数量。
count=get_group_count()
print(count)
1
2
3

# get_group_index 取指定序号的模组ID

get_group_index(index)

取得基于0开始序号的模组ID

参数
参数 类型 说明
index int 指定序号,必填项
返回值

​成功返回str类型的模组ID,失败返回NONE

范例
#得到模组账户的数量。
count=get_group_count()
#遍历得到模组ID集合
for i in range(count):
    GID=get_group_index(i)
    print("模组ID " + GID)
1
2
3
4
5
6

# get_group_avg_price 得到指定模组ID下指定品种的持仓均价

get_group_avg_price(groupid, order_book_id, type)

得到指定模组ID下指定品种的持仓均价

参数
参数 类型 说明
groupid str 模组ID,必填项
order_book_id str 合约代码,必填项 如: "SQFU00"
type int 持仓方向:0表示取买持, 1表示取卖持, 2表示任意方向
返回值

​返回float类型,失败返回NONE

范例
#得到模组账户ID集合中的第二个模组账户的id。
GID=get_group_index(1)
#获取"JGROUP0002"模组账户中燃油合约的持仓均价
avg_price=get_group_avg_price(GID, "SQFU00", 2)
print(avg_price)
1
2
3
4
5

# get_group_info 得到指定模组ID的模组运行信息

get_group_info(type, groupid)

得到指定模组ID的模组运行信息

参数
参数 类型 说明
type str 1表示 模组名称
2表示 账户状态(0主账户未登录 1已登录 2已断开 3登录错误)
3表示 账户类型(0期货 1股票 2外盘)
4表示 浮动盈亏
5表示 累计盈亏
6表示 累计费用
7表示 所属主账户
groupid str 模组ID
返回值

   type=1返回str类型
   type=2返回int类型
   type=3返回int类型
   type=4返回float类型
   type=5返回float类型
   type=6返回float类型
   type=7返回str类型
,    失败时返回NONE

范例
#得到模组账户ID集合中的第二个模组账户的id。
GID=get_group_index(1)
#获取"JGROUP0002"模组账户的浮动盈亏
Order_Profit=get_group_avg_price(4, GID)
print(Order_Profit)
1
2
3
4
5

# get_group_hold_count 得到指定模组ID下的持仓品种数量

get_group_hold_count(groupid)

得到指定模组ID下的持仓品种数量

注:

参数
参数 类型 说明
groupid str 模组ID
返回值

返回int类型,失败返回NONE

范例
#得到模组账户ID集合中的第二个模组账户的id。
GID=get_group_index(1)
#获取模组"JGROUP0002"账户下持仓品种的数量
group_hold_count=get_group_hold_count(GID)
print(group_hold_count)
1
2
3
4
5

# get_group_hold_index 得到指定模组ID下的指定序号的持仓品种代码

get_group_hold_index(index, groupid)

得到指定模组ID下的指定序号的持仓品种代码

参数
参数 类型 说明
index int 指定序号
groupid str 模组ID
返回值

返回str类型,失败返回NONE

范例
#得到模组账户ID集合中的第二个模组账户的id。
GID=get_group_index(1)
#获取模组"JGROUP0002"账户下第2条持仓记录对应的品种代码
group_hold_name=get_group_hold_index(1, GID)
print(group_hold_name)
1
2
3
4
5

# get_group_holding 得到指定模组ID下指定品种持仓量

get_group_holding(groupid, order_book_id, type1, type2)

得到指定模组ID下指定品种持仓量

参数
参数 类型 说明
groupid str 模组ID
order_book_id str 合约代码, 如: "SQFU00"
type1 int 持仓方向:0表示取买持, 1表示取卖持, 2表示净持仓量(多仓为正,空仓为负)
type2 int 持仓方向:1表示取总持, 2表示取期货为今仓/股票为可用持仓
返回值

返回int类型,失败返回NONE

范例
#获取模组"JGROUP0002"账户下燃油的多头今仓数量
day_holding=get_group_holding("JGROUP0002", "SQFU00", 0, 2)
print(day_holding)

#获取模组"JGROUP0002"账户下燃油的多头持仓总数量
all_holding=get_group_holding("JGROUP0002", "SQFU00", 0, 2)
print(all_holding)
1
2
3
4
5
6
7