get_gear_price - 获取指定代码的档位行情价格

提示

• level2
• live-or-trading-module-only

原型

get_gear_price(sids)

释义

get_gear_price 是 PTrade 中用于获取指定代码的档位行情价格的接口。

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

参数

返回值

包含以下信息(dict[str:dict[int:list[float,int,int],...],...])：

bid_grp:委买档位(str:dict[int:list[float,int,int],...])；

offer_grp:委卖档位(str:dict[int:list[float,int,int],...])；

单只代码返回：

{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

多只代码返回：

{代码：{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

}

示例

def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

#获取600570.SS当前档位行情

gear_price = get_gear_price('600570.SS')

log.info(gear_price)

#获取600571.SS当前档位行情

gear_price = get_gear_price('600571.SS')

log.info(gear_price)

详细说明

get_gear_price(sids)

使用场景

该函数仅在交易模块可用

接口说明

该接口用于获取指定代码的档位行情价格。

注意事项

获取实时行情快照失败时返回档位内容为空dict({"bid_grp": {}, "offer_grp": {}})。

若无L2行情时，委托笔数字段返回0。

参数详细说明

sids：股票代码(list[str]/str)；

返回值

包含以下信息(dict[str:dict[int:list[float,int,int],...],...])：

bid_grp:委买档位(str:dict[int:list[float,int,int],...])；

offer_grp:委卖档位(str:dict[int:list[float,int,int],...])；

单只代码返回：

{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

多只代码返回：

{代码：{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

}