# 模组函数

模组函数只能在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下指定品种的持仓均价

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

函数原型

get_group_avg_price(
    
      groupid: 
      str , # 模组ID   
      order_book_id: 
      str , # 合约代码   
      type: 
      int , # 持仓方向 ) -> 
    float # 返回持仓均价

参数

参数	类型	缺省	必填	说明
groupid	str	-	Y	模组ID
order_book_id	str	-	Y	合约代码，例如：`"SQFU00"`
type	int	-	Y	持仓方向： 0 表示取买持 1 表示取卖持 2 表示任意方向

返回值

状态	返回值	返回类型	说明
成功	`float`	float	返回指定模组账户下该品种的持仓均价
失败	`None`	None	获取失败时返回 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
6
7

# 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 类型
2	返回 int 类型
3	返回 int 类型
4	返回 float 类型
5	返回 float 类型
6	返回 float 类型
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下指定品种持仓量

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

函数原型

get_group_holding(
    
      groupid: 
      str , # 模组ID   
      order_book_id: 
      str , # 合约代码   
      type1: 
      int , # 持仓方向类型   
      type2: 
      int , # 持仓数量类型 ) -> 
    int # 返回持仓数量

参数

参数	类型	缺省	必填	说明
groupid	str	-	Y	模组ID
order_book_id	str	-	Y	合约代码，例如：`"SQFU00"`
type1	int	-	Y	持仓方向： 0 表示取买持 1 表示取卖持 2 表示净持仓量（多仓为正，空仓为负）
type2	int	-	Y	持仓数量类型： 1 表示取总持仓 2 表示期货为今仓 / 股票为可用持仓

返回值

状态	返回值	返回类型	说明
成功	`int`	int	返回指定模组账户下该品种的持仓数量
失败	`None`	None	获取失败时返回 None

范例

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

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

1
2
3
4
5
6
7

← 交易函数数据查询 →