Ricequant Docs
  • RQSDK快速上手
  • RQData - 金融数据 API

    • Python API文档
    • Http API文档
  • RQAlpha Plus - 回测框架

    • 使用教程
    • API使用手册 (opens new window)
  • RQFactor - 因子投研工具

    • 使用教程
    • API使用手册
  • RQOptimizer - 股票组合优化器

    • 使用教程
    • API使用手册 (opens new window)
  • RQPAttr - 绩效归因工具

    • 使用教程
  • RQAMS 用户说明文档
  • RQAMSC 说明文档
量化平台文档
米筐帮助中心
返回官网
  • RQSDK快速上手
  • RQData - 金融数据 API

    • Python API文档
    • Http API文档
  • RQAlpha Plus - 回测框架

    • 使用教程
    • API使用手册 (opens new window)
  • RQFactor - 因子投研工具

    • 使用教程
    • API使用手册
  • RQOptimizer - 股票组合优化器

    • 使用教程
    • API使用手册 (opens new window)
  • RQPAttr - 绩效归因工具

    • 使用教程
  • RQAMS 用户说明文档
  • RQAMSC 说明文档
量化平台文档
米筐帮助中心
返回官网
  • RQData金融数据API文档

    • 文档目录
    • 使用说明
    • 跨品种通用API
      • 行情、交易日及合约信息
        • all_instruments - 获取所有合约基础信息
        • instruments - 获取合约详细信息
        • id_convert - 交易所代码转换
        • get_price - 获取合约历史行情数据
        • get_auction_info - 获取股票合约盘后数据
        • get_ticks - 获取日内 tick 数据(试用版)
        • get_live_ticks - 获取日内 tick 数据(支持日内时间切割)
        • get_open_auction_info - 获取盘前集合竞价数据
        • current_minute - 获取最近的分钟线数据
        • get_price_change_rate - 获取历史涨跌幅
        • current_snapshot - 获取当前行情快照
        • get_trading_dates - 获取交易日列表
        • get_previous_trading_date - 获取历史某个交易日
        • get_next_trading_date - 获取未来某个交易日
        • get_latest_trading_date - 获取当前最近一个交易日
        • get_trading_hours - 获取合约连续竞价时间段
        • get_exchange_rate - 获取汇率信息
        • get_yield_curve - 获取收益率曲线
        • get_live_minute_price_change_rate - 获取当日分钟涨跌幅(股票,指数)
        • get_future_latest_trading_date - 获取当前最近一个期货交易日
        • get_vwap - 获取日/分钟级别的 vwap 历史数据
      • 实时行情推送
        • LiveMarketDataClient - websocket 实时行情推送方案
    • A股
    • 港股(公测版本)
    • 金融、商品期货
    • 金融、商品期权
    • 指数、场内基金
    • 基金
    • 可转债
    • 风险因子
    • 现货
    • 货币市场
    • 宏观经济
    • 一致预期(今日投资合作)
    • 新闻舆情(数库合作)
    • ESG(秩鼎合作)
    • 财务指标数据字典
    • 技术指标数据字典
    • 米筐特色指数
    • 更新履历

# 行情、交易日及合约信息

# all_instruments - 获取所有合约基础信息

all_instruments(type=None, market='cn', date=None)

获取某个国家市场的所有合约信息。使用者可以通过这一方法很快地对合约信息有一个快速了解,目前仅支持中国市场。
可传入date筛选指定日期的合约,返回的 instrument 数据为合约的最新情况。

# 参数

参数 类型 说明
type str 需要查询合约类型,例如:type='CS'代表股票。默认是所有类型
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场
date str, datetime.date, datetime.datetime, pandasTimestamp 指定日期,筛选指定日期可交易的合约

其中 type 参数传入的合约类型和对应的解释如下:

合约类型 说明
CS Common Stock, 即股票
ETF Exchange Traded Fund, 即交易所交易基金
LOF Listed Open-Ended Fund,即上市型开放式基金 (以下分级基金已并入)
INDX Index, 即指数
Future Futures,即期货,包含股指、国债和商品期货
Spot Spot,即现货,目前包括上海黄金交易所现货合约
Option 期权,包括目前国内已上市的全部期权合约
Convertible 沪深两市场内有交易的可转债合约
Repo 沪深两市交易所交易的回购合约

# 返回

pandas DataFrame - 所有合约的基本信息。
详细字段注释请参考 instruments 返回字段说明

# 范例

  • 获取中国内地市场所有合约的基础信息:
[In]all_instruments()
[Out]
    abbrev_symbol order_book_id  sector_code symbol
0 XJDQ 000400.XSHE   Industrials     许继电气
1 HXN     002582.XSHE   ConsumerStaples 好想你
2 NFGF 300004.XSHE   Industrials     南风股份
3 FLYY 002357.XSHE   Industrials     富临运业
...
  • 获取中国内地市场所有 LOF 基金的基础信息:
[In]all_instruments(type='LOF')
[Out]
    abbrev_symbol order_book_id product sector_code  symbol
0 CYGA 150303.XSHE null null 华安创业板50A
1 JY500A 150088.XSHE null null 金鹰500A
2 TD500A 150053.XSHE null null 泰达稳健
3 HS500A 150110.XSHE null null 华商500A
4 QSAJ 150235.XSHE null null 鹏华证券A
...
  • 获取中国内地市场所有期货的基础信息:
[In]all_instruments(type='Future')
[Out]
 abbrev_symbol order_book_id product sector_code symbol
0 MH0610 CF0610 Commodity null 棉花0610
1 LD0209 GN0209 Commodity null 绿豆0209
...
3615 HS1301 IF1301 Index null 沪深1301
...
  • 获取中国内地市场指定日期可交易的期货的基础信息:
[In]all_instruments(type='Future', date='20160412')
[Out]
 abbrev_symbol order_book_id product symbol
0 HJ0809 AU0809 Commodity 黄金0809
1 MH1301 CF1301 Commodity 棉花1301
...
4226 XC1103 WR1103 Commodity 线材1103
...
  • 获取中国内地市场场内交易的可转债的基础信息:
[In]all_instruments(type='Convertible')
[Out]
  de_listed_date  exchange  listed_date  market_tplus  order_book_id  round_lot  status  symbol  type
0  2013-01-29  XSHG  2007-03-08  0  126003.XSHG  10  Delisted  07云化债  Convertible
1  2016-09-22  XSHG  2008-10-10  0  126018.XSHG  10  Delisted  08江铜债  Convertible
2  2015-06-02  XSHE  2013-08-19  0  128002.XSHE  10  Delisted  东华转债  Convertible
3  2015-02-26  XSHG  2010-09-10  0  113002.XSHG  10  Delisted  工行转债  Convertible
4  0000-00-00  XSHE  2019-01-21  0  128052.XSHE  10  Active  凯龙转债  Convertible
...

# instruments - 获取合约详细信息

instruments(order_book_ids, market='cn')

获取某个国家市场内一个或多个合约最新的详细信息。目前仅支持中国市场。

# 参数

参数 类型 说明
order_book_ids str OR str list 合约代码,可传入 order_book_id, order_book_id list。
中国市场的 order_book_id 通常类似'000001.XSHE'。需要注意,国内股票、ETF、指数合约代码分别应当以'.XSHG'或'.XSHE'结尾,前者代表上证,后者代表深证。
比如查询平安银行这个股票合约,则键入'000001.XSHE',前面的数字部分为交易所内这个股票的合约代码,后半部分为对应的交易所代码。
期货则无此要求
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场

# 返回

一个 instrument 对象,或一个 instrument list。

目前系统并不支持跨国家市场的同时调用。传入的 order_book_id list 必须属于同一国家市场,不能混合着中美两个国家市场的 order_book_id。

  • 股票,ETF,指数 Instrument 对象
字段 类型 说明
order_book_id str 证券代码,证券的独特的标识符。应以'.XSHG'或'.XSHE'或'.XHKG'结尾。 '.XSHG' - 上证,'.XSHE' - 深证, '.XHKG' - 港股
symbol str 证券的简称,例如'平安银行'
abbrev_symbol str 证券的名称缩写,在中国 A 股就是股票的拼音缩写。例如:'PAYH'就是平安银行股票的证券名缩写
round_lot int 一手对应多少股,中国 A 股一手是 100 股
sector_code str 板块缩写代码,全球通用标准定义
sector_code_name str 以当地语言为标准的板块代码名
industry_code str 国民经济行业分类代码,具体可参考下方“Industry 列表”
industry_name str 国民经济行业分类名称
listed_date str 该证券上市日期
issue_price float 该证券发行价 (元)
de_listed_date str 退市日期
type str 合约类型,目前支持的类型有: 'CS', 'INDX', 'LOF', 'ETF', 'Future'
underlying_order_book_id已废弃 str 追踪基准的合约代码。目前仅限'ETF','LOF'
underlying_name 已废弃 str 追踪基准的合约名称。目前仅限'ETF','LOF'
concept_names 已废弃 str 概念股分类,例如:'铁路基建','基金重仓'等
exchange str 交易所,'XSHE' - 深交所, 'XSHG' - 上交所
board_type str 板块类别,'MainBoard' - 主板,'GEM' - 创业板,'SME' - 中小企业板,'KSH' - 科创板
status str 合约状态。'Active' - 正常上市, 'Delisted' - 终止上市, 'TemporarySuspended' - 暂停上市, 'PreIPO' - 发行配售期间, 'FailIPO' - 发行失败
special_type str 特别处理状态。'Normal' - 正常上市, 'ST' - ST 处理, 'StarST' - *ST 代表该股票正在接受退市警告, 'PT' - 代表该股票连续 3 年收入为负,将被暂停交易, 'Other' - 其他
trading_hours str 合约最新的交易时间,如需历史数据请使用get_trading_hours
least_redeem str 最低申赎份额,仅对 ETF 基金展示
cross_market str 沪深港通标识。True-支持,False-不支持。仅对港股生效
least_redeem str 最低申赎份额,仅对 ETF 基金展示
market_tplus str 交易制度,0'表示 T+0,'1'表示 T+1,往后顺推
purchasedate str 申购日期
  • 期货 Instrument 对象
字段 类型 说明
order_book_id str 期货代码,期货的独特的标识符(郑商所期货合约数字部分进行了补齐。例如原有代码'ZC609'补齐之后变为'ZC1609')。主力连续合约 UnderlyingSymbol+88,例如'IF88' ;指数连续合约命名规则为 UnderlyingSymbol+99
symbol str 期货的简称,例如'沪深 1005'
margin_rate float 期货合约的最低保证金率
round_lot float 期货全部为 1.0
listed_date str 期货的上市日期。主力连续合约与指数连续合约都为'0000-00-00'
de_listed_date str 期货的退市日期。
industry_name str 行业分类名称
trading_code str 交易代码
market_tplus str 交易制度。'0'表示 T+0,'1'表示 T+1,往后顺推
type str 合约类型,'Future'
contract_multiplier float 合约乘数,例如沪深 300 股指期货的乘数为 300.0
underlying_order_book_id str 合约标的代码,目前除股指期货(IH, IF, IC)之外的期货合约,这一字段全部为'null'
underlying_symbol str 合约标的名称,例如 IF1005 的合约标的名称为'IF'
maturity_date str 期货到期日。主力连续合约与指数连续合约都为'0000-00-00'
exchange str 交易所,'DCE' - 大连商品交易所, 'SHFE' - 上海期货交易所,'CFFEX' - 中国金融期货交易所, 'CZCE'- 郑州商品交易所, 'INE' - 上海国际能源交易中心
trading_hours str 合约最新的交易时间,如需历史数据请使用get_trading_hours
product str 合约种类,'Commodity'-商品期货,'Index'-股指期货,'Government'-国债期货
start_delivery_date str 开始交割日
end_delivery_date str 结束交割日
  • 期权 Instrument 对象
字段 类型 说明
order_book_id str 合约代码,50ETF 期权为数字代码,例如 10000615
symbol str 合约简称
round_lot float 最小下单手数,期权全部为 1.0
listed_date str 合约上市日期
type str 合约类型,'Option' 代表期权
contract_multiplier float 合约乘数,50ETF 期权只保存分红调整后的最新数据,变动历史请参考日线数据
underlying_order_book_id str 合约标的代码
underlying_symbol str 合约所属品种
maturity_date str 合约到期日
exchange str 交易所,'DCE' - 大连商品交易所, 'SHFE' - 上海期货交易所,'CFFEX' - 中国金融期货交易所, 'CZCE'- 郑州商品交易所, 'INE' - 上海国际能源交易中心
strike_price float 期权行权价,50ETF 期权只保存分红调整后的最新数据,变动历史请参考日线数据
option_type str 'C' 代表认购,'P'代表认沽
exercise_type str 'E' 代表欧式期权,'A' 代表美式期权
market_tplus str 交易制度, '0'表示 T+0,'1'表示 T+1,往后顺推
product_name str ETF 期权字母简称
  • 现货 Instrument 对象
字段 类型 说明
order_book_id str 合约代码
symbol str 合约简称
exchange str 交易所,'SGEX' - 上海黄金期货交易所
listed_date str 合约上市日期
de_listed_date str 退市日期
type str 合约类型,'Spot' 代表现货
trading_hours str 合约最新的交易时间,如需历史数据请使用get_trading_hours
market_tplus str 交易制度, '0'表示 T+0,'1'表示 T+1,往后顺推
  • 可转债 Instrument 对象
字段 类型 说明
order_book_id str 合约代码
symbol str 合约简称
exchange str 交易所,'XSHE' - 深交所,'XSHG' - 上交所
listed_date str 合约上市日期
de_listed_date str 退市日期
type str 合约类型,'Spot' 代表现货
market_tplus str 交易制度, '0'表示 T+0,'1'表示 T+1,往后顺推

Instrument 对象也支持如下方法:

  • 合约已上市天数。
days_from_listed(date=None)

默认返回合约上市距离当前日期的天数。date 支持 str,
如果合约首次上市交易,天数为 0;如果合约尚未上市或已经退市,则天数值为-1

  • 合约距离到期天数。
days_to_expire(date=None)

如果策略已经退市,则天数值为-1

# 范例

  • 获取单一股票合约的详细信息:
In [5]: instruments('000001.XSHE')
Out[5]: Instrument(order_book_id='000001.XSHE', industry_code='J66', market_tplus=1, symbol='平安银行', special_type='Normal', exchange='XSHE', status='Active', type='CS', de_listed_date='0000-00-00', listed_date='1991-04-03', sector_code_name='金融', abbrev_symbol='PAYH', sector_code='Financials', round_lot=100, trading_hours='09:31-11:30,13:01-15:00', board_type='MainBoard', industry_name='货币金融服务', issue_price=40.0, citics_industry_code='40', citics_industry_name='银行')
  • 获取多个股票合约的详细信息:
[In]instruments(['000001.XSHE', '000024.XSHE'])
[Out]
[Instrument(order_book_id='000001.XSHE', industry_code='J66', market_tplus=1, symbol='平安银行', special_type='Normal', exchange='XSHE', status='Active', type='CS', de_listed_date='0000-00-00', listed_date='1991-04-03', sector_code_name='金融', abbrev_symbol='PAYH', sector_code='Financials', round_lot=100, trading_hours='09:31-11:30,13:01-15:00', board_type='MainBoard', industry_name='货币金融服务',industry_name='银行'),
 Instrument(order_book_id='000024.XSHE', industry_code='K70', market_tplus=1, symbol='招商地产', special_type='Normal', exchange='XSHE', status='Delisted', type='CS', de_listed_date='2015-12-30', listed_date='1993-06-07', sector_code_name='房地产', abbrev_symbol='ZSDC', sector_code='RealEstate', round_lot=100, trading_hours='09:31-11:30,13:01-15:00', board_type='MainBoard', industry_name='房地产业')]
  • 获取期权合约基础信息
[In]: instruments('10000615')
[Out]
Instrument(listed_date='2016-04-28', exchange='XSHG', underlying_symbol='510050.XSHG', symbol='510050C1612A02050', underlying_order_book_id='510050.XSHG', round_lot=1, de_listed_date='2016-12-28', maturity_date='2016-12-28', option_type='C', exercise_type='E', type='Option', contract_multiplier=10220, strike_price=2.006, order_book_id='10000615', market_tplus=0, trading_hours='09:31-11:30,13:01-15:00')
  • 获取 000001.XSHE 20160801 该天距离合约上市日天数:
[In]instruments('000001.XSHE').days_from_listed('20160801')
[Out]
9252
  • 获取期权合约 10000068 20150320 该天距离合约上市日天数:
[In]instruments('10000068').days_from_listed('20150320')
[Out]
3
  • 获取 IF1608 20160801 该天距离合约到期日天数:
[In]instruments('IF1608').days_to_expire('20160801')
[Out]
18
  • 获取 ZN2105C20000 20160801 该天距离合约到期日天数:
[In] instruments('ZN2105C20000').days_to_expire('20201225')
[Out]
122

# id_convert - 交易所代码转换

id_convert(order_book_ids,to='normal')

将交易所和其他平台的股票代码转换成米筐的标准合约代码,目前仅支持 A 股、期货和期权代码转换。
例如, 支持转换类型包括 000001.SZ, 000001SZ, SZ000001 转换为 000001.XSHE

# 参数

参数 类型 说明
order_book_ids str or str list 合约代码(来自米筐或交易所或其他平台)
to str 'normal':由米筐代码转化为交易所和其他平台的代码
不填:由交易所和其他平台的代码转化为米筐代码

# 返回

  • 传入一个 order_book_ids,函数会返回一个标准化合约代码字符串。
  • 传入一个 order_book_ids 列表,函数会返回一个标准化合约代码字符串 list。

# 范例

  • 获取其他平台标准合约代码:
[In]id_convert('000001.XSHE', to='normal')
[Out]
'000001.SZ'
  • 获取单一股票的米筐标准合约代码:
[In]id_convert('000935.SH')
[Out]
'000935.XSHG'
  • 获取多个股票的米筐标准合约代码:
[In]id_convert(['000001.SZ', '000935.SH'])
[Out]
['000001.XSHE', '000935.XSHG']
  • 获取单一期货的米筐标准合约代码:
[In]id_convert('AP810')
[Out]
'AP1810'
  • 获取单一期货的米筐标准合约代码_CTP 代码:
[In]id_convert('ZC001.CZCE')
[Out]
'ZC2001'
  • 获取单一期权的米筐标准合约代码_CTP 代码:
[In]id_convert('m1901-C-2500')
[Out]
'M1901C2500'
  • 获取单一期权的米筐标准合约代码_CTP 代码:
[In]id_convert('SR901C4400')
[Out]
'SR1901C4400'

# get_price - 获取合约历史行情数据

get_price(order_book_ids, start_date='2013-01-04', end_date='2014-01-04', frequency='1d', fields=None, adjust_type='pre', skip_suspended =False, market='cn', expect_df=True,time_slice=None)

获取指定合约或合约列表的历史数据(包含起止日期,周线、日线或分钟线)。目前仅支持中国市场的股票、期货、ETF、常见指数和上金所现货的行情数据,如黄金、铂金和白银产品。
注: 如需大量获取分钟或 tick 数据,建议以单只合约为单位,并设置长时段获取以提高效率。

# 参数

参数 类型 说明
order_book_ids str OR str list 合约代码,可传入 order_book_id, order_book_id list
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期
frequency str 历史数据的频率。 现在支持周/日/分钟/tick 级别的历史数据,默认为'1d'。
1m - 分钟线
1d - 日线
1w - 周线,只支持'1w'
日线和分钟可选取不同频率,例如'5m'代表 5 分钟线。
fields str OR str list 字段名称
adjust_type str 权息修复方案,默认为pre。
不复权 - none,
前复权 - pre,后复权 - post,
前复权 - pre_volume, 后复权 - post_volume
两组前后复权方式仅 volume 字段处理不同,其他字段相同。其中'pre'、'post'中的 volume 采用拆分因子调整;'pre_volume'、'post_volume'中的 volume 采用复权因子调整。
skip_suspended bool 是否跳过停牌数据。默认为 False,不跳过,用停牌前数据进行补齐。True 则为跳过停牌期。
expect_df bool 默认返回 pandas dataframe。如果调为 False,则返回原有的数据结构,周线数据需设置 expect_df=True
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;
time_slice str, datetime.time 开始、结束时间段。默认返回当天所有数据。
支持分钟 / tick 级别的切分,详见下方范例。

# 返回

注意: 周线数据目前只支持'1w',依据日线数据进行合成,例如股票周线的前复权数据使用前复权日线数据进行合成,股票周线的不复权数据使用不复权的日线数据合成。

  • bar 数据
字段 类型 说明
open float 开盘价
close float 收盘价
high float 最高价
low float 最低价
limit_up float 涨停价
limit_down float 跌停价
total_turnover float 成交额
volume float 成交量
num_trades int 成交笔数 (仅支持股票、ETF、LOF、可转债;提供范围为 2021-06-25 至今)
prev_close float 昨日收盘价 (交易所披露的原始昨收价,复权方法对该字段无效)
settlement float 结算价 (仅限期货期权日线数据)
prev_settlement float 昨日结算价(仅限期货期权日线数据)
open_interest float 累计持仓量(期货期权专用)
trading_date pandasTimeStamp 交易日期(仅限期货分钟线数据),对应期货夜盘的情况
dominant_id str 实际合约的 order_book_id,对应期货 888 系主力连续合约的情况
strike_price float 行权价,仅限期权日线数据
contract_multiplier float 合约乘数,仅限期权日线数据
iopv float 场内基金实时估算净值
day_session_open float 日盘开盘价(仅限期货期权日线数据)
  • tick 数据
字段 类型 说明
open float 当日开盘价
high float 当日最高价
low float 当日最低价
last float 最新价
prev_close float 昨日收盘价
total_turnover float 当天累计成交额
volume float 当天累计成交量
num_trades int 成交笔数 (仅支持股票、ETF、LOF、可转债;提供范围为 2021-06-25 至今)
limit_up float 涨停价
limit_down float 跌停价
open_interest float 累计持仓量
datetime datetime.datetime 交易所时间戳
a1~a5 float 卖一至五档报盘价格
a1_v~a5_v float 卖一至五档报盘量
b1~b5 float 买一至五档报盘价
b1_v~b5_v float 买一至五档报盘量
change_rate float 涨跌幅
trading_date pandasTimeStamp 交易日期,对应期货夜盘的情况
prev_settlement float 昨日结算价(仅期货有效)
iopv float 场内基金实时估算净值

# 范例

  • 获取单一期货 20220512 - 20220513 每个交易日夜盘 23:55 至日盘 09:05 的历史分钟行情(返回pandas DataFrame):
[In] get_price('AG2209', start_date='20220512', end_date='20220513',frequency='1m',time_slice=('23:55', '09:05'),expect_df=False)
[Out]
                    volume close trading_date open_interest low total_turnover open high
datetime
2022-05-11 23:55:00 25.0 4795.0 2022-05-12 37996.0 4794.0 1797975.0 4796.0 4796.0
2022-05-11 23:56:00 2.0 4795.0 2022-05-12 37996.0 4795.0 143850.0 4795.0 4795.0
...
2022-05-13 09:04:00 81.0 4662.0 2022-05-13 40338.0 4662.0 5665485.0 4664.0 4665.0
2022-05-13 09:05:00 20.0 4661.0 2022-05-13 40333.0 4660.0 1398405.0 4662.0 4662.0
  • 获取单一股票 20220512 - 20220513 每个交易日 10:00 - 11:00 的历史分钟行情(返回pandas DataFrame):
[In] get_price('000001.XSHE', start_date='20220512', end_date='20220513',frequency='1m', time_slice=(datetime.time(hour=10, minute=0), datetime.time(hour=11, minute=0)),expect_df=False)
[Out]
                    volume close num_trades low total_turnover open high
datetime
2022-05-12 10:00:00 1108700.0 14.39 545.0 14.36 15928007.0 14.36 14.39
2022-05-12 10:01:00 351300.0 14.40 427.0 14.37 5052195.0 14.39 14.40
2022-05-12 10:02:00 138400.0 14.39 301.0 14.38 1990834.0 14.38 14.39
...
2022-05-13 10:58:00 481100.0 14.52 309.0 14.52 6990489.0 14.55 14.55
2022-05-13 10:59:00 230700.0 14.52 190.0 14.51 3348303.0 14.51 14.52
2022-05-13 11:00:00 227700.0 14.53 210.0 14.51 3306559.0 14.51 14.53
  • 获取单一股票不复权的历史周线行情(返回pandas DataFrame):
[In] get_price('000001.XSHE',start_date='2015-04-01', end_date='2015-04-12',frequency='1w',adjust_type='none',expect_df=True)
[Out]
  total_turnover low open close volume num_trades high
order_book_id date
000001.XSHE 2015-04-10 2.281686e+10 16.15 16.15 19.8 1.284539e+09 554132.0 19.8
  • 获取单一股票历史日线行情(返回pandas DataFrame):
[In]get_price('000001.XSHE', start_date='2015-04-01', end_date='2015-04-12',expect_df=False)
[Out]
 close  limit_up  high  num_trades  total_turnover  volume  low  limit_down  open
2015-04-01  10.5038  11.4054  10.6222  72105.0  2.608977e+09  236637563.0  10.2339  9.3323  10.4116
2015-04-02  10.3985  11.5568  10.6222  72424.0  2.222671e+09  202440588.0  10.2800  9.4507  10.5893
2015-04-03  10.4314  11.4383  10.4906  61025.0  2.262844e+09  206631550.0  10.2734  9.3586  10.3326
2015-04-07  11.0632  11.4778  11.1619  131387.0  4.898119e+09  426308008.0  10.6288  9.3915  10.6288
2015-04-08  11.7937  12.1688  11.8990  135077.0  5.784459e+09  485517069.0  10.9579  9.9575  11.1421
2015-04-09  11.8463  12.9717  12.5374  148293.0  5.794632e+09  456921108.0  11.6686  10.6156  11.8134
2015-04-10  13.0310  13.0310  13.0310  139375.0  6.339649e+09  480990210.0  11.7476  10.6617  11.8463
  • 获取单一股票历史日线行情(未经复权处理的原始数据,返回pandas DataFrame):
[In]get_price('000001.XSHE', start_date='2015-04-01', end_date='2015-04-03', adjust_type='none',expect_df=False)
[Out]
open close high low total_turnover volume limit_up limit_down
2015-04-01 15.82 15.96 16.14 15.55 2.608977e+09 164331641.0 17.33 14.18
2015-04-02 16.09 15.80 16.14 15.62 2.222671e+09 140583742.0 17.56 14.36
2015-04-03 15.70 15.85 15.94 15.61 2.262844e+09 143494132.0 17.38 14.22
  • 获取单一股票历史分钟线收盘价(返回pandas Series):
[In]get_price('000001.XSHE', start_date='2015-04-01', end_date='2015-04-12', fields='close',frequency='1m',expect_df=False)
[Out]
2015-04-01 09:31:00    10.5621
2015-04-01 09:32:00    10.5354
2015-04-01 09:33:00    10.5287
2015-04-01 09:34:00    10.5354
2015-04-01 09:35:00    10.5420
2015-04-01 09:36:00    10.5688
2015-04-01 09:37:00    10.5955
2015-04-01 09:38:00    10.5487
2015-04-01 09:39:00    10.5354
2015-04-01 09:40:00    10.5354
Name: close, dtype: float64
  • 获取单一股票历史分钟线收盘价,指定返回 dataframe 形式:
[In]get_price('000001.XSHE', start_date='2015-04-01', end_date='2015-04-12', fields='close',frequency='1m',expect_df=True)
[Out]
                                    close
order_book_id  datetime
000001.XSHE  2015-04-01 09:31:00  10.3985
              2015-04-01 09:32:00  10.3721
              2015-04-01 09:33:00  10.3655
  • 获取单一股票历史 tick 行情(返回pandas DataFrame)
[In]get_price('000001.XSHE', start_date='20180321', end_date='20180321', frequency='tick',expect_df=False)
[Out]
 trading_date open last high low prev_close volume total_turnover limit_up limit_down ... a2_v a3_v a4_v a5_v b1_v b2_v b3_v b4_v b5_v change_rate
datetime
2018-03-21 09:15:00 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.000000
2018-03-21 09:15:09 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 31440.0 960.0 0.0 0.0 0.0 0.000000
2018-03-21 09:15:18 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 75280.0 820.0 0.0 0.0 0.0 0.000000
2018-03-21 09:15:27 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 75280.0 3520.0 0.0 0.0 0.0 0.000000
2018-03-21 09:15:36 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 183780.0 33720.0 0.0 0.0 0.0 0.000000
2018-03-21 09:15:54 2018-03-21 11.95 11.82 0.0000 0.00 11.82 0.0 0.000000e+00 13.0 10.64 ... 0.0 0.0 0.0 0.0 183780.0 34720.0 0.0 0.0 0.0 0.000000
...
  • 获取股票列表历史 tick 行情(返回pandas DataFrame)
[In]get_price(['000001.XSHE', '000002.XSHE'], start_date='2019-04-01', end_date='2019-04-01',frequency='tick')
[Out]
                                  trading_date   open   last   high    low  prev_close       volume  ...      a5_v       b1_v      b2_v      b3_v      b4_v      b5_v  change_rate
order_book_id datetime                                                                               ...
000002.XSHE   2019-04-01 09:15:00   2019-04-01   0.00  30.72   0.00   0.00       30.72          0.0  ...       0.0     1100.0       0.0       0.0       0.0       0.0     0.000000
              2019-04-01 09:15:09   2019-04-01   0.00  30.72   0.00   0.00       30.72          0.0  ...       0.0   158400.0       0.0       0.0       0.0       0.0     0.000000
              2019-04-01 09:15:18   2019-04-01   0.00  30.72   0.00   0.00       30.72          0.0  ...       0.0   164300.0       0.0       0.0       0.0       0.0     0.000000
···
000001.XSHE   2019-04-01 14:56:33   2019-04-01  12.83  13.19  13.55  12.83       12.82  192947985.0  ...  574800.0   201700.0  605367.0  107200.0  180800.0  254236.0     0.028861
              2019-04-01 14:56:36   2019-04-01  12.83  13.19  13.55  12.83       12.82  192963385.0  ...  574800.0   219000.0  605367.0  106400.0  180800.0  254336.0     0.028861
              2019-04-01 14:56:39   2019-04-01  12.83  13.19  13.55  12.83       12.82  192979885.0  ...  574800.0   236200.0  605367.0  106400.0  180800.0  254236.0     0.028861
···
  • 获取单一股票历史15 分钟线行情(返回pandas DataFrame):
[In]get_price('000001.XSHE', start_date='2015-04-01', end_date='2015-04-01', frequency='15m',expect_df=False)
[Out]
 total_turnover close low open high volume
index
2015-04-01 09:45:00 348982890.0 10.6215 10.6215 10.7300 10.7843 31848628
2015-04-01 10:00:00 234445219.0 10.5808 10.5469 10.6283 10.6350 21618354
2015-04-01 10:15:00 125882985.0 10.6757 10.5808 10.5808 10.7368 11540023
2015-04-01 10:30:00 144396901.0 10.6622 10.6215 10.6757 10.7503 13190460
2015-04-01 10:45:00 169238918.0 10.7368 10.6554 10.6622 10.7775 15409772
2015-04-01 11:00:00 131464598.0 10.7232 10.6961 10.7436 10.7503 11977847
2015-04-01 11:15:00 83455348.0 10.7368 10.7164 10.7300 10.7639 7589260
...
  • 获取股票列表历史日线收盘价(返回pandas DataFrame):
[In]get_price(['000024.XSHE', '000001.XSHE', '000002.XSHE'], start_date='2015-04-01', end_date='2015-04-12', fields='close',expect_df=False)
[Out]
000024.XSHE 000001.XSHE 000002.XSHE
2015-04-01 32.1251 10.8249 12.7398
2015-04-02 31.6400 10.7164 12.6191
2015-04-03 31.6400 10.7503 12.4891
2015-04-07 31.6400 11.4015 12.7398
2015-04-08 31.6400 12.1543 12.8327
2015-04-09 31.6400 12.2086 13.5941
2015-04-10 31.6400 13.4294 13.2969
  • 获取股票列表历史日线行情(返回pandas DataPanel):
[In]get_price(['000024.XSHE', '000001.XSHE', '000002.XSHE'], start_date='2015-04-01', end_date='2015-04-12',expect_df=False)
[Out]
<class 'rqcommons.pandas_patch.HybridDataPanel'>
Dimensions: 8 (items) x 7 (major_axis) x 3 (minor_axis)
Items axis: open to limit_down
Major_axis axis: 2015-04-01 00:00:00 to 2015-04-10 00:00:00
Minor_axis axis: 000024.XSHE to 000002.XSHE
  • 获取单一期货合约历史日线行情(返回pandas DataFrame):
[In]get_price('A1601', start_date='2015-04-01', end_date='2015-04-12')
[Out]
               open  close      high      low     total_turnover  volume    settlement    prev_settlement  open_interest      limit_up    limit_down
2015-04-01 4188.0 4210.0 4231.0 4188.0 168002700.0           3988.0   4212        4204.0         42406.0          4372.0    4036.0
2015-04-02 4212.0 4192.0 4228.0 4192.0 191554400.0           4550.0   4209        4212.0         44986.0          4380.0    4044.0
2015-04-03 4191.0 4157.0 4191.0 4149.0 336611000.0           8092.0   4159        4209.0         47632.0          4377.0    4041.0
2015-04-07 4155.0 4122.0 4164.0 4121.0 213253200.0           5150.0   4140        4159.0         50678.0          4325.0    3993.0
2015-04-08 4102.0 4103.0 4123.0 4082.0 231593500.0           5646.0   4101        4140.0         50758.0          4305.0    3975.0
2015-04-09 4098.0 4069.0 4106.0 4062.0 217864900.0           5344.0   4076        4101.0         52028.0          4265.0    3937.0
2015-04-10 4068.0 4069.0 4105.0 4062.0 105630900.0           2592.0   4075        4076.0         52142.0          4239.0    3913.0
  • 获取单一期货合约历史 tick 行情(返回pandas DataFrame):
[In]get_price('IF1608', '20160801', '20160801', 'tick',expect_df=False).head()
[Out]
trading_date    open    last    high     low  \
datetime
2016-08-01 09:29:00.000   2016-08-01  3174.0  3174.0  3174.0  3174.0
2016-08-01 09:30:00.000   2016-08-01  3174.0  3174.0  3180.8  3174.0
2016-08-01 09:30:00.500   2016-08-01  3174.0  3176.8  3180.8  3174.0
2016-08-01 09:30:01.000   2016-08-01  3174.0  3176.6  3180.8  3174.0
2016-08-01 09:30:01.500   2016-08-01  3174.0  3178.0  3180.8  3174.0
                         prev_settlement  prev_close  volume  open_interest  \
datetime
2016-08-01 09:29:00.000           3184.6      3181.8    61.0        31847.0
2016-08-01 09:30:00.000           3184.6      3181.8    69.0        31843.0
2016-08-01 09:30:00.500           3184.6      3181.8    73.0        31840.0
2016-08-01 09:30:01.000           3184.6      3181.8    97.0        31839.0
2016-08-01 09:30:01.500           3184.6      3181.8   106.0        31836.0
                         total_turnover     ...       a2_v  a3_v  a4_v  a5_v  \
datetime                                    ...
2016-08-01 09:29:00.000      58084200.0     ...        0.0   0.0   0.0   0.0
2016-08-01 09:30:00.000      65709540.0     ...        0.0   0.0   0.0   0.0
2016-08-01 09:30:00.500      69523920.0     ...        0.0   0.0   0.0   0.0
2016-08-01 09:30:01.000      92391300.0     ...        0.0   0.0   0.0   0.0
2016-08-01 09:30:01.500     100971420.0     ...        0.0   0.0   0.0   0.0
                         b1_v  b2_v  b3_v  b4_v  b5_v  change_rate
datetime
2016-08-01 09:29:00.000   1.0   0.0   0.0   0.0   0.0    -0.003329
2016-08-01 09:30:00.000   1.0   0.0   0.0   0.0   0.0    -0.003329
2016-08-01 09:30:00.500   1.0   0.0   0.0   0.0   0.0    -0.002449
2016-08-01 09:30:01.000   2.0   0.0   0.0   0.0   0.0    -0.002512
2016-08-01 09:30:01.500   1.0   0.0   0.0   0.0   0.0    -0.002072
  • 50ETF 期权日线数据(可以看到行权价、合约乘数在 50ETF 分红前后发生了变化)
[In] get_price('10000615', start_date='20161125', end_date='20161130', frequency='1d',expect_df=False)
[Out]
 total_turnover open_interest open close volume low strike_price contract_multiplier high
2016-11-25 14745563.0 2711.0 0.3653 0.3904 4037.0 0.3500 2.050 10000.0 0.3904
2016-11-28 14495982.0 2377.0 0.4055 0.4062 3518.0 0.3995 2.050 10000.0 0.4261
2016-11-29 15053302.0 2016.0 0.3997 0.4333 3501.0 0.3843 2.006 10220.0 0.4510
2016-11-30 13510805.0 1934.0 0.4322 0.4171 3121.0 0.4118 2.006 10220.0 0.4409
  • 获取回购合约日线
[In] get_price("131801.XSHE",start_date=20190522,end_date=20190522,frequency='1d',expect_df=False)
[Out]
            close low  num_trades high open  total_turnover  volume
2019-05-22  2.21  1.0  13544.0  2.78  2.65  3.906033e+09    3906033.0

# get_auction_info - 获取股票合约盘后数据

get_auction_info(order_book_ids, start_date, end_date, frequency='1d', market='cn')

获取科创板、创业板等股票合约盘后固定价格交易信息,可获取历史和实时

# 参数

参数 类型 说明
order_book_ids str or str list 可输入 order_book_id, order_book_id list,获取 tick 数据时,只支持单个
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期。
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期。
frequency str 数据的频率。 现在支持日/分钟/tick 级别的数据,默认为'1d'。只支持'1d','1m','tick',不支持'5d'等频率
fields str OR str list 字段名称
market str 默认是中国市场('cn')

# 返回

multi-index DataFrame

字段 类型 说明
close float 收盘价
volume float 成交量
total_turnover float 成交额
bid_vol int 申买入量(tick 数据专用)
ask_vol int 申卖出量(tick 数据专用)

# 范例

  • 获取合约列表盘后日线数据
[In]
get_auction_info(['688012.XSHG','688011.XSHG'],'20190722','20190722','1d')
[Out]
                           close volume total_turnover
order_book_id date
688012.XSHG 2019-07-22 81.03 112858.0 9144883.74
688011.XSHG 2019-07-22 70.17 19350.0 1357789.50
  • 获取单一合约盘后分钟数据
[In]
get_auction_info('688012.XSHG','20190722','20190722','1m')
[Out]
                       close volume total_turnover
order_book_id datetime
688012.XSHG 2019-07-22 15:06:00 81.03 1400.0 113442.00
            2019-07-22 15:07:00 81.03 600.0 48618.00
...
            2019-07-22 15:29:00 81.03 3241.0 262618.23
            2019-07-22 15:30:00 81.03 1400.0 113442.00
  • 获取单一合约盘后 tick 数据
[In]
get_auction_info('688012.XSHG','20190722','20190722','tick')
[Out]
                       close volume total_turnover bid_vol ask_vol
datetime
2019-07-22 15:05:00.168 81.03 1000.0 81030.00 18292.0 0.0
2019-07-22 15:05:03.168 81.03 1000.0 81030.00 18292.0 0.0
...
2019-07-22 15:30:50.280 81.03 112858.0 9144883.74 0.0 69339.0
2019-07-22 15:30:56.720 81.03 112858.0 9144883.74 0.0 69339.0

# get_ticks - 获取日内 tick 数据(试用版)

get_ticks(order_book_id)

获取当日给定合约的 level1 快照行情,无法获取历史。

说明:查询时间在交易日 T 日 7.30 pm 之前,返回 T 日的 tick 数据,查询时点在 7.30pm 之后,返回交易日 T+1 日的 tick 数据。

# 参数

无

# 返回

pandas DataFrame

  • tick 数据
字段 类型 说明
open float 当日开盘价
high float 当日最高价
low float 当日最低价
last float 最新价
prev_close float 昨日收盘价
total_turnover float 当天累计成交额
volume float 当天累计成交量
num_trades int 成交笔数 (仅支持股票、ETF、LOF、可转债)
limit_up float 涨停价
limit_down float 跌停价
open_interest float 累计持仓量
datetime datetime.datetime 交易所时间戳
a1~a5 float 卖一至五档报盘价格
a1_v~a5_v float 卖一至五档报盘量
b1~b5 float 买一至五档报盘价
b1_v~b5_v float 买一至五档报盘量
trading_date pandasTimeStamp 交易日期,对应期货夜盘的情况
prev_settlement float 昨日结算价(仅期货有效)
iopv float 场内基金实时估算净值
prev_iopv float 场内基金前估算净值

# 范例

  • 获取 000001.XSHE 当日 tick 数据
[In]
df=get_ticks('000001.XSHE')
df.head(1)
[Out]
                          open last high low iopv prev_iopv limit_up limit_down prev_close volume ... a1_v a2_v a3_v a4_v a5_v b1_v b2_v b3_v b4_v b5_v
order_book_id datetime
000001.XSHE 2021-07-23 09:15:00 0.0 20.38 0.0 0.0 NaN NaN 22.42 18.34 20.38 0.0 ... 8700.0 11300.0 0.0 0.0 0.0 8700.0 0.0 0.0 0.0 0.0
  • 获取 ETF 期权 10002725 当日 tick 数据
[In]
get_ticks('10002725',expect_df=False)
[Out]
 update_time open last high low limit_up limit_down prev_settlement prev_close volume ... a1_v a2_v a3_v a4_v a5_v b1_v b2_v b3_v b4_v b5_v
datetime
2021-03-09 09:15:00.020 0 0.0000 0.6547 0.0000 0.0000 1.0124 0.3002 0.6563 0.6547 0.0 ... 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0
2021-03-09 09:15:00.530 0 0.0000 0.6547 0.0000 0.0000 1.0124 0.3002 0.6563 0.6547 0.0 ... 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0
2021-03-09 09:15:01.030 0 0.0000 0.6547 0.0000 0.0000 1.0124 0.3002 0.6563 0.6547 0.0 ... 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0

# get_live_ticks - 获取日内 tick 数据(支持日内时间切割)

get_live_ticks(order_book_ids,start_dt,end_dt,fields,market='cn')

获取给定的股票、期货、期权、ETF、常见指数和上金所现货等合约的 level1 快照行情,无法获取历史。

# 参数

参数 类型 说明
order_book_ids str or str list 可输入 order_book_id, order_book_id list,
start_dt str, datetime.datetime, pandasTimestamp 开始时间,采用自然日时间戳,细化到秒
end_dt str, datetime.datetime, pandasTimestamp 结束时间,采用自然日时间戳,细化到秒
fields str or str list 字段名称
market str 默认是中国市场('cn')

说明: start_dt 和 end_dt 需同时传入或同时不传入,当不传入 start_dt,end_dt 参数时,查询时间在交易日 T 日 7.30 pm 之前,返回 T 日的 tick 数据,查询时点在 7.30pm 之后,返回交易日 T+1 日的 tick 数据。

# 返回

pandas DataFrame

  • tick 数据
字段 类型 说明
open float 当日开盘价
high float 当日最高价
low float 当日最低价
last float 最新价
prev_close float 昨日收盘价
total_turnover float 当天累计成交额
volume float 当天累计成交量
num_trades int 成交笔数 (仅支持股票、ETF、LOF、可转债
limit_up float 涨停价
limit_down float 跌停价
open_interest float 累计持仓量
datetime datetime.datetime 交易所时间戳
a1~a5 float 卖一至五档报盘价格
a1_v~a5_v float 卖一至五档报盘量
b1~b5 float 买一至五档报盘价
b1_v~b5_v float 买一至五档报盘量
trading_date pandasTimeStamp 交易日期,对应期货夜盘的情况
prev_settlement float 昨日结算价(仅期货有效)
iopv float 场内基金实时估算净值
prev_iopv float 场内基金前估算净值

# 范例

  • 获取期权合约 2020 年 3 月 9 日 9 时 40 分 00 秒-2020 年 3 月 9 日 9 时 40 分 02 秒之间的 tick 数据
[In]get_live_ticks(order_book_ids=['10002726'],start_dt='20210309094000',end_dt='20210309094002')
[Out]
                                  trading_date update_time open last high low limit_up limit_down prev_settlement prev_close ... a1_v a2_v a3_v a4_v a5_v b1_v b2_v b3_v b4_v b5_v
order_book_id datetime
10002726 2021-03-09 09:40:00.020 NaT NaT 0.6173 0.6039 0.6173 0.6033 0.9624 0.2502 0.6063 0.6072 ... 10 2 30 10 10 30 10 10 10 10
            2021-03-09 09:40:00.540 NaT NaT 0.6173 0.6039 0.6173 0.6033 0.9624 0.2502 0.6063 0.6072 ... 10 1 22 10 10 20 10 10 10 10
            2021-03-09 09:40:01.030 NaT NaT 0.6173 0.6039 0.6173 0.6033 0.9624 0.2502 0.6063 0.6072 ... 8 20 2 10 10 20 10 10 10 10
            2021-03-09 09:40:01.540 NaT NaT 0.6173 0.6039 0.6173 0.6033 0.9624 0.2502 0.6063 0.6072 ... 10 1 20 2 10 30 10 10 10 10
  • 获取股票合约当日 2020 年 9 月 18 日 9 时 15 分 00 秒-2020 年 9 月 18 日 9 时 15 分 30 秒之间的 tick 数据
[In]
get_live_ticks(order_book_ids=['000001.XSHE','000006.XSHE'],start_dt='20200918091500',end_dt='20200918091530')
[Out]
                        open last high low iopv prev_iopv limit_up limit_down prev_close volume ... a1_v a2_v a3_v a4_v a5_v b1_v b2_v b3_v b4_v b5_v
order_book_id datetime
000001.XSHE 2020-09-18 09:15:00 0 15.57 0 0 NaN NaN 17.13 14.01 15.57 0 ... 900 0 0 0 0 900 2500 0 0 0
            2020-09-18 09:15:09 0 15.57 0 0 NaN NaN 17.13 14.01 15.57 0 ... 53500 2700 0 0 0 53500 0 0 0 0
            2020-09-18 09:15:18 0 15.57 0 0 NaN NaN 17.13 14.01 15.57 0 ... 53600 2700 0 0 0 53600 0 0 0 0
            2020-09-18 09:15:27 0 15.57 0 0 NaN NaN 17.13 14.01 15.57 0 ... 53500 2800 0 0 0 53500 0 0 0 0
000006.XSHE 2020-09-18 09:15:00 0 5.88 0 0 NaN NaN 6.47 5.29 5.88 0 ... 0 0 0 0 0 0 0 0 0 0
            2020-09-18 09:15:09 0 5.88 0 0 NaN NaN 6.47 5.29 5.88 0 ... 2800 0 0 0 0 2800 9400 0 0 0
            2020-09-18 09:15:18 0 5.88 0 0 NaN NaN 6.47 5.29 5.88 0 ... 2900 0 0 0 0 2900 9300 0 0 0
  • 获取 000001.XSHG 和 RB2101 合约当日 2020 年 9 月 18 日 9 时 31 分 00 秒-2020 年 9 月 18 日 9 时 31 分 06 秒之间的 open,last ,high 等 tick 字段
[In]
get_live_ticks(order_book_ids=['000001.XSHG','RB2101'],start_dt='20200918093100',end_dt='20200918093106',fields=['open','last','high'])
[Out]
                    open          last           high
order_book_id datetime
000001.XSHG 2020-09-18 09:31:00.790 3270.911 3272.8091 3275.0855
            2020-09-18 09:31:05.060 3270.911 3272.8249 3275.0855
RB2101     2020-09-18 09:31:00.093 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:00.607 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:01.095 3580.000 3604.0000 3611.0000
            2020-09-18 09:31:01.582 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:02.098 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:02.598 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:03.098 3580.000 3604.0000 3611.0000
            2020-09-18 09:31:03.596 3580.000 3604.0000 3611.0000
            2020-09-18 09:31:04.105 3580.000 3604.0000 3611.0000
            2020-09-18 09:31:04.584 3580.000 3604.0000 3611.0000
            2020-09-18 09:31:05.094 3580.000 3605.0000 3611.0000
            2020-09-18 09:31:05.581 3580.000 3604.0000 3611.0000

# get_open_auction_info - 获取盘前集合竞价数据

get_open_auction_info(order_book_ids,start_date, end_date,market='cn')

获取当日给定合约的盘前集合竞价结束的 level1 快照行情。

# 参数

参数 类型 说明
order_book_ids str or str list 可输入 order_book_id, order_book_id list
market str 默认是中国市场('cn')
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期。如不指定日期,则默认为取当天
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期。如不指定日期,则默认为返回所填开始日期当天
fields str OR str list 字段名称

# 返回

multi-index DataFrame

  • tick 数据
字段 类型 说明
open float 当日开盘价
high float 当日最高价
low float 当日最低价
last float 最新价
prev_settlement float 昨日结算价
volume float 成交量
limit_up float 涨停价
limit_down float 跌停价
open_interest float 累计持仓量
datetime datetime.datetime 时间戳
a1~a5 float 卖一至五档报盘价格
a1_v~a5_v float 卖一至五档报盘量
b1~b5 float 买一至五档报盘价
b1_v~b5_v float 买一至五档报盘量
change_rate float 涨跌幅
trading_date pandasTimeStamp 交易日期,对应期货夜盘的情况
iopv float 场内基金实时估算净值
prev_iopv float 场内基金前估算净值

# 范例

  • 获取单一合约集合竞价数据
In []:
get_open_auction_info('000001.XSHE','20190102','20190105')
Out[]:
                                    open   last   high    low  limit_up  ...      b1_v     b2_v      b3_v     b4_v     b5_v
order_book_id datetime                                                   ...
000001.XSHE   2019-01-02 09:25:03   9.39   9.39   9.39   9.39     10.32  ...  183300.0  79600.0   65100.0  67700.0  43700.0
              2019-01-03 09:25:03   9.18   9.18   9.18   9.18     10.11  ...   37230.0  76700.0  157700.0  73400.0  22000.0
              2019-01-04 09:25:03   9.24   9.24   9.24   9.24     10.21  ...   56500.0  34200.0   41600.0  80200.0  42500.0
  • 获取合约列表集合竞价数据
[In]
get_open_auction_info(['000001.XSHE','000002.XSHE'],'20190102','20190105')
[Out]
                                    open   last   high    low  limit_up  limit_down  ...      a5_v      b1_v     b2_v      b3_v     b4_v     b5_v
order_book_id datetime                                                               ...
000001.XSHE   2019-01-02 09:25:03   9.39   9.39   9.39   9.39     10.32        8.44  ...   17800.0  183300.0  79600.0   65100.0  67700.0  43700.0
              2019-01-03 09:25:03   9.18   9.18   9.18   9.18     10.11        8.27  ...   16200.0   37230.0  76700.0  157700.0  73400.0  22000.0
              2019-01-04 09:25:03   9.24   9.24   9.24   9.24     10.21        8.35  ...  210900.0   56500.0  34200.0   41600.0  80200.0  42500.0
000002.XSHE   2019-01-02 09:25:03  23.83  23.83  23.83  23.83     26.20       21.44  ...    8593.0   35381.0  58700.0    1100.0   4800.0    100.0
              2019-01-03 09:25:03  23.79  23.79  23.79  23.79     26.29       21.51  ...    4708.0    5400.0   2400.0   13100.0  17600.0    700.0
              2019-01-04 09:25:03  23.91  23.91  23.91  23.91     26.48       21.66  ...     400.0    1800.0    200.0    5000.0   3000.0    100.0

# current_minute - 获取最近的分钟线数据

current_minute(order_book_ids,skip_suspended=False,fields)

获取当日给定合约的 level1 最近合成的 1 分钟行情,无法获取历史。

# 参数

参数 类型 说明
order_book_ids str or str list 可输入 order_book_id, order_book_id list
skip_suspended boolean 是否跳过停牌,默认不跳过
fields list 可挑选返回的字段。默认返回所有

# 返回

pandas DataFrame

  • 分钟数据
字段 类型 说明
open float 此分钟开盘价
high float 此分钟最高价
low float 此分钟最低价
close float 此分钟收盘价
volume integer 此分钟成交量
turnover float 此分钟成交额
iopv float 场内基金实时估算净值

# 范例

  • 获取平安银行和浦发银行最近的分钟数据
[In]
current_minute(["000001.XSHE","600000.XSHG"])
[Out]
                                     close  high  low  open      total_turnover  volume
order_book_id  datetime
000001.XSHE  2019-05-22 15:00:00  12.40  12.40  12.39  12.39  6502002.0  524355
600000.XSHG  2019-05-22 15:00:00  11.16  11.16  11.15  11.15  1987596.0  178100
  • 获取交易所期权 10002726 和 90000339 最近的分钟数据
[In]current_minute(order_book_ids=['10002726','90000339'])
[Out]
  close high low open open_interest total_turnover trading_date volume
order_book_id datetime
10002726 2021-03-09 15:00:00 0.5514 0.5514 0.5514 0.5514 1488 0.0 20210309 0
90000339 2021-03-09 15:00:00 0.3286 0.3980 0.3286 0.3980 315 3394.0 20210309 1

# get_price_change_rate - 获取历史涨跌幅

get_price_change_rate(order_book_ids, start_date='20130104', end_date='20140104', expect_df=True)

获取股票或指数的历史涨跌幅(包含起止日期)。注意目前只支持股票、指数、可转债这三类合约,基金、期货等目前并不支持。历史涨跌幅基于后复权价格。

# 参数

参数 类型 说明
order_book_ids str or str list 可输入 order_book_id, order_book_id list
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为'2013-01-04'
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为'2014-01-04'
expect_df boolean 默认返回 pandas dataframe。如果调为 False,则返回原有的数据结构

# 返回

# 范例

  • 获取平安银行以及沪深 300 指数一段时间的涨跌幅情况。
[In]
get_price_change_rate(['000001.XSHE', '000300.XSHG'], '20150801', '20150807')
[Out]
order_book_id 000001.XSHE 000300.XSHG
date
2015-08-03 0.037217 0.003285
2015-08-04 0.003120 0.031056
2015-08-05 -0.020995 -0.020581
2015-08-06 -0.004766 -0.009064
2015-08-07 0.006385 0.019597

# current_snapshot - 获取当前行情快照

current_snapshot(order_book_ids, market='cn')

获取某一合约当前的 LEVEL1 行情快照,支持集合竞价数据获取。

# 参数

参数 类型 说明
order_book_ids str or strlist 合约代码,可传入 order_book_id, order_book_id list。
market str 默认是中国市场('cn'),目前仅支持中国市场

# 返回

Tick 对象 或者一个 Tick list

属性 类型 注释
datetime datetime.datetime 时间戳
order_book_id string 合约代码
open float 当日开盘价
high float 当日最高价
low float 当日最低价
last float 最新价
prev_settlement float 昨日结算价
prev_close float 昨日收盘价
volume float 成交量
total_turnover float 成交额
limit_up float 涨停价
limit_down float 跌停价
open_interest float 累计持仓量
trading_phase_code float 停牌标识。T-正常交易、H-临时停牌、P-全天停牌。目前仅支持深交所股票
asks list 卖出报盘价格,asks[0] 代表盘口卖一档报盘价
ask_vols list 卖出报盘数量,ask_vols[0] 代表盘口卖一档报盘数量
bids list 买入报盘价格,bids[0] 代表盘口买一档报盘价
bid_vols list 买入报盘数量,bid_vols[0] 代表盘口买一档报盘数量
iopv float 场内基金实时估算净值
prev_iopv float 场内基金前估算净值
close float 当日收盘价(现货专用,约 15:30 可取,可以用是否大于 0 判断是否已有值)
settlement float 当日结算价(现货专用)

# 范例

  • 获取期权合约 90000337 当前快照数据
[In] current_snapshot('90000337')
[Out]
Tick(ask_vols: [1, 1, 1, 10, 1], asks: [0.5119, 0.517, 0.5206, 0.5207, 0.522], bid_vols: [1, 1, 1, 1, 1], bids: [0.5007, 0.4967, 0.4926, 0.492, 0.4897], datetime: 2021-03-09 15:02:00, high: 0.6316, iopv: nan, last: 0.5118, limit_down: 0.1144, limit_up: 1.128, low: 0.5118, open: 0.6057, open_interest: 266, order_book_id: 90000337, prev_close: 0.6344, prev_iopv: nan, prev_settlement: 0.6212, total_turnover: 160569, trading_phase_code: T, volume: 27)
  • 获取某一股票当前快照数据
[In] current_snapshot('000001.XSHE')
[Out]
Tick(ask_vols: [25400, 15500, 12300, 39985, 16200], asks: [13.7, 13.71, 13.72, 13.73, 13.74], bid_vols: [1050, 9300, 172301, 691800, 579400], bids: [13.69, 13.68, 13.67, 13.66, 13.65], datetime: 2020-07-24 11:30:00, high: 13.99, iopv: nan, last: 13.69, low: 13.66, open: 13.97, open_interest: None, order_book_id: 000001.XSHE, prev_close: 14.01, prev_iopv: nan, prev_settlement: None, total_turnover: 1199992014, trading_phase_code: T, volume: 86853387)
  • 获取某一期货当前快照数据
In [22]: current_snapshot('RB2010')
Out[22]: Tick(ask_vols: [158, 655, 954, 247, 373], asks: [3775.0, 3776.0, 3777.0, 3778.0, 3779.0], bid_vols: [25, 513, 90, 56, 2214], bids: [3774.0, 3773.0, 3772.0, 3771.0, 3770.0], datetime: 2020-07-24 11:30:00.143000, high: 3805.0, iopv: nan, last: 3774.0, low: 3766.0, open: 3804.0, open_interest: 1360251.0, order_book_id: RB2010, prev_close: 3806.0, prev_iopv: nan, prev_settlement: 3787.0, total_turnover: 29219994570.0, trading_phase_code: None, volume: 772145.0)
  • 获取多个当前快照数据
[In] current_snapshot(['000001.XSHE','600000.XSHG'])
[Out]
[Tick(ask_vols: [25400, 15500, 12300, 39985, 16200], asks: [13.7, 13.71, 13.72, 13.73, 13.74], bid_vols: [1050, 9300, 172301, 691800, 579400], bids: [13.69, 13.68, 13.67, 13.66, 13.65], datetime: 2020-07-24 11:30:00, high: 13.99, iopv: nan, last: 13.69, low: 13.66, open: 13.97, open_interest: None, order_book_id: 000001.XSHE, prev_close: 14.01, prev_iopv: nan, prev_settlement: None, total_turnover: 1199992014, trading_phase_code: T, volume: 86853387),
 Tick(ask_vols: [251300, 4100, 13300, 344430, 13200], asks: [10.58, 10.59, 10.6, 10.61, 10.62], bid_vols: [1200, 124406, 294800, 136200, 170100], bids: [10.57, 10.56, 10.55, 10.54, 10.53], datetime: 2020-07-24 11:29:59.860000, high: 10.8, iopv: nan, last: 10.57, low: 10.55, open: 10.78, open_interest: None, order_book_id: 600000.XSHG, prev_close: 10.84, prev_iopv: nan, prev_settlement: None, total_turnover: 363418169.0, trading_phase_code: T, volume: 34090105)]

# get_trading_dates - 获取交易日列表

get_trading_dates(start_date, end_date, market='cn')

获取某个国家市场的交易日列表(起止日期加入判断)。目前仅支持中国市场。

# 参数

参数 类型 说明
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场

# 返回

datetime.date list - 交易日期列表

# 范例

[In]
get_trading_dates(start_date='20160505', end_date='20160505')
[Out]
[datetime.date(2016, 5, 5)]

# get_previous_trading_date - 获取历史某个交易日

get_previous_trading_date(date,n,market='cn')

默认获取指定日期的上一交易日。

# 参数

参数 类型 说明
date str, datetime.date, datetime.datetime, pandasTimestamp 指定日期
n int n 代表往前第 n 个交易日。默认为 1,即前一个交易日
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场

# 返回

datetime.date - 交易日期

# 范例

[In]
get_previous_trading_date('20160502',n=1)
[Out]
[datetime.date(2016, 4, 29)]

# get_next_trading_date - 获取未来某个交易日

get_next_trading_date(date, n, market='cn')

默认获取指定日期的国内市场的下一交易日。

# 参数

参数 类型 说明
date str, datetime.date, datetime.datetime, pandasTimestamp 指定日期
n int n 代表未来第 n 个交易日。默认为 1,即下一个交易日
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场

# 返回

datetime.date - 交易日期

# 范例

[In]
get_next_trading_date(date='2016-05-01',n=1)
[Out]
[datetime.date(2016, 5, 3)]

# get_latest_trading_date - 获取当前最近一个交易日

get_latest_trading_date()

获取当天的最近一个交易日(若当天为交易日,则返回当天;若当天为节假日,则返回上一个交易日)

# 参数

参数 类型 说明
market str 默认是中国内地市场('cn') 。可选'cn' - 中国内地市场;'hk' - 香港市场

# 返回

datetime.date - 交易日期

# 范例

[In]
get_latest_trading_date()
[Out]:
datetime.date(2019, 11, 22)

# get_trading_hours - 获取合约连续竞价时间段

get_trading_hours(order_book_id, frequency='1m', date=None, market='cn')

默认获取当前点国内市场合约字符串形式的连续竞价交易时间段。

# 参数

参数 类型 说明
order_book_id str 合约名称
date str, datetime.date, datetime.datetime, pandasTimestamp 指定日期。使用场景,部分合约的当前和历史的连续竞价交易时间段会有不同
frequency str 频率,默认为 1m, 对应米筐分钟线时间段的起始, 为 tick 时返回交易所给出的交易时间
market str 目前只支持中国市场 ('cn')

# 返回

string - 交易时间

# 范例

In [20]: get_trading_hours('000001.XSHE')
Out[20]: '09:31-11:30,13:01-15:00'

# get_exchange_rate - 获取汇率信息

get_exchange_rate(start_date=None, end_date=None, fields=None)

获取指定时间段的汇率信息

# 参数

参数 类型 说明
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期
fields str OR str list 字段名称

# 返回

返回 类型 说明
date str 时间戳
currency_pair str 货币对。目前仅支持港币对人民币汇率,如'HKDCNY'表示 1 港币对应的人民币
bid_referrence_rate str 买入参考汇率,上交所和深交所披露值,日更新
ask_referrence_rate str 卖出参考汇率,上交所和深交所披露值,日更新
middle_referrence_rate str 中间价,香港金融管理局披露值,月更新
bid_settlement_rate_sh str 买入结算汇率-沪港通,盘后更新
ask_settlement_rate_sh str 卖出结算汇率-沪港通,盘后更新
bid_settlement_rate_sz str 买入结算汇率-深港通,盘后更新
ask_settlement_rate_sz str 卖出结算汇率-深港通,盘后更新

# 范例

In [8]: rq.get_exchange_rate(20190101,20200101)
Out[8]:
           currency_pair  bid_referrence_rate  ask_referrence_rate  ...  ask_settlement_rate_sh  bid_settlement_rate_sz  ask_settlement_rate_sz
date                                                                ...
2019-01-02        HKDCNY               0.8509               0.9035  ...                 0.87745                 0.87683                 0.87757
2019-01-03        HKDCNY               0.8497               0.9023  ...                 0.87553                 0.87649                 0.87551
2019-01-04        HKDCNY               0.8523               0.9051  ...                 0.87870                 0.87866                 0.87874
...
2020-08-14        HKDCNY               0.8687               0.9225  ...                 0.89568                 0.89534                 0.89586
2020-08-17        HKDCNY               0.8700               0.9238  ...                 0.89680                 0.89708                 0.89672
2020-08-18        HKDCNY               0.8682               0.9219  ...                     NaN                     NaN                     NaN

# get_yield_curve - 获取收益率曲线

get_yield_curve(start_date='2013-01-04', end_date='2014-01-04', tenor=None, market='cn')

获取某个国家市场在一段时间内收益率曲线水平(包含起止日期)。目前仅支持中国市场。

数据为 2002 年至今的中债国债收益率曲线,来源于中央国债登记结算有限责任公司。

# 参数

参数 类型 说明
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为'2013-01-04'
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为'2014-01-04'
tenor str 标准期限,'0S' - 隔夜,'1M' - 1 个月,'1Y' - 1 年
market str 默认是中国市场('cn'),目前支持中国市场。

# 返回

pandas DataFrame - 查询时间段内无风险收益率曲线

# 范例

[In]
get_yield_curve(start_date='20130104', end_date='20140104')
[Out]
                0S      1M      2M      3M      6M      9M      1Y      2Y  \
2013-01-04  0.0196  0.0253  0.0288  0.0279  0.0280  0.0283  0.0292  0.0310
2013-01-05  0.0171  0.0243  0.0286  0.0275  0.0277  0.0281  0.0288  0.0305
2013-01-06  0.0160  0.0238  0.0285  0.0272  0.0273  0.0280  0.0287  0.0304
                3Y      4Y   ...        6Y      7Y      8Y      9Y     10Y  \
2013-01-04  0.0314  0.0318   ...    0.0342  0.0350  0.0353  0.0357  0.0361
2013-01-05  0.0309  0.0316   ...    0.0342  0.0350  0.0352  0.0356  0.0360
2013-01-06  0.0310  0.0315   ...    0.0340  0.0350  0.0352  0.0356  0.0360
...

# get_live_minute_price_change_rate - 获取当日分钟涨跌幅(股票,指数)

rqdatac.get_live_minute_price_change_rate(order_book_ids)

获取当日分钟涨跌幅

# 参数

参数 类型 说明
order_book_ids str or list 给出单个或多个 order_book_id
adjust_type str 昨收价格复权方式,默认为none
不复权 - none
前复权 - pre
后复权 - post

# 返回

  • pandas Series
字段 类型 说明
change_rate float 涨跌幅

# 范例

  • 获取多个合约当日分钟涨跌幅
[In]
rqdatac.get_live_minute_price_change_rate(['000001.XSHE','600000.XSHG'])
[Out]
order_book_id        000001.XSHE  600000.XSHG
datetime
2022-09-23 09:31:00    -0.002441    -0.002809
2022-09-23 09:32:00    -0.001627    -0.001404
2022-09-23 09:33:00     0.000814    -0.002809
2022-09-23 09:34:00     0.000814    -0.002809
2022-09-23 09:35:00     0.000000    -0.001404
...                          ...          ...
2022-09-23 14:56:00    -0.000814     0.004213
2022-09-23 14:57:00     0.000000     0.004213
2022-09-23 14:58:00     0.000814     0.004213
2022-09-23 14:59:00     0.000814     0.004213
2022-09-23 15:00:00     0.000000     0.005618
[240 rows x 2 columns]

# get_future_latest_trading_date - 获取当前最近一个期货交易日

get_future_latest_trading_date()

获取当天的最近一个期货交易日(从夜盘的集合竞价开始算起,作为新的交易日;若当天为节假日,则返回下一个交易日)

# 参数

参数 类型 说明
market str 默认是中国内地市场('cn')

# 返回

datetime.date - 交易日期

# 范例

[In]
get_future_latest_trading_date()
[Out]:
datetime.date(2023, 6, 21)

# get_vwap - 获取日/分钟级别的 vwap 历史数据

rqdatac.get_vwap(order_book_ids, start_date=None, end_date=None, frequency='1d')

获取指定区间的 vwap 数据

# 参数

参数 类型 说明
order_book_ids str OR str list 合约代码,可传入 order_book_id, order_book_id list
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期
frequency str 历史数据的频率。 默认为'1d'。
1m - 分钟级别
1d - 日级别
分钟可选取不同频率,例如'5m'代表 5 分线

支持品种:股票、期货、期权、ETF、可转债

# 返回

Series - vwap

# 范例

获取 000001.XSHE 在 2024-01-01~02-01 的日级别 vwap 数据

[In]
rqdatac.get_vwap('000001.XSHE',20240101,20240201)
[Out]:
order_book_id  date
000001.XSHE    2024-01-02    9.286718
               2024-01-03    9.182990
               2024-01-04    9.112191
               2024-01-05    9.302265
               2024-01-08    9.178084
               2024-01-09    9.140973
               2024-01-10    9.128256
               2024-01-11    9.135580
               2024-01-12    9.203141
               2024-01-15    9.205756
               2024-01-16    9.277993
               2024-01-17    9.314772
               2024-01-18    9.103892
               2024-01-19    9.148154
               2024-01-22    9.174462
               2024-01-23    9.078450
               2024-01-24    9.209698
               2024-01-25    9.422591
               2024-01-26    9.562171
               2024-01-29    9.730338
               2024-01-30    9.594930
               2024-01-31    9.481586
               2024-02-01    9.414571
Name: 000001.XSHE, dtype: float64

获取 IF2403 在 2024-02-01 的 1m 级别 vwap 数据

[In]
rqdatac.get_vwap('IF2403',20240201,20240201,'1m')
[Out]
order_book_id  datetime
IF2403         2024-02-01 09:31:00    3201.224586
               2024-02-01 09:32:00    3196.929688
               2024-02-01 09:33:00    3200.511346
               2024-02-01 09:34:00    3201.722967
               2024-02-01 09:35:00    3203.796373
                                         ...
               2024-02-01 14:56:00    3210.391429
               2024-02-01 14:57:00    3209.169421
               2024-02-01 14:58:00    3208.998773
               2024-02-01 14:59:00    3208.252893
               2024-02-01 15:00:00    3207.797403
Name: IF2403, Length: 240, dtype: float64

# 实时行情推送

考虑到实时行情中,用户不太方便通过主动轮询 API 去获取合约最新不间断的实时行情,米筐开发提供了 python sdk 和 websocket 网络接口,用以支持用户获取实时行情推送数据,具体说明如下:

# Ricequant 实时数据的种类包括

资产类别 说明
中国 A 股 支持 主板、创业板、科创板
场内基金 包括 ETF、LOF
可转债 沪深市场合约
中国期货 包括股指、国债、商品期货
中国期权 包括 ETF、股指、商品期权
国债逆回购 沪深市场合约
现货 包括黄金、铂金、白银等

# Ricequant 实时数据的频率包括

  • 提供 Level1 tick 五档深度行情
  • 提供实时的 1 、3、5、15、30、60 等任意频率的分钟行情合成
    (注:30、60 分钟线是按照时间进行切片。例如合约在 10:15-10:30 休市,则 60 分钟线在 11:00 只包含 45 分钟的交易;而 30 分钟线将出现 10:15 的时间戳)

# A、实时行情推送的适用场景

1、 驱动实盘交易或者模拟交易
2、 若客户已有实时行情,米筐可以作为备份

# B、相较于 RQData 请求数据的优点

1、 推送会比拉取型 API 返回实时行情更及时,效率更高
2、 提供 python sdk 和 websocket 网络接口,用户可以使用任意语言接入,语言中性
3、 基于 ricequant 的数据能力和 rqdata 的基础设施,数据准确快速,可靠性高

# LiveMarketDataClient - websocket 实时行情推送方案

通过简单的一行代码从 RQData 引入 LiveMarketDataClient ,即可实现实时行情数据的推送。分别提供阻塞和不阻塞的调用方式,具体请参考范例。

# 范例

[In]
import rqdatac
from rqdatac import LiveMarketDataClient
rqdatac.init(username="license", password="邮件中一大串license的key")
client = LiveMarketDataClient()
# 订阅一支tick标的
client.subscribe('tick_000001.XSHE')
# 订阅1分钟行情
client.subscribe('bar_000001.XSHE')
# 订阅多支tick标的
client.subscribe(['tick_000001.XSHE', 'tick_000002.XSHE'])
# 订阅3分钟行情,其它分钟线的命名方法类似,修改后缀即可
# client.subscribe('bar_000001.XSHE_3m')
# 取消订阅tick标的
client.unsubscribe('tick_000002.XSHE')
# 检听行情
# 1. 阻塞的方式
for market in client.listen():
    print(market)
# 2. 不阻塞的方式
def handle_msg(tick_or_bar):
    # 可以自行定义处理
    # queue.push(tick_or_bar)
    print(tick_or_bar)
client.listen(handler=handle_msg) # handler不为None
# [Out]
# {'datetime': 20210913094009000, 'order_book_id': '000001.XSHE', 'prev_close': 20.57, 'num_trades': 12786, 'volume': 13134791.0, 'total_turnover': 267427634, 'trading_phase_code': 'T', 'last': 20.26, 'open': 20.36, 'high': 20.51, 'low': 20.25, 'limit_up': 22.63, 'limit_down': 18.51, 'ask': [20.28, 20.3, 20.31, 20.32, 20.33], 'bid': [20.26, 20.25, 20.24, 20.23, 20.22], 'ask_vol': [37100.0, 33500.0, 13200.0, 16100.0, 3600.0], 'bid_vol': [4400.0, 198000.0, 6800.0, 17700.0, 33600.0], 'trading_date': 20210913, 'channel': 'tick_000001.XSHE', 'action': 'feed'}
# {'datetime': 20210913094012000, 'order_book_id': '000001.XSHE', 'prev_close': 20.57, 'num_trades': 12882, 'volume': 13278591.0, 'total_turnover': 270342631, 'trading_phase_code': 'T', 'last': 20.3, 'open': 20.36, 'high': 20.51, 'low': 20.25, 'limit_up': 22.63, 'limit_down': 18.51, 'ask': [20.3, 20.31, 20.32, 20.33, 20.34], 'bid': [20.28, 20.25, 20.24, 20.23, 20.22], 'ask_vol': [15000.0, 13200.0, 16100.0, 3600.0, 4500.0], 'bid_vol': [4400.0, 150000.0, 6800.0, 18500.0, 33600.0], 'trading_date': 20210913, 'channel': 'tick_000001.XSHE', 'action': 'feed'}
# {'datetime': 20210913094015000, 'order_book_id': '000001.XSHE', 'prev_close': 20.57, 'num_trades': 13014, 'volume': 13402691.0, 'total_turnover': 272859932, 'trading_phase_code': 'T', 'last': 20.26, 'open': 20.36, 'high': 20.51, 'low': 20.25, 'limit_up': 22.63, 'limit_down': 18.51, 'ask': [20.27, 20.29, 20.3, 20.32, 20.33], 'bid': [20.26, 20.25, 20.24, 20.23, 20.22], 'ask_vol': [3200.0, 2300.0, 3700.0, 1500.0, 3600.0], 'bid_vol': [500.0, 112400.0, 8000.0, 17700.0, 33600.0], 'trading_date': 20210913, 'channel': 'tick_000001.XSHE', 'action': 'feed'}
# {'datetime': 20210913094018000, 'order_book_id': '000001.XSHE', 'prev_close': 20.57, 'num_trades': 13110, 'volume': 13499491.0, 'total_turnover': 274820911, 'trading_phase_code': 'T', 'last': 20.28, 'open': 20.36, 'high': 20.51, 'low': 20.25, 'limit_up': 22.63, 'limit_down': 18.51, 'ask': [20.28, 20.29, 20.3, 20.32, 20.33], 'bid': [20.25, 20.24, 20.23, 20.22, 20.21], 'ask_vol': [9100.0, 6100.0, 4800.0, 1500.0, 2600.0], 'bid_vol': [52800.0, 8000.0, 17700.0, 33600.0, 165600.0], 'trading_date': 20210913, 'channel': 'tick_000001.XSHE', 'action': 'feed'}
Last Updated: 8/14/2025, 5:58:49 PM

← 使用说明 A股 →