class Options():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Opt(self, contractStatus='', optID='', secID='', ticker='', varSecID='', varticker='', field=''):
"""
获取期权合约编码，交易代码，交易市场，标的等相关信息
"""
code, result = self.client.getData(vs.OPT%(contractStatus, optID, secID, ticker,
varSecID, varticker, field))
return _ret_data(code, result)
def OptVar(self, exchangeCD='', secID='', ticker='', contractType='', exerType='', field=''):
"""
获取期权品种名称、生效日期、履约方式、交割方式、申报单位等相关信息。
"""
code, result = self.client.getData(vs.OPTVAR%(exchangeCD, secID, ticker,
contractType, exerType, field))
return _ret_data(code, result)
class Future():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Futu(self, exchangeCD='', secID='', ticker='', contractObject='', field=''):
"""
获取国内四大期货交易所期货合约的基本要素信息，
包括合约名称、合约代码、合约类型、合约标的、报价单位、最小变动价位、涨跌停板幅度、交易货币、
合约乘数、交易保证金、上市日期、最后交易日、交割日期、交割方式、交易手续费、交割手续费、挂牌基准价、合约状态等。
"""
code, result = self.client.getData(vs.FUTU%(exchangeCD, secID, ticker, contractObject, field))
return _ret_data(code, result)
def FutuConvf(self, secID='', ticker='', field=''):
"""
获取国债期货转换因子信息，包括合约可交割国债名称、可交割国债交易代码、转换因子等。
"""
code, result = self.client.getData(vs.FUTUCONVF%(secID, ticker, field))
return _ret_data(code, result)
class Future():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Futu(self,
exchangeCD='',
secID='',
ticker='',
contractObject='',
field=''):
"""
获取国内四大期货交易所期货合约的基本要素信息，
包括合约名称、合约代码、合约类型、合约标的、报价单位、最小变动价位、涨跌停板幅度、交易货币、
合约乘数、交易保证金、上市日期、最后交易日、交割日期、交割方式、交易手续费、交割手续费、挂牌基准价、合约状态等。
"""
code, result = self.client.getData(
vs.FUTU % (exchangeCD, secID, ticker, contractObject, field))
return _ret_data(code, result)
def FutuConvf(self, secID='', ticker='', field=''):
"""
获取国债期货转换因子信息，包括合约可交割国债名称、可交割国债交易代码、转换因子等。
"""
code, result = self.client.getData(vs.FUTUCONVF %
(secID, ticker, field))
return _ret_data(code, result)
class Idx():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Idx(self, secID='', ticker='', field=''):
"""
获取国内外指数的基本要素信息，包括指数名称、指数代码、发布机构、发布日期、基日、基点等。
"""
code, result = self.client.getData(vs.IDX%(secID, ticker, field))
return _ret_data(code, result)
def IdxCons(self, secID='', ticker='', intoDate='', isNew='', field=''):
"""
获取国内外指数的成分构成情况，包括指数成分股名称、成分股代码、入选日期、剔除日期等。
"""
code, result = self.client.getData(vs.IDXCONS%(secID, ticker, intoDate,
intoDate, isNew, field))
return _ret_data(code, result)
def IdxWeight(self, secID='', ticker='', beginDate='', endDate='', field=''):
code, result = self.client.getData(vs.IDXWEIGHT%(secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
class HKequity():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def HKEqu(self, listStatusCD='', secID='', ticker='', field=''):
"""
获取香港交易所上市股票的基本信息，包含股票交易代码及其简称、股票类型、上市状态、上市板块、上市日期等；上市状态为最新状态。
"""
code, result = self.client.getData(vs.HKEQU % (listStatusCD, secID, ticker, field))
return _ret_data(code, result)
def HKEquCA(self, secID='', ticker='', eventTypeCD='', field=''):
"""
获取香港交易所上市公司行为，包含有首发、现金增资、分红、拆细等。
"""
code, result = self.client.getData(vs.HKEQUCA % (secID, ticker, eventTypeCD, field))
return _ret_data(code, result)
class Idx():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Idx(self, secID='', ticker='', field=''):
"""
获取国内外指数的基本要素信息，包括指数名称、指数代码、发布机构、发布日期、基日、基点等。
"""
code, result = self.client.getData(vs.IDX % (secID, ticker, field))
return _ret_data(code, result)
def IdxCons(self, secID='', ticker='', intoDate='', isNew='', field=''):
"""
获取国内外指数的成分构成情况，包括指数成分股名称、成分股代码、入选日期、剔除日期等。
"""
code, result = self.client.getData(vs.IDXCONS % (secID, ticker, intoDate,
intoDate, isNew, field))
return _ret_data(code, result)
class IV():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def DerIv(self, beginDate='', endDate='', optID='', SecID='', field=''):
"""
原始隐含波动率,包括期权价格、累计成交量、持仓量、隐含波动率等。
"""
code, result = self.client.getData(vs.DERIV % (beginDate, endDate, optID, SecID, field))
return _ret_data(code, result)
def DerIvHv(self, beginDate='', endDate='', SecID='', period='', field=''):
"""
历史波动率，各个时间段的收盘－收盘历史波动率。
"""
code, result = self.client.getData(vs.DERIVHV % (beginDate, endDate, SecID, period, field))
return _ret_data(code, result)
def DerIvIndex(self, beginDate='', endDate='', SecID='', period='', field=''):
"""
隐含波动率指数，衡量30天至1080天到期平价期权的平均波动性的主要方法。
"""
code, result = self.client.getData(vs.DERIVINDEX % (beginDate, endDate, SecID, period, field))
return _ret_data(code, result)
def DerIvIvpDelta(self, beginDate='', endDate='', SecID='', delta='', period='', field=''):
"""
隐含波动率曲面(基于参数平滑曲线)，基于delta（0.1至0.9,0.05升步）和到期日（1个月至3年）而标准化的曲面。
"""
code, result = self.client.getData(vs.DERIVIVPDELTA % (beginDate, endDate, SecID, delta, period, field))
return _ret_data(code, result)
def DerIvParam(self, beginDate='', endDate='', SecID='', expDate='', field=''):
"""
隐含波动率参数化曲面，由二阶方程波动曲线在每个到期日平滑后的曲面（a,b,c曲线系数）
"""
code, result = self.client.getData(vs.DERIVPARAM % (beginDate, endDate, SecID, expDate, field))
return _ret_data(code, result)
def DerIvRawDelta(self, beginDate='', endDate='', SecID='', delta='', period='', field=''):
"""
隐含波动率曲面(基于原始隐含波动率)，基于delta（0.1至0.9,0.05升步）和到期日（1个月至3年）而标准化的曲面。
"""
code, result = self.client.getData(vs.DERIVRAWDELTA % (beginDate, endDate, SecID, delta, period, field))
return _ret_data(code, result)
def DerIvSurface(self, beginDate='', endDate='', SecID='', contractType='', field=''):
"""
隐含波动率曲面(在值程度)，基于在值程度而标准化的曲面。执行价格区间在-60%到+60%，5%升步，到期区间为1个月至3年。
"""
code, result = self.client.getData(vs.DERIVSURFACE % (beginDate, endDate, SecID, contractType, field))
return _ret_data(code, result)
class HKequity():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def HKEqu(self, listStatusCD='', secID='', ticker='', field=''):
"""
获取香港交易所上市股票的基本信息，包含股票交易代码及其简称、股票类型、上市状态、上市板块、上市日期等；上市状态为最新状态。
"""
code, result = self.client.getData(
vs.HKEQU % (listStatusCD, secID, ticker, field))
return _ret_data(code, result)
def HKEquCA(self, secID='', ticker='', eventTypeCD='', field=''):
"""
获取香港交易所上市公司行为，包含有首发、现金增资、分红、拆细等。
"""
code, result = self.client.getData(vs.HKEQUCA %
(secID, ticker, eventTypeCD, field))
return _ret_data(code, result)
class Options():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Opt(self,
contractStatus='',
optID='',
secID='',
ticker='',
varSecID='',
varticker='',
field=''):
"""
获取期权合约编码，交易代码，交易市场，标的等相关信息
"""
code, result = self.client.getData(
vs.OPT %
(contractStatus, optID, secID, ticker, varSecID, varticker, field))
return _ret_data(code, result)
def OptVar(self,
exchangeCD='',
secID='',
ticker='',
contractType='',
exerType='',
field=''):
"""
获取期权品种名称、生效日期、履约方式、交割方式、申报单位等相关信息。
"""
code, result = self.client.getData(
vs.OPTVAR %
(exchangeCD, secID, ticker, contractType, exerType, field))
return _ret_data(code, result)
class Equity():
def __init__(self, client=None):
if not client:
self.client = Client(up.get_token())
else:
self.client = client
def Equ(self, equTypeCD='', secID='', ticker='', listStatusCD='', field=''):
"""
获取股票的基本信息，包含股票交易代码及其简称、股票类型、上市状态、上市板块、上市日期等；上市状态为最新数据，不显示历史变动信息。
"""
code, result = self.client.getData(vs.EQU%(equTypeCD, secID, ticker, listStatusCD, field))
return _ret_data(code, result)
def EquAllot(self, isAllotment='', secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取股票历次配股的基本信息，包含每次配股方案的内容、方案进度、历史配股预案公布次数以及最终是否配股成功。
"""
code, result = self.client.getData(vs.EQUALLOT%(isAllotment, secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
def EquDiv(self, eventProcessCD='', exDivDate='', secID='', ticker='', beginDate='',
endDate='', field=''):
"""
获取股票历次分红(派现、送股、转增股)的基本信息，包含历次分红预案的内容、实施进展情况以及历史宣告分红次数。
"""
code, result = self.client.getData(vs.EQUDIV%(eventProcessCD, exDivDate,
secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def EquIndustry(self, industry='', industryID='', industryVersionCD='', secID='',
ticker='', intoDate='', field=''):
"""
输入证券ID或股票交易代码，获取股票所属行业分类
"""
code, result = self.client.getData(vs.EQUINDUSTRY%(industry, industryID, industryVersionCD,
secID, ticker, intoDate, field))
return _ret_data(code, result)
def EquIPO(self, eventProcessCD='', secID='', ticker='', field=''):
"""
获取股票首次公开发行上市的基本信息，包含股票首次公开发行的进程及发行结果。
"""
code, result = self.client.getData(vs.EQUIPO%(eventProcessCD, secID, ticker, field))
return _ret_data(code, result)
def EquRef(self, secID='', ticker='', beginDate='', endDate='', eventProcessCD='', field=''):
"""
获取股票股权分置改革的基本信息，包含股改进程、股改实施方案以及流通股的变动情况。
"""
code, result = self.client.getData(vs.EQUREF%(secID, ticker, beginDate, endDate,
eventProcessCD, field))
return _ret_data(code, result)
def EquRetud(self, listStatusCD='', secID='', ticker='', beginDate='',
dailyReturnNoReinvLower='', dailyReturnNoReinvUpper='',
dailyReturnReinvLower='', dailyReturnReinvUpper='',
endDate='', isChgPctl='', field=''):
"""
获取股票每日回报率的基本信息，包含交易当天的上市状态、日行情以及除权除息事项的基本数据。
"""
code, result = self.client.getData(vs.EQURETUD%(listStatusCD, secID, ticker,
beginDate, dailyReturnNoReinvLower,
dailyReturnNoReinvUpper,
dailyReturnReinvLower,
dailyReturnReinvUpper,
endDate, isChgPctl, field))
return _ret_data(code, result)
def EquSplits(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取股票进行股本拆细或者缩股的基本信息。
"""
code, result = self.client.getData(vs.EQUSPLITS%(secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
def FstTotal(self, beginDate='', endDate='', exchangeCD='', field=''):
"""
获取上海、深圳交易所公布的每个交易日的融资融券交易汇总的信息，包括成交量、成交金额。本交易日可获取前一交易日的数据。
"""
code, result = self.client.getData(vs.FSTTOTAL%(beginDate, endDate,
exchangeCD, field))
return _ret_data(code, result)
def FstDetail(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取上海、深圳交易所公布的每个交易日的融资融券交易具体的信息，包括标的证券信息、融资融券金额以及数量方面的数据。本交易日可获取前一交易日的数据。
"""
code, result = self.client.getData(vs.FSTDETAIL%(secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
def EquShare(self, secID='', ticker='', beginDate='', endDate='',
partyID='', field=''):
"""
获取上市公司股本结构及历次股本变动数据。
"""
code, result = self.client.getData(vs.EQUSHARE%(secID, ticker,
beginDate, endDate,
partyID, field))
return _ret_data(code, result)
def SecST(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
通过输入股票ID（通联编制）或股票交易代码（支持多值输入，最大支持50只），选择查询开始日期与结束日期，获取股票在一段时间ST标记信息。
"""
code, result = self.client.getData(vs.SECST%(secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
class Subject():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def SocialDataXQ(self, beginDate='', endDate='', ticker='', field=''):
"""
包含雪球社交统计数据，输入一个或多个证券交易代码、统计起止日期，获取该证券一段时间内每天的雪球帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQ %
(beginDate, endDate, ticker, field))
return _ret_data(code, result)
def SocialDataXQByTicker(self, ticker='', field=''):
"""
包含按单只证券代码获取的雪球社交数据，输入一个证券交易代码，获取该证券每天的雪球帖子数量、及帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQBYTICKER %
(ticker, field))
return _ret_data(code, result)
def SocialDataXQByDate(self, statisticsDate='', field=''):
"""
包含按单个统计日期获取的雪球社交数据，输入一个统计日期，获取当天雪球帖子涉及的所有证券、各证券雪球帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQBYDATE %
(statisticsDate, field))
return _ret_data(code, result)
def NewsInfo(self, newsID='', field=''):
"""
包含新闻基本信息。输入新闻ID，获取新闻基本信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、每天新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSINFO % (newsID, field))
return _ret_data(code, result)
def NewsInfoByTime(self,
newsPublishDate='',
beginTime='',
endTime='',
field=''):
"""
获取某天某一段时间内的新闻基本信息。输入新闻发布的日期、起止时间，获取该时间段内的新闻相关信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSINFOBYTIME % (newsPublishDate, beginTime, endTime, field))
return _ret_data(code, result)
def NewsContent(self, newsID='', field=''):
"""
包含新闻全文等信息。输入新闻ID，获取新闻全文相关字段，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSCONTENT % (newsID, field))
return _ret_data(code, result)
def NewsContentByTime(self,
newsPublishDate='',
beginTime='',
endTime='',
field=''):
"""
获取某天某一段时间内的新闻全文等信息。输入新闻发布的日期、起止时间，获取该时间段内的新闻全文等信息，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSCONTENTBYTIME %
(newsPublishDate, beginTime, endTime, field))
return _ret_data(code, result)
def CompanyByNews(self, newsID='', field=''):
"""
包含新闻关联的公司数据，同时可获取针对不同公司的新闻情感数据。输入新闻ID，获取相关的公司信息，如：公司代码、公司全称，同时返回新闻标题、发布时间、入库时间信息。其中，公司代码可继续通过证券编码及基本上市信息(getSecID)查找公司相关的证券。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.COMPANYBYNEWS % (newsID, field))
return _ret_data(code, result)
def NewsByCompany(self, partyID='', beginDate='', endDate='', field=''):
"""
包含公司关联的新闻数据，同时可获取针对不同公司的新闻情感数据。输入公司代码、查询的新闻发布起止时间，获取相关的新闻信息，如：新闻ID、新闻标题、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSBYCOMPANY % (partyID, beginDate, endDate, field))
return _ret_data(code, result)
def TickersByNews(self, newsID='', field=''):
"""
包含新闻相关的证券数据，同时可获取针对不同证券的新闻情感数据。输入新闻ID，获取相关的证券信息，如：证券代码、证券简称、证券交易场所，同时返回新闻标题、发布来源、发布时间、入库时间等新闻相关信息。每天更新。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.TICKERSBYNEWS % (newsID, field))
return _ret_data(code, result)
def NewsByTickers(self,
secID='',
secShortName='',
ticker='',
beginDate='',
endDate='',
exchangeCD='',
field=''):
"""
包含证券相关的新闻数据，同时可获取针对不同证券的新闻情感数据。输入证券代码或简称、查询的新闻发布起止时间，同时可输入证券交易所代码，获取相关新闻数据，如：新闻ID、新闻标题、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSBYTICKERS % (secID, secShortName, ticker, beginDate,
endDate, exchangeCD, field))
return _ret_data(code, result)
def ThemesContent(self,
isMain='',
themeID='',
themeName='',
themeSource='',
field=''):
"""
包含所有主题基本信息。输入主题代码或名称、主题来源，可以获取主题相关信息，包括主题ID、主题名称、主题描述、主题来源、当天是否活跃、主题插入时间、主题更新时间等。(注：1、主题基期自2011/4/16始；2、数据按日更新主题活跃状态。)
"""
code, result = self.client.getData(
vs.THEMESCONTENT %
(isMain, themeID, themeName, themeSource, field))
return _ret_data(code, result)
def TickersByThemes(self,
themeID='',
themeName='',
beginDate='',
endDate='',
isNew='',
field=''):
"""
包含主题关联的证券数据。输入主题代码或名称，可以获取主题关联的证券等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取主题在该时间段内关联的证券信息。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新、同时刷新关联状态。)
"""
code, result = self.client.getData(
vs.TICKERSBYTHEMES %
(themeID, themeName, beginDate, endDate, isNew, field))
return _ret_data(code, result)
def ThemesTickersInsert(self,
themeID='',
themeName='',
beginDate='',
endDate='',
field=''):
"""
获取一段时间内主题新增的关联证券数据，输入主题代码或名称、查询起止时间，可以获取该时间段内主题新增的关联证券信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(
vs.THEMESTICKERSINSERT %
(themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def ThemesTickersDelete(self,
themeID='',
themeName='',
beginDate='',
endDate='',
field=''):
"""
获取一段时间内主题删除的关联证券数据，输入主题代码或名称、查询起止时间，可以获取该时间段内主题删除的关联证券信息，包括证券代码、证券简称、证券交易场所，同时返回关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(
vs.THEMESTICKERSDELETE %
(themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def ThemesByTickers(self,
secID='',
secShortName='',
ticker='',
beginDate='',
endDate='',
exchangeCD='',
field=''):
"""
包含证券关联的主题数据。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(
vs.THEMESBYTICKERS % (secID, secShortName, ticker, beginDate,
endDate, exchangeCD, field))
return _ret_data(code, result)
def ThemesPeriod(self, isLatest='', themeID='', themeName='', field=''):
"""
包含主题活跃周期数据。输入主题代码或名称，获取主题的活跃时间等信息，同时可输入是否最新活跃期，获取主题最新的活跃周期。(注：1、主题活跃周期数据自2013/1/1始；2、新闻量在某段时间内达到活跃阈值的主题即为活跃主题；3、数据按日更新。)
"""
code, result = self.client.getData(
vs.THEMESPERIOD % (isLatest, themeID, themeName, field))
return _ret_data(code, result)
def ActiveThemes(self, date='', field=''):
"""
获取某天活跃的主题数据。输入一个日期，获取在该日期活跃的主题。(注：1、主题活跃周期数据自2013/1/1始；2、新闻量在某段时间内达到活跃阈值的主题即为活跃主题；3、数据按日更新。)
"""
code, result = self.client.getData(vs.ACTIVETHEMES % (date, field))
return _ret_data(code, result)
def ThemesSimilarity(self, themeID='', themeName='', field=''):
"""
获取与某主题相似的其他主题数据。输入主题代码或名称，可以获取相似的主题信息，包括相似主题代码、相似主题名称、主题文本的相似度、主题关联证券的相似度。数据按日更新。
"""
code, result = self.client.getData(vs.THEMESSIMILARITY %
(themeID, themeName, field))
return _ret_data(code, result)
def ThemesHeat(self,
themeID='',
themeName='',
beginDate='',
endDate='',
field=''):
"""
包含主题的热度数据。输入主题代码或名称、同时可输入起止日期，获取一段时间内主题每天的新闻数量、主题热度(即主题每天新闻数量占当日所有主题新闻总量的百分比(%))。(注：数据自2014/1/1始，每天更新)
"""
code, result = self.client.getData(
vs.THEMESHEAT % (themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def SectorThemesByTickers(self,
secID='',
secShortName='',
ticker='',
beginDate='',
endDate='',
exchangeCD='',
field=''):
"""
包含证券关联的主题数据，主题源自申万行业。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、源自行业的主题与证券的关联自2014/12/26始；2、数据按日更新、同时刷新关联状态。)
"""
code, result = self.client.getData(
vs.SECTORTHEMESBYTICKERS % (secID, secShortName, ticker, beginDate,
endDate, exchangeCD, field))
return _ret_data(code, result)
def WebThemesByTickers(self,
secID='',
secShortName='',
ticker='',
beginDate='',
endDate='',
exchangeCD='',
field=''):
"""
包含证券关联的主题数据，主题源自网络。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、源自网络的主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(
vs.WEBTHEMESBYTICKERS % (secID, secShortName, ticker, beginDate,
endDate, exchangeCD, field))
return _ret_data(code, result)
def NewsHeatIndex(self,
beginDate='',
endDate='',
exchangeCD='',
secID='',
secShortName='',
ticker='',
field=''):
"""
包含证券相关的新闻热度指数数据，输入一个或多个证券交易代码、起止日期，获取该证券一段时间内的新闻热度指数(即证券当天关联新闻数量占当天新闻总量的百分比(%))。每天更新。（注：1、2014/1/1起新闻来源众多、指数统计有效，2013年及之前的网站来源不全、数据波动大，数据自2004/10/28始；2、新闻量的统计口径为经算法处理后证券关联到的所有常规新闻；3、数据按日更新。)
"""
code, result = self.client.getData(
vs.NEWSHEATINDEX % (beginDate, endDate, exchangeCD, secID,
secShortName, ticker, field))
return _ret_data(code, result)
def NewsSentimentIndex(self,
beginDate='',
endDate='',
exchangeCD='',
secID='',
secShortName='',
ticker='',
field=''):
"""
包含证券相关的新闻情感指数数据，输入一个或多个证券交易代码、起止日期，获取该证券一段时间内的新闻情感指数(即当天证券关联新闻的情感均值)。（注：1、2014/1/1起新闻来源众多、指数统计有效，2013年及之前的网站来源不全、数据波动大，数据自2004/10/28始；2、新闻量的统计口径为经算法处理后证券关联到的所有常规新闻；3、数据按日更新。)
"""
code, result = self.client.getData(
vs.NEWSSENTIMENTINDEX % (beginDate, endDate, exchangeCD, secID,
secShortName, ticker, field))
return _ret_data(code, result)
def ReportByTicker(self, ticker='', beginDate='', endDate='', field=''):
"""
根据证券代码获取相应公告分类结果，输入一个或多个证券交易代码，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告分类结果、公告分类入库时间、更新时间。(注：公告分类数据自2009/1/5始，按日更新)
"""
code, result = self.client.getData(vs.REPORTBYTICKER %
(ticker, beginDate, endDate, field))
return _ret_data(code, result)
def ReportByCategory(self,
beginDate='',
Category='',
endDate='',
field=''):
"""
根据公告分类获取相应公告信息，输入一个或多个公告分类，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告所属分类、公告分类入库时间、更新时间。(注：公告分类数据自2009/1/5始，按日更新)
"""
code, result = self.client.getData(
vs.REPORTBYCATEGORY % (beginDate, Category, endDate, field))
return _ret_data(code, result)
def ReportContent(self, ticker='', beginDate='', endDate='', field=''):
"""
根据证券代码获取公告内容，输入一个或多个证券交易代码，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告具体内容、公告链接、公告入库时间。(注：公告数据自2000/1/8始，按日更新)
"""
code, result = self.client.getData(vs.REPORTCONTENT %
(ticker, beginDate, endDate, field))
return _ret_data(code, result)
def ActiveThemesInsert(self,
beginDate='',
endDate='',
isLatest='',
themeSource='',
field=''):
"""
获取一段时间内新增(开始)的活跃主题数据，输入的时间参数在主题活跃周期的起始时间列进行查询。输入查询起止时间、是否最新活跃期、主题来源，可以获取该时间段内开始活跃的主题信息，包括主题ID、主题名称、主题开始时间、主题结束时间、是否最新活跃期、数据入库及更新时间。(注：1、主题活跃周期数据自2013/1/1始；2、数据按日更新。)
"""
code, result = self.client.getData(
vs.ACTIVETHEMESINSERT %
(beginDate, endDate, isLatest, themeSource, field))
return _ret_data(code, result)
def ActiveThemesDelete(self,
beginDate='',
endDate='',
isLatest='',
themeSource='',
field=''):
"""
获取一段时间内删除(退出)的活跃主题数据，输入的时间参数在主题活跃周期的结束时间列进行查询。输入查询起止时间、是否最新活跃期、主题来源，可以获取该时间段内停止活跃的主题信息，包括主题ID、主题名称、主题开始时间、主题结束时间、是否最新活跃期、数据入库及更新时间。(注：1、主题活跃周期数据自2013/1/1始；2、数据按日更新。3、查询当天无活跃主题被删除、需等第二天9:00之后获取前一天停止活跃的主题数据。)
"""
code, result = self.client.getData(
vs.ACTIVETHEMESDELETE %
(beginDate, endDate, isLatest, themeSource, field))
return _ret_data(code, result)
def ThemesCluster(self, isMain='', themeID='', themeName='', field=''):
"""
获取当天活跃主题聚类对应关系数据。输入聚类后的主要主题代码或名称，可以获取同一类别的主题相关信息，包括主题ID、主题名称、主题插入时间、主题更新时间等。(注：1、可先在主题基本信息(getThemesContent)这个API中获取当天聚类后的主题；2、可输入isMain=0，在返回的数据中剔除主题自身的对应；3、数据每天刷新，只能获取当天数据。)
"""
code, result = self.client.getData(vs.THEMESCLUSTER %
(isMain, themeID, themeName, field))
return _ret_data(code, result)
def ThemesByNews(self,
insertDate='',
newsID='',
beginTime='',
endTime='',
field=''):
"""
获取新闻关联的主题数据。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWS % (insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesByNewsCompanyRel(self,
insertDate='',
newsID='',
beginTime='',
endTime='',
field=''):
"""
获取新闻关联的主题数据，只包含与公司相关的新闻。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSCOMPANYREL %
(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesInsertDB(self,
beginDate='',
endDate='',
themeSource='',
field=''):
"""
获取一段时间内新入库的主题数据。输入查询起止时间，可以获取该时间段内新入库的主题信息，包括主题ID、主题名称、主题描述、主题来源、当天是否活跃、主题插入时间、主题更新时间等。(注：1、主题基期自2011/4/16始；2、数据按日更新主题活跃状态。)
"""
code, result = self.client.getData(
vs.THEMESINSERTDB % (beginDate, endDate, themeSource, field))
return _ret_data(code, result)
def ThemesByNewsLF(self,
insertDate='',
newsID='',
beginTime='',
endTime='',
field=''):
"""
获取新闻关联的主题数据，该API以获取新闻关联的主题(getThemesByNews)为基础、进行过滤优化。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSLF %
(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesByNewsMF(self,
insertDate='',
newsID='',
beginTime='',
endTime='',
field=''):
"""
获取新闻关联的主题数据，该API以获取新闻关联的主题(优化后)(getThemesByNewsLF)为基础、再次进行过滤优化，是所有获取新闻关联的主题API中最严格的优化结果、数据量也最少。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSMF %
(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def NewsInfoByInsertTime(self,
newsInsertDate='',
beginTime='',
endTime='',
field=''):
"""
获取某天某一段时间内入库的新闻基本信息。输入新闻入库的日期、起止时间，获取该时间段内新入库的新闻相关信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSINFOBYINSERTTIME %
(newsInsertDate, beginTime, endTime, field))
return _ret_data(code, result)
def NewsContentByInsertTime(self,
newsInsertDate='',
beginTime='',
endTime='',
field=''):
"""
获取某天某一段时间内入库的新闻全文等信息。输入新闻入库的日期、起止时间，获取该时间段内新入库的新闻全文等信息，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(
vs.NEWSCONTENTBYINSERTTIME %
(newsInsertDate, beginTime, endTime, field))
return _ret_data(code, result)
def SocialDataGuba(self, beginDate='', endDate='', ticker='', field=''):
"""
包含证券在股吧社交中的热度统计数据，输入一个或多个证券交易代码、统计起止日期，该证券在一段时间内每天相关的股吧帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAGUBA %
(beginDate, endDate, ticker, field))
return _ret_data(code, result)
def SocialThemeDataGuba(self,
beginDate='',
endDate='',
themeID='',
field=''):
"""
包含主题在股吧社交中的热度统计数据，输入一个或多个主题代码、统计起止日期，获取该主题在一段时间内每天相关的股吧帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(
vs.SOCIALTHEMEDATAGUBA % (beginDate, endDate, themeID, field))
return _ret_data(code, result)
def ThemesByNewsTime(self,
publishBeginTime='',
publishEndTime='',
field=''):
"""
根据发布时间获取新闻关联的主题数据。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSTIME % (publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeCompanyRel(self,
publishBeginTime='',
publishEndTime='',
field=''):
"""
根据发布时间获取新闻关联的主题数据，只包含与公司相关的新闻。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSTIMECOMPANYREL %
(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeLF(self,
publishBeginTime='',
publishEndTime='',
field=''):
"""
根据发布时间获取新闻关联的主题数据，该API以获取新闻关联的主题(getThemesByNewsTime)为基础、进行过滤优化。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSTIMELF % (publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeMF(self,
publishBeginTime='',
publishEndTime='',
field=''):
"""
根据发布时间获取新闻关联的主题数据，该API以获取新闻关联的主题(优化后)(getThemesByNewsTimeLF)为基础、再次进行过滤优化，是所有获取新闻关联的主题API中最严格的优化结果、数据量也最少。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSTIMEMF % (publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ReportContentByID(self, reportID='', field=''):
"""
根据公告ID获取公告原始内容数据，输入公告ID，获取公告原文等信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告具体内容、公告链接、公告入库时间。(注：公告数据自2000/1/8始，按日更新)
"""
code, result = self.client.getData(vs.REPORTCONTENTBYID %
(reportID, field))
return _ret_data(code, result)
def ThemesByNews2(self,
insertBeginTime='',
insertEndTime='',
newsID='',
field=''):
"""
获取新闻关联的主题数据，原API(获取新闻关联的主题数据-getThemesByNews)的升级版。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/06/17)
"""
code, result = self.client.getData(
vs.THEMESBYNEWS2 % (insertBeginTime, insertEndTime, newsID, field))
return _ret_data(code, result)
def ThemesByNewsTime2(self,
publishBeginTime='',
publishEndTime='',
field=''):
"""
根据发布时间获取新闻关联的主题数据，原API(根据发布时间获取新闻关联的主题数据-getThemesByNewsTime)的升级版。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/06/17。)
"""
code, result = self.client.getData(
vs.THEMESBYNEWSTIME2 % (publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
class Master():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def SecID(self, assetClass='', cnSpell='', partyID='', ticker='', field=''):
"""
通过机构partyID,或证券简称拼音cnSpell,或证券交易代码ticker，
检索证券ID（证券在数据结构中的一个唯一识别的编码），
也可通过证券简称拼音cnSpell检索证券交易代码ticker等；同时可以获取输入证券的基本上市信息，如交易市场，上市状态，交易币种，ISIN编码等。
"""
code, result = self.client.getData(vs.SECID%(assetClass, cnSpell, partyID, ticker, field))
return _ret_data(code, result)
def TradeCal(self, exchangeCD='', beginDate='', endDate='', field=''):
"""
记录了上海证券交易所,深圳证券交易所,中国银行间市场,大连商品交易所,郑州商品交易所,上海期货交易所,
中国金融期货交易所和香港交易所等交易所在日历日期当天是否开市的信息，
其中上证、深证记录了自成立以来的全部日期是否开始信息。各交易日节假日安排通知发布当天即更新数据。
"""
code, result = self.client.getData(vs.TRADECAL%(exchangeCD, beginDate, endDate, field))
return _ret_data(code, result)
def Industry(self, industryVersion='', industryVersionCD='', industryLevel='', isNew='', field=''):
"""
输入行业分类通联编码(如，010303表示申万行业分类2014版)或输入一个行业分类标准名称，获取行业分类标准下行业划分
"""
code, result = self.client.getData(vs.INDUSTRY%(industryVersion, industryVersionCD,
industryLevel, isNew, field))
return _ret_data(code, result)
def SecTypeRel(self, secID='', ticker='', typeID='', field=''):
"""
记录证券每个分类的成分，证券分类可通过在getSecType获取。
"""
code, result = self.client.getData(vs.SECTYPEREL%(secID, ticker, typeID, field))
return _ret_data(code, result)
def EquInfo(self, ticker='', field=''):
"""
根据拼音或股票代码，匹配股票代码、名称。包含正在上市的全部沪深股票。
"""
code, result = self.client.getData(vs.EQUINFO%(ticker, field))
return _ret_data(code, result)
def SecTypeRegionRel(self, secID='', ticker='', typeID='', field=''):
"""
获取沪深股票地域分类，以注册地所在行政区域为标准。
"""
code, result = self.client.getData(vs.SECTYPEREGIONREL%(secID, ticker, typeID, field))
return _ret_data(code, result)
def SecType(self, field=''):
"""
证券分类列表，一级分类包含有沪深股票、港股、基金、债券、期货、期权等，每个分类又细分有不同类型；可一次获取全部分类。
"""
code, result = self.client.getData(vs.SECTYPE%(field))
return _ret_data(code, result)
def SecTypeRegion(self, field=''):
"""
获取中国地域分类，以行政划分为标准。
"""
code, result = self.client.getData(vs.SECTYPEREGION%(field))
return _ret_data(code, result)
def SysCode(self, codeTypeID='', valueCD='', field=''):
"""
各api接口有枚举值特性的输出列，如getSecID输出项exchangeCD值，编码分别代表的是什么市场，所有枚举值都可以在这个接口获取。
"""
code, result = self.client.getData(vs.SYSCODE%(codeTypeID, valueCD, field))
return _ret_data(code, result)
def __init__(self, index_config_dict):
super().__init__(Client(get_token()))
index_path = index_config_dict['path']
index_file = index_config_dict['file']
self.index_filepath = path.join(index_path, index_file)
class Fundamental():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def FdmtBS(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的合并资产负债表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的资产负债表数据；
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTBS % (reportType, secID, ticker,
beginDate, endDate, publishDateBegin,
publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSBank(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的银行业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是银行业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTBSBANK % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSSecu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的证券业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTBSSECU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin,
publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSIndu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的一般工商业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTBSINDU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSInsu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的保险业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元。
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTBSINSU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCF(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的合并现金流量表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的现金流量表数据；
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTCF % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFBank(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的银行业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是银行业上市公司） 2、仅收集合并报表数据，包括本期和上期数据； 3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示； 4、本表中单位为人民币元；5、每季更新。
"""
code, result = self.client.getData(vs.FDMTCFBANK % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFSecu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的证券业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTCFSECU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFIndu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的一般工商业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTCFINDU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFInsu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的保险业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTCFINSU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtIS(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的合并利润表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的利润表数据；
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTIS % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISBank(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的银行业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是银行业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTISBANK % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISSecu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的证券业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTISSECU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISIndu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的一般工商业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTISINDU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISInsu(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
1、根据2007年新会计准则制定的保险业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(vs.FDMTISINSU % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtEe(self, reportType='', secID='', ticker='', beginDate='', endDate='',
publishDateBegin='', publishDateEnd='', field=''):
"""
获取2007年及以后年度上市公司披露的业绩快报中的主要财务指标等其他数据，
包括本期，去年同期，及本期与期初数值同比数据。每季证券交易所披露相关公告时更新数据，
公司ipo时发布相关信息也会同时更新。每日9：00前完成证券交易所披露的数据更新，中午发布公告每日12：45前完成更新。
"""
code, result = self.client.getData(vs.FDMTEE % (reportType, secID, ticker,
beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtEf(self, reportType='', secID='', ticker='', beginDate='', endDate='',
forecastType='', publishDateBegin='', publishDateEnd='', field=''):
"""
1、获取2007年及以后年度上市公司披露的公告中的预期下一报告期收入、净利润、归属于母公司净利润、基本每股收益及其幅度变化数据。
2、上市公司对经营成果科目的预计情况数据一般为其上限与下限，上限取值为公告中披露该科目中绝对值较大值，下限取值为公告中披露该科目中绝对值较小值。
3、数值为"正"代表该公司预计盈利，数值为"负"代表该公司预计亏损。若上下限"正"、"负"符号不同，代表该公司盈利亏损情况尚不确定。
4、业绩预期类型以公告中文字披露预期类型为准，若公告中未有文字披露预期类型，则根据数据情况判断预期类型。
5、每季证券交易所披露相关公告时更新数据，公司ipo时发布相关信息也会同时更新。每日9：00前完成证券交易所披露的数据更新，中午发布公告每日12：45前完成更新。
"""
code, result = self.client.getData(vs.FDMTEF % (reportType, secID, ticker,
beginDate, endDate, forecastType,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISLately(self, field=''):
"""
1、可获取上市公司最近一次数据，根据2007年新会计准则制定的合并利润表模板，仅收集合并报表数据；
2、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
3、本表中单位为人民币元；
4、每季更新。
"""
code, result = self.client.getData(vs.FDMTISLATELY % (field))
return _ret_data(code, result)
class Bond():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Bond(self, secID='', ticker='', field=''):
"""
债券的基本面信息，涵盖了债券计息方式、付息频率、起息日、到期日、兑付形式等。
"""
code, result = self.client.getData(vs.BOND%(secID, ticker, field))
return _ret_data(code, result)
def BondCf(self, secID='', ticker='', beginDate='', cashTypeCD='',
endDate='', field=''):
"""
债券在每个计息周期付息兑付的相关数据。日期区间默认为过去一年。
"""
code, result = self.client.getData(vs.BONDCF%(secID, ticker,
beginDate, cashTypeCD, endDate, field))
return _ret_data(code, result)
def BondCoupon(self, secID='', ticker='', field=''):
"""
固定利率债券、浮动利率债券每个计息周期的票面利率，包括分段计息的具体利率。
"""
code, result = self.client.getData(vs.BONDCOUPON%(secID, ticker, field))
return _ret_data(code, result)
def BondGuar(self, secID='', ticker='', guarModeCD='', field=''):
"""
收录债券担保信息，如担保人、担保类型、担保方式、担保期限等。
"""
code, result = self.client.getData(vs.BONDGUAR%(secID, ticker, guarModeCD, field))
return _ret_data(code, result)
def BondIssue(self, secID='', ticker='', raiseModeCD='', field=''):
"""
债券在一级市场发行信息，记录的要素包括有发行方式、发行价格、当次发行规模等
"""
code, result = self.client.getData(vs.BONDISSUE%(secID, ticker, raiseModeCD, field))
return _ret_data(code, result)
def BondOption(self, secID='', ticker='', field=''):
"""
记录债券在发行时约定在存续期内投资人或发行人可行使的选择权，如债券回售、债券赎回等。
"""
code, result = self.client.getData(vs.BONDOPTION%(secID, ticker, field))
return _ret_data(code, result)
def BondRating(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
债券的长期评级、短期评级以及历史评级变动记录。
"""
code, result = self.client.getData(vs.BONDRATING%(secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
def GuarRating(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
各评级机构公布的债券担保人的信用评级数据及历史变动记录。
"""
code, result = self.client.getData(vs.GUARRATING%(secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
def IssuerRating(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
各评级机构公布的债券发行人的信用评级数据及历史变动记录。
"""
code, result = self.client.getData(vs.ISSUERRATING%(secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
def Repo(self, secID='', ticker='', field=''):
"""
债券回购基本面信息，涵盖了回购交易代码、回购期限、申报价格最小变动单位(RMB)、申报参与价格单位(RMB)等。
"""
code, result = self.client.getData(vs.REPO%(secID, ticker, field))
return _ret_data(code, result)
class Subject():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def SocialDataXQ(self, beginDate='', endDate='', ticker='', field=''):
"""
包含雪球社交统计数据，输入一个或多个证券交易代码、统计起止日期，获取该证券一段时间内每天的雪球帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQ%(beginDate, endDate, ticker, field))
return _ret_data(code, result)
def SocialDataXQByTicker(self, ticker='', field=''):
"""
包含按单只证券代码获取的雪球社交数据，输入一个证券交易代码，获取该证券每天的雪球帖子数量、及帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQBYTICKER%(ticker, field))
return _ret_data(code, result)
def SocialDataXQByDate(self, statisticsDate='', field=''):
"""
包含按单个统计日期获取的雪球社交数据，输入一个统计日期，获取当天雪球帖子涉及的所有证券、各证券雪球帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAXQBYDATE%(statisticsDate, field))
return _ret_data(code, result)
def NewsInfo(self, newsID='', field=''):
"""
包含新闻基本信息。输入新闻ID，获取新闻基本信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、每天新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSINFO%(newsID, field))
return _ret_data(code, result)
def NewsInfoByTime(self, newsPublishDate='', beginTime='', endTime='', field=''):
"""
获取某天某一段时间内的新闻基本信息。输入新闻发布的日期、起止时间，获取该时间段内的新闻相关信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSINFOBYTIME%(newsPublishDate, beginTime, endTime, field))
return _ret_data(code, result)
def NewsContent(self, newsID='', field=''):
"""
包含新闻全文等信息。输入新闻ID，获取新闻全文相关字段，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSCONTENT%(newsID, field))
return _ret_data(code, result)
def NewsContentByTime(self, newsPublishDate='', beginTime='', endTime='', field=''):
"""
获取某天某一段时间内的新闻全文等信息。输入新闻发布的日期、起止时间，获取该时间段内的新闻全文等信息，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSCONTENTBYTIME%(newsPublishDate, beginTime, endTime, field))
return _ret_data(code, result)
def CompanyByNews(self, newsID='', field=''):
"""
包含新闻关联的公司数据，同时可获取针对不同公司的新闻情感数据。输入新闻ID，获取相关的公司信息，如：公司代码、公司全称，同时返回新闻标题、发布时间、入库时间信息。其中，公司代码可继续通过证券编码及基本上市信息(getSecID)查找公司相关的证券。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.COMPANYBYNEWS%(newsID, field))
return _ret_data(code, result)
def NewsByCompany(self, partyID='', beginDate='', endDate='', field=''):
"""
包含公司关联的新闻数据，同时可获取针对不同公司的新闻情感数据。输入公司代码、查询的新闻发布起止时间，获取相关的新闻信息，如：新闻ID、新闻标题、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSBYCOMPANY%(partyID, beginDate, endDate, field))
return _ret_data(code, result)
def TickersByNews(self, newsID='', field=''):
"""
包含新闻相关的证券数据，同时可获取针对不同证券的新闻情感数据。输入新闻ID，获取相关的证券信息，如：证券代码、证券简称、证券交易场所，同时返回新闻标题、发布来源、发布时间、入库时间等新闻相关信息。每天更新。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.TICKERSBYNEWS%(newsID, field))
return _ret_data(code, result)
def NewsByTickers(self, secID='', secShortName='', ticker='', beginDate='', endDate='', exchangeCD='', field=''):
"""
包含证券相关的新闻数据，同时可获取针对不同证券的新闻情感数据。输入证券代码或简称、查询的新闻发布起止时间，同时可输入证券交易所代码，获取相关新闻数据，如：新闻ID、新闻标题、发布来源、发布时间、入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSBYTICKERS%(secID, secShortName, ticker, beginDate, endDate, exchangeCD, field))
return _ret_data(code, result)
def ThemesContent(self, isMain='', themeID='', themeName='', themeSource='', field=''):
"""
包含所有主题基本信息。输入主题代码或名称、主题来源，可以获取主题相关信息，包括主题ID、主题名称、主题描述、主题来源、当天是否活跃、主题插入时间、主题更新时间等。(注：1、主题基期自2011/4/16始；2、数据按日更新主题活跃状态。)
"""
code, result = self.client.getData(vs.THEMESCONTENT%(isMain, themeID, themeName, themeSource, field))
return _ret_data(code, result)
def TickersByThemes(self, themeID='', themeName='', beginDate='', endDate='', isNew='', field=''):
"""
包含主题关联的证券数据。输入主题代码或名称，可以获取主题关联的证券等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取主题在该时间段内关联的证券信息。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新、同时刷新关联状态。)
"""
code, result = self.client.getData(vs.TICKERSBYTHEMES%(themeID, themeName, beginDate, endDate, isNew, field))
return _ret_data(code, result)
def ThemesTickersInsert(self, themeID='', themeName='', beginDate='', endDate='', field=''):
"""
获取一段时间内主题新增的关联证券数据，输入主题代码或名称、查询起止时间，可以获取该时间段内主题新增的关联证券信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(vs.THEMESTICKERSINSERT%(themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def ThemesTickersDelete(self, themeID='', themeName='', beginDate='', endDate='', field=''):
"""
获取一段时间内主题删除的关联证券数据，输入主题代码或名称、查询起止时间，可以获取该时间段内主题删除的关联证券信息，包括证券代码、证券简称、证券交易场所，同时返回关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(vs.THEMESTICKERSDELETE%(themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def ThemesByTickers(self, secID='', secShortName='', ticker='', beginDate='', endDate='', exchangeCD='', field=''):
"""
包含证券关联的主题数据。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(vs.THEMESBYTICKERS%(secID, secShortName, ticker, beginDate, endDate, exchangeCD, field))
return _ret_data(code, result)
def ThemesPeriod(self, isLatest='', themeID='', themeName='', field=''):
"""
包含主题活跃周期数据。输入主题代码或名称，获取主题的活跃时间等信息，同时可输入是否最新活跃期，获取主题最新的活跃周期。(注：1、主题活跃周期数据自2013/1/1始；2、新闻量在某段时间内达到活跃阈值的主题即为活跃主题；3、数据按日更新。)
"""
code, result = self.client.getData(vs.THEMESPERIOD%(isLatest, themeID, themeName, field))
return _ret_data(code, result)
def ActiveThemes(self, date='', field=''):
"""
获取某天活跃的主题数据。输入一个日期，获取在该日期活跃的主题。(注：1、主题活跃周期数据自2013/1/1始；2、新闻量在某段时间内达到活跃阈值的主题即为活跃主题；3、数据按日更新。)
"""
code, result = self.client.getData(vs.ACTIVETHEMES%(date, field))
return _ret_data(code, result)
def ThemesSimilarity(self, themeID='', themeName='', field=''):
"""
获取与某主题相似的其他主题数据。输入主题代码或名称，可以获取相似的主题信息，包括相似主题代码、相似主题名称、主题文本的相似度、主题关联证券的相似度。数据按日更新。
"""
code, result = self.client.getData(vs.THEMESSIMILARITY%(themeID, themeName, field))
return _ret_data(code, result)
def ThemesHeat(self, themeID='', themeName='', beginDate='', endDate='', field=''):
"""
包含主题的热度数据。输入主题代码或名称、同时可输入起止日期，获取一段时间内主题每天的新闻数量、主题热度(即主题每天新闻数量占当日所有主题新闻总量的百分比(%))。(注：数据自2014/1/1始，每天更新)
"""
code, result = self.client.getData(vs.THEMESHEAT%(themeID, themeName, beginDate, endDate, field))
return _ret_data(code, result)
def SectorThemesByTickers(self, secID='', secShortName='', ticker='', beginDate='', endDate='', exchangeCD='', field=''):
"""
包含证券关联的主题数据，主题源自申万行业。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、源自行业的主题与证券的关联自2014/12/26始；2、数据按日更新、同时刷新关联状态。)
"""
code, result = self.client.getData(vs.SECTORTHEMESBYTICKERS%(secID, secShortName, ticker, beginDate, endDate, exchangeCD, field))
return _ret_data(code, result)
def WebThemesByTickers(self, secID='', secShortName='', ticker='', beginDate='', endDate='', exchangeCD='', field=''):
"""
包含证券关联的主题数据，主题源自网络。输入证券交易所代码、证券交易代码或简称，可以获取关联的主题等信息，包括证券代码、证券简称、证券交易场所，同时返回三个维度的关联分数、关联开始时间、关联结束时间、关联具体描述、数据入库及更新时间，同时可输入查询起止时间，以获取证券在该时间段内关联到的主题信息。(注：1、源自网络的主题与证券的关联自2013/12/28始、2014年12月起关联数据完整；2、数据按日更新。)
"""
code, result = self.client.getData(vs.WEBTHEMESBYTICKERS%(secID, secShortName, ticker, beginDate, endDate, exchangeCD, field))
return _ret_data(code, result)
def NewsHeatIndex(self, beginDate='', endDate='', exchangeCD='', secID='', secShortName='', ticker='', field=''):
"""
包含证券相关的新闻热度指数数据，输入一个或多个证券交易代码、起止日期，获取该证券一段时间内的新闻热度指数(即证券当天关联新闻数量占当天新闻总量的百分比(%))。每天更新。（注：1、2014/1/1起新闻来源众多、指数统计有效，2013年及之前的网站来源不全、数据波动大，数据自2004/10/28始；2、新闻量的统计口径为经算法处理后证券关联到的所有常规新闻；3、数据按日更新。)
"""
code, result = self.client.getData(vs.NEWSHEATINDEX%(beginDate, endDate, exchangeCD, secID, secShortName, ticker, field))
return _ret_data(code, result)
def NewsSentimentIndex(self, beginDate='', endDate='', exchangeCD='', secID='', secShortName='', ticker='', field=''):
"""
包含证券相关的新闻情感指数数据，输入一个或多个证券交易代码、起止日期，获取该证券一段时间内的新闻情感指数(即当天证券关联新闻的情感均值)。（注：1、2014/1/1起新闻来源众多、指数统计有效，2013年及之前的网站来源不全、数据波动大，数据自2004/10/28始；2、新闻量的统计口径为经算法处理后证券关联到的所有常规新闻；3、数据按日更新。)
"""
code, result = self.client.getData(vs.NEWSSENTIMENTINDEX%(beginDate, endDate, exchangeCD, secID, secShortName, ticker, field))
return _ret_data(code, result)
def ReportByTicker(self, ticker='', beginDate='', endDate='', field=''):
"""
根据证券代码获取相应公告分类结果，输入一个或多个证券交易代码，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告分类结果、公告分类入库时间、更新时间。(注：公告分类数据自2009/1/5始，按日更新)
"""
code, result = self.client.getData(vs.REPORTBYTICKER%(ticker, beginDate, endDate, field))
return _ret_data(code, result)
def ReportByCategory(self, beginDate='', Category='', endDate='', field=''):
"""
根据公告分类获取相应公告信息，输入一个或多个公告分类，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告所属分类、公告分类入库时间、更新时间。(注：公告分类数据自2009/1/5始，按日更新)
"""
code, result = self.client.getData(vs.REPORTBYCATEGORY%(beginDate, Category, endDate, field))
return _ret_data(code, result)
def ReportContent(self, ticker='', beginDate='', endDate='', field=''):
"""
根据证券代码获取公告内容，输入一个或多个证券交易代码，可以获取所查询证券相关的公告信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告具体内容、公告链接、公告入库时间。(注：公告数据自2000/1/8始，按日更新)
"""
code, result = self.client.getData(vs.REPORTCONTENT%(ticker, beginDate, endDate, field))
return _ret_data(code, result)
def ActiveThemesInsert(self, beginDate='', endDate='', isLatest='', themeSource='', field=''):
"""
获取一段时间内新增(开始)的活跃主题数据，输入的时间参数在主题活跃周期的起始时间列进行查询。输入查询起止时间、是否最新活跃期、主题来源，可以获取该时间段内开始活跃的主题信息，包括主题ID、主题名称、主题开始时间、主题结束时间、是否最新活跃期、数据入库及更新时间。(注：1、主题活跃周期数据自2013/1/1始；2、数据按日更新。)
"""
code, result = self.client.getData(vs.ACTIVETHEMESINSERT%(beginDate, endDate, isLatest, themeSource, field))
return _ret_data(code, result)
def ActiveThemesDelete(self, beginDate='', endDate='', isLatest='', themeSource='', field=''):
"""
获取一段时间内删除(退出)的活跃主题数据，输入的时间参数在主题活跃周期的结束时间列进行查询。输入查询起止时间、是否最新活跃期、主题来源，可以获取该时间段内停止活跃的主题信息，包括主题ID、主题名称、主题开始时间、主题结束时间、是否最新活跃期、数据入库及更新时间。(注：1、主题活跃周期数据自2013/1/1始；2、数据按日更新。3、查询当天无活跃主题被删除、需等第二天9:00之后获取前一天停止活跃的主题数据。)
"""
code, result = self.client.getData(vs.ACTIVETHEMESDELETE%(beginDate, endDate, isLatest, themeSource, field))
return _ret_data(code, result)
def ThemesCluster(self, isMain='', themeID='', themeName='', field=''):
"""
获取当天活跃主题聚类对应关系数据。输入聚类后的主要主题代码或名称，可以获取同一类别的主题相关信息，包括主题ID、主题名称、主题插入时间、主题更新时间等。(注：1、可先在主题基本信息(getThemesContent)这个API中获取当天聚类后的主题；2、可输入isMain=0，在返回的数据中剔除主题自身的对应；3、数据每天刷新，只能获取当天数据。)
"""
code, result = self.client.getData(vs.THEMESCLUSTER%(isMain, themeID, themeName, field))
return _ret_data(code, result)
def ThemesByNews(self, insertDate='', newsID='', beginTime='', endTime='', field=''):
"""
获取新闻关联的主题数据。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWS%(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesByNewsCompanyRel(self, insertDate='', newsID='', beginTime='', endTime='', field=''):
"""
获取新闻关联的主题数据，只包含与公司相关的新闻。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSCOMPANYREL%(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesInsertDB(self, beginDate='', endDate='', themeSource='', field=''):
"""
获取一段时间内新入库的主题数据。输入查询起止时间，可以获取该时间段内新入库的主题信息，包括主题ID、主题名称、主题描述、主题来源、当天是否活跃、主题插入时间、主题更新时间等。(注：1、主题基期自2011/4/16始；2、数据按日更新主题活跃状态。)
"""
code, result = self.client.getData(vs.THEMESINSERTDB%(beginDate, endDate, themeSource, field))
return _ret_data(code, result)
def ThemesByNewsLF(self, insertDate='', newsID='', beginTime='', endTime='', field=''):
"""
获取新闻关联的主题数据，该API以获取新闻关联的主题(getThemesByNews)为基础、进行过滤优化。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSLF%(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def ThemesByNewsMF(self, insertDate='', newsID='', beginTime='', endTime='', field=''):
"""
获取新闻关联的主题数据，该API以获取新闻关联的主题(优化后)(getThemesByNewsLF)为基础、再次进行过滤优化，是所有获取新闻关联的主题API中最严格的优化结果、数据量也最少。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSMF%(insertDate, newsID, beginTime, endTime, field))
return _ret_data(code, result)
def NewsInfoByInsertTime(self, newsInsertDate='', beginTime='', endTime='', field=''):
"""
获取某天某一段时间内入库的新闻基本信息。输入新闻入库的日期、起止时间，获取该时间段内新入库的新闻相关信息，如：新闻ID、标题、摘要、初始来源、作者、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSINFOBYINSERTTIME%(newsInsertDate, beginTime, endTime, field))
return _ret_data(code, result)
def NewsContentByInsertTime(self, newsInsertDate='', beginTime='', endTime='', field=''):
"""
获取某天某一段时间内入库的新闻全文等信息。输入新闻入库的日期、起止时间，获取该时间段内新入库的新闻全文等信息，如：新闻ID、标题、摘要、正文、来源链接、初始来源、作者、发布来源、发布时间、新闻入库时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新。)
"""
code, result = self.client.getData(vs.NEWSCONTENTBYINSERTTIME%(newsInsertDate, beginTime, endTime, field))
return _ret_data(code, result)
def SocialDataGuba(self, beginDate='', endDate='', ticker='', field=''):
"""
包含证券在股吧社交中的热度统计数据，输入一个或多个证券交易代码、统计起止日期，该证券在一段时间内每天相关的股吧帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALDATAGUBA%(beginDate, endDate, ticker, field))
return _ret_data(code, result)
def SocialThemeDataGuba(self, beginDate='', endDate='', themeID='', field=''):
"""
包含主题在股吧社交中的热度统计数据，输入一个或多个主题代码、统计起止日期，获取该主题在一段时间内每天相关的股吧帖子数量、帖子占比(%)。(注：数据自2014/1/1始，按日更新。)
"""
code, result = self.client.getData(vs.SOCIALTHEMEDATAGUBA%(beginDate, endDate, themeID, field))
return _ret_data(code, result)
def ThemesByNewsTime(self, publishBeginTime='', publishEndTime='', field=''):
"""
根据发布时间获取新闻关联的主题数据。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSTIME%(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeCompanyRel(self, publishBeginTime='', publishEndTime='', field=''):
"""
根据发布时间获取新闻关联的主题数据，只包含与公司相关的新闻。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSTIMECOMPANYREL%(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeLF(self, publishBeginTime='', publishEndTime='', field=''):
"""
根据发布时间获取新闻关联的主题数据，该API以获取新闻关联的主题(getThemesByNewsTime)为基础、进行过滤优化。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSTIMELF%(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ThemesByNewsTimeMF(self, publishBeginTime='', publishEndTime='', field=''):
"""
根据发布时间获取新闻关联的主题数据，该API以获取新闻关联的主题(优化后)(getThemesByNewsTimeLF)为基础、再次进行过滤优化，是所有获取新闻关联的主题API中最严格的优化结果、数据量也最少。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/04/07。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSTIMEMF%(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
def ReportContentByID(self, reportID='', field=''):
"""
根据公告ID获取公告原始内容数据，输入公告ID，获取公告原文等信息，包括公告ID、公告名称、证券交易场所、证券交易所对公告的原始分类、公告发布时间、公告具体内容、公告链接、公告入库时间。(注：公告数据自2000/1/8始，按日更新)
"""
code, result = self.client.getData(vs.REPORTCONTENTBYID%(reportID, field))
return _ret_data(code, result)
def ThemesByNews2(self, insertBeginTime='', insertEndTime='', newsID='', field=''):
"""
获取新闻关联的主题数据，原API(获取新闻关联的主题数据-getThemesByNews)的升级版。输入新闻ID或新闻与主题的关联数据入库起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/06/17)
"""
code, result = self.client.getData(vs.THEMESBYNEWS2%(insertBeginTime, insertEndTime, newsID, field))
return _ret_data(code, result)
def ThemesByNewsTime2(self, publishBeginTime='', publishEndTime='', field=''):
"""
根据发布时间获取新闻关联的主题数据，原API(根据发布时间获取新闻关联的主题数据-getThemesByNewsTime)的升级版。输入新闻发布的起止时间，可以获取相关的主题信息，如：主题ID、主题名称，同时返回新闻标题、新闻发布时间、关联数据入库时间、更新时间等。(注：1、自2014/1/1起新闻来源众多、新闻量日均4万左右，2013年及之前的网站来源少、新闻数据量少；2、数据实时更新；3、关联数据入库起始时间为2015/06/17。)
"""
code, result = self.client.getData(vs.THEMESBYNEWSTIME2%(publishBeginTime, publishEndTime, field))
return _ret_data(code, result)
class Market():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def TickRTSnapshot(self, securityID='', field=''):
"""
高频数据，获取一只或多只证券最新Level1股票信息。 输入一只或多只证券代码，
如000001.XSHG (上证指数） 或000001.XSHE（平安银行）， 还有所选字段， 得到证券的最新交易快照。
证券可以是股票，指数， 部分债券或 基金。
"""
code, result = self.client.getData(vs.TICKRTSNAPSHOT%(securityID, field))
return _ret_data(code, result)
def TickRTSnapshotIndex(self, securityID='', field=''):
"""
高频数据，获取一个指数的成分股的最新Level1股票信息。
输入一个指数的证券代码，如000001.XSHG (上证指数） 或000300.XSHG（沪深300），
还有所选字段， 得到指数成分股的最新交易快照。
"""
code, result = self.client.getData(vs.TICKRTSNAPSHOTINDEX%(securityID, field))
return _ret_data(code, result)
def FutureTickRTSnapshot(self, instrumentID='', field=''):
"""
高频数据，获取一只或多只期货的最新市场信息快照
"""
code, result = self.client.getData(vs.FUTURETICKRTSNAPSHOT%(instrumentID, field))
return _ret_data(code, result)
def TickRTIntraDay(self, securityID='', endTime='', startTime='', field=''):
"""
高频数据，获取一只证券当日内时间段的Level1信息。 证券可以是股票，指数， 部分债券或 基金。
"""
code, result = self.client.getData(vs.TICKRTINTRADAY%(securityID, endTime, startTime, field))
return _ret_data(code, result)
def BarRTIntraDay(self, securityID='', endTime='', startTime='', field=''):
"""
高频数据，获取一只证券当日的分钟线信息。
输入一只证券代码，如000001.XSHE（平安银行）， 得到此证券的当日的分钟线。
证券目前是股票，指数，基金和部分债券。分钟线的有效数据上午从09：30 到11：30，下午从13：01到15：00
"""
code, result = self.client.getData(vs.BARRTINTRADAY%(securityID, endTime, startTime, field))
return _ret_data(code, result)
def BarHistIntraDay(self, securityID='', date='', endTime='', startTime='', field=''):
"""
高频数据，获取一只证券历史的分钟线信息。
输入一只证券代码，如000001.XSHE（平安银行）， 得到此证券的当日的分钟线。
证券目前是股票，指数，基金和部分债券。分钟线的有效数据上午从09：30 到11：30，下午从13：01到15：00
"""
code, result = self.client.getData(vs.BARHISTONEDAY%(securityID, date, endTime, startTime, field))
return _ret_data(code, result)
def BarHistDayRange(self, securityID='', startDate='', endDate='', field=''):
code, result = self.client.getData(vs.BARHISTDAYRANGE%(securityID, startDate, endDate, field))
return _ret_data(code, result)
def FutureTickRTIntraDay(self, instrumentID='', endTime='', startTime='', field=''):
"""
高频数据，获取一只期货在本清算日内某时间段的行情信息
"""
code, result = self.client.getData(vs.FUTURETICKRTINTRADAY%(instrumentID, endTime, startTime, field))
return _ret_data(code, result)
def FutureBarsOneDay(self, instrumentID='', date='', field=''):
code, result = self.client.getData(vs.FUTUREBARINDAY%(instrumentID, date, field))
return _ret_data(code, result)
def FutureBarsDayRange(self, instrumentID='', startDate='', endDate='', field=''):
code, result = self.client.getData(vs.FUTUREBARDATERANGE%(instrumentID, startDate, endDate, field))
return _ret_data(code, result)
def StockFactorsOneDay(self, tradeDate='', secID='', ticker='', field=''):
"""
高频数据，获取多只股票历史上某一天的因子数据
"""
code, result = self.client.getData(vs.STOCKFACTORSONEDAY%(tradeDate, secID, ticker, field))
return _ret_data(code, result)
def StockFactorsDateRange(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
高频数据，获取一只股票历史上某一时间段的因子数据
"""
code, result = self.client.getData(vs.STOCKFACTORSDATERANGE%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def SecTips(self, tipsTypeCD='', field=''):
"""
上海证券交易所、深圳证券交易所今日停复牌股票列表。数据更新频率：日。
"""
code, result = self.client.getData(vs.SECTIPS%(tipsTypeCD, field))
return _ret_data(code, result)
def BarRTIntraDayOneMinute(self, time='', field=''):
"""
获取所有股票某一分钟的分钟线
"""
code, result = self.client.getData(vs.BARRTINTRADAYONEMINUTE%(time, field))
return _ret_data(code, result)
def EquRTRank(self, desc='', exchangeCD='', field=''):
"""
获取沪深股票涨跌幅排行
"""
code, result = self.client.getData(vs.EQURTRANK%(desc, exchangeCD, field))
return _ret_data(code, result)
def MktMFutd(self, contractMark='', contractObject='', mainCon='', tradeDate='', endDate='',
startDate='', field=''):
"""
获取四大期货交易所主力合约、上海黄金交易所黄金(T+D)、白银(T+D)以及国外主要期货连续合约行情信息。 历史追溯至2006年，每日16:00更新。
"""
code, result = self.client.getData(vs.MKTMFUTD%(contractMark, contractObject, mainCon,
tradeDate, endDate, startDate, field))
return _ret_data(code, result)
def OptionTickRTSnapshot(self, optionId='', field=''):
"""
高频数据，获取期权最新市场信息快照
"""
code, result = self.client.getData(vs.OPTIONTICKRTSNAPSHOT%(optionId, field))
return _ret_data(code, result)
def FutureBarRTIntraDay(self, instrumentID='', endTime='', startTime='', field=''):
"""
高频数据，获取当日期货分钟线
"""
code, result = self.client.getData(vs.FUTUREBARRTINTRADAY%(instrumentID, endTime, startTime, field))
return _ret_data(code, result)
def IndustryTickRTSnapshot(self, securityID='', field=''):
"""
获取行业（证监会行业标准）资金流向，内容包括小单成交金额、中单成交金额、大单成交金额、超大单成交金额、本次成交单总金额等。
"""
code, result = self.client.getData(vs.INDUSTRYTICKRTSNAPSHOT%(securityID, field))
return _ret_data(code, result)
def MktEqudLately(self, field=''):
"""
获取沪深股票个股最近一次日行情，默认日期区间是过去1年，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，每日15:30更新
"""
code, result = self.client.getData(vs.MKTEQUDLATELY%(field))
return _ret_data(code, result)
def MktEqud(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取沪深AB股日行情信息，默认日期区间是过去1年，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，每日15:30更新
"""
code, result = self.client.getData(vs.MKTEQUD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktHKEqud(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取香港交易所股票开、收、高、低，成交等日行情信息，每日17:00前更新
"""
code, result = self.client.getData(vs.MKTHKEQUD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktBondd(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取债券交易开、收、高、低，成交等日行情信息，每日16:00前更新
"""
code, result = self.client.getData(vs.MKTBONDD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktRepod(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取债券回购交易开、收、高、低，成交等日行情信息，每日16:00前更新
"""
code, result = self.client.getData(vs.MKTREPOD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFundd(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取基金买卖交易开、收、高、低，成交等日行情信息，每日16:00前更新。
"""
code, result = self.client.getData(vs.MKTFUNDD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutd(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取四大期货交易所期货合约、上海黄金交易所黄金(T+D)、白银(T+D)以及国外主要期货连续合约行情信息。 默认日期区间是过去一年。日线数据第一次更新为交易结束后（如遇线路不稳定情况数据可能存在误差），第二次更新为18:00pm，其中主力合约是以连续三个交易日持仓量最大为基准计算的。
"""
code, result = self.client.getData(vs.MKTFUTD%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMTR(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取期货会员在各交易日期货合约的成交量、成交排名及成交量增减信息，每日16:00前更新。
"""
code, result = self.client.getData(vs.MKTFUTMTR%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMSR(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取期货会员在各交易日期货合约的空头持仓、排名及空头持仓增减信息，每日16:00前更新。
"""
code, result = self.client.getData(vs.MKTFUTMSR%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMLR(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取期货会员在各交易日期货合约的多头持仓、排名及多头持仓增减信息，每日16:00前更新。
"""
code, result = self.client.getData(vs.MKTFUTMLR%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktIdxd(self, indexID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取指数日线行情信息，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，默认日期区间是过去1年，其中沪深指数行情每日15:30更新。
"""
code, result = self.client.getData(vs.MKTIDXD%(indexID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktBlockd(self, secID='', ticker='', tradeDate='', assetClass='', beginDate='', endDate='', field=''):
"""
获取沪深交易所交易日大宗交易成交价，成交量等信息。
"""
code, result = self.client.getData(vs.MKTBLOCKD%(secID, ticker, tradeDate, assetClass, beginDate, endDate, field))
return _ret_data(code, result)
def MktOptd(self, optID='', secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
主要记录上交所期权行情，包含昨结算、昨收盘、开盘价、最高价、最低价、收盘价、结算价、成交量、成交金额、持仓量等字段，每日16:00前更新。
"""
code, result = self.client.getData(vs.MKTOPTD%(optID, secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktEqudAdj(self, secID='', ticker='', tradeDate='', beginDate='', endDate='', field=''):
"""
获取获取沪深A股和B股前复权日行情信息，包含前复权昨收价、前复权开盘价、前复权最高价、前复权最低价、前复权收盘价，每日开盘前更新数据。
"""
code, result = self.client.getData(vs.MKTEQUDADJ%(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktAdjf(self, secID='', ticker='', field=''):
"""
获取获取沪深A股和B股用来调整行情的前复权因子数据，包含除权除息日、除权除息事项具体数据、本次复权因子、累积复权因子以及因子调整的截止日期。该因子用来调整历史行情，不作为预测使用，于除权除息日进行计算调整。
"""
code, result = self.client.getData(vs.MKTADJF%(secID, ticker, field))
return _ret_data(code, result)
def MktFutdVol(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取四大期货交易所期货合约行情信息。 默认日期区间是过去一年。日线数据第一次更新为交易结束后（如遇线路不稳定情况数据可能存在误差），第二次更新为18:00pm，其中主力合约是以成交量最大为基准计算的。
"""
code, result = self.client.getData(vs.MKTFUTDVOL%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktLimit(self, secID='', ticker='', tradeDate='', field=''):
"""
主要记录盘前每日个股及基金涨跌停板价格，每日9:00更新
"""
code, result = self.client.getData(vs.MKTLIMIT%(secID, ticker, tradeDate, field))
return _ret_data(code, result)
def MktFunddAdjAf(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
主要记录基金每日后复权行情，包括开高低收、成交量、成交价格等
"""
code, result = self.client.getData(vs.MKTFUNDDADJAF%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
class IV():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def DerIv(self, beginDate='', endDate='', optID='', SecID='', field=''):
"""
原始隐含波动率,包括期权价格、累计成交量、持仓量、隐含波动率等。
"""
code, result = self.client.getData(vs.DERIV%(beginDate, endDate, optID, SecID, field))
return _ret_data(code, result)
def DerIvHv(self, beginDate='', endDate='', SecID='', period='', field=''):
"""
历史波动率，各个时间段的收盘－收盘历史波动率。
"""
code, result = self.client.getData(vs.DERIVHV%(beginDate, endDate, SecID, period, field))
return _ret_data(code, result)
def DerIvIndex(self, beginDate='', endDate='', SecID='', period='', field=''):
"""
隐含波动率指数，衡量30天至1080天到期平价期权的平均波动性的主要方法。
"""
code, result = self.client.getData(vs.DERIVINDEX%(beginDate, endDate, SecID, period, field))
return _ret_data(code, result)
def DerIvIvpDelta(self, beginDate='', endDate='', SecID='', delta='', period='', field=''):
"""
隐含波动率曲面(基于参数平滑曲线)，基于delta（0.1至0.9,0.05升步）和到期日（1个月至3年）而标准化的曲面。
"""
code, result = self.client.getData(vs.DERIVIVPDELTA%(beginDate, endDate, SecID, delta, period, field))
return _ret_data(code, result)
def DerIvParam(self, beginDate='', endDate='', SecID='', expDate='', field=''):
"""
隐含波动率参数化曲面，由二阶方程波动曲线在每个到期日平滑后的曲面（a,b,c曲线系数）
"""
code, result = self.client.getData(vs.DERIVPARAM%(beginDate, endDate, SecID, expDate, field))
return _ret_data(code, result)
def DerIvRawDelta(self, beginDate='', endDate='', SecID='', delta='', period='', field=''):
"""
隐含波动率曲面(基于原始隐含波动率)，基于delta（0.1至0.9,0.05升步）和到期日（1个月至3年）而标准化的曲面。
"""
code, result = self.client.getData(vs.DERIVRAWDELTA%(beginDate, endDate, SecID, delta, period, field))
return _ret_data(code, result)
def DerIvSurface(self, beginDate='', endDate='', SecID='', contractType='', field=''):
"""
隐含波动率曲面(在值程度)，基于在值程度而标准化的曲面。执行价格区间在-60%到+60%，5%升步，到期区间为1个月至3年。
"""
code, result = self.client.getData(vs.DERIVSURFACE%(beginDate, endDate, SecID, contractType, field))
return _ret_data(code, result)
class Market():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def TickRTSnapshot(self, securityID='', field=''):
"""
高频数据，获取一只或多只证券最新Level1股票信息。 输入一只或多只证券代码，
如000001.XSHG (上证指数） 或000001.XSHE（平安银行）， 还有所选字段， 得到证券的最新交易快照。
证券可以是股票，指数， 部分债券或 基金。
"""
code, result = self.client.getData(vs.TICKRTSNAPSHOT %
(securityID, field))
return _ret_data(code, result)
def TickRTSnapshotIndex(self, securityID='', field=''):
"""
高频数据，获取一个指数的成分股的最新Level1股票信息。
输入一个指数的证券代码，如000001.XSHG (上证指数） 或000300.XSHG（沪深300），
还有所选字段， 得到指数成分股的最新交易快照。
"""
code, result = self.client.getData(vs.TICKRTSNAPSHOTINDEX %
(securityID, field))
return _ret_data(code, result)
def FutureTickRTSnapshot(self, instrumentID='', field=''):
"""
高频数据，获取一只或多只期货的最新市场信息快照
"""
code, result = self.client.getData(vs.FUTURETICKRTSNAPSHOT %
(instrumentID, field))
return _ret_data(code, result)
def TickRTIntraDay(self,
securityID='',
endTime='',
startTime='',
field=''):
"""
高频数据，获取一只证券当日内时间段的Level1信息。 证券可以是股票，指数， 部分债券或 基金。
"""
code, result = self.client.getData(
vs.TICKRTINTRADAY % (securityID, endTime, startTime, field))
return _ret_data(code, result)
def BarRTIntraDay(self, securityID='', endTime='', startTime='', field=''):
"""
高频数据，获取一只证券当日的分钟线信息。
输入一只证券代码，如000001.XSHE（平安银行）， 得到此证券的当日的分钟线。
证券目前是股票，指数，基金和部分债券。分钟线的有效数据上午从09：30 到11：30，下午从13：01到15：00
"""
code, result = self.client.getData(
vs.BARRTINTRADAY % (securityID, endTime, startTime, field))
return _ret_data(code, result)
def BarHistIntraDay(self,
securityID='',
date='',
endTime='',
startTime='',
field=''):
"""
高频数据，获取一只证券历史的分钟线信息。
输入一只证券代码，如000001.XSHE（平安银行）， 得到此证券的当日的分钟线。
证券目前是股票，指数，基金和部分债券。分钟线的有效数据上午从09：30 到11：30，下午从13：01到15：00
"""
code, result = self.client.getData(
vs.BARHISTONEDAY % (securityID, date, endTime, startTime, field))
return _ret_data(code, result)
def BarHistDayRange(self,
securityID='',
startDate='',
endDate='',
field=''):
code, result = self.client.getData(
vs.BARHISTDAYRANGE % (securityID, startDate, endDate, field))
return _ret_data(code, result)
def FutureTickRTIntraDay(self,
instrumentID='',
endTime='',
startTime='',
field=''):
"""
高频数据，获取一只期货在本清算日内某时间段的行情信息
"""
code, result = self.client.getData(
vs.FUTURETICKRTINTRADAY %
(instrumentID, endTime, startTime, field))
return _ret_data(code, result)
def FutureBarsOneDay(self, instrumentID='', date='', field=''):
code, result = self.client.getData(vs.FUTUREBARINDAY %
(instrumentID, date, field))
return _ret_data(code, result)
def FutureBarsDayRange(self,
instrumentID='',
startDate='',
endDate='',
field=''):
code, result = self.client.getData(
vs.FUTUREBARDATERANGE % (instrumentID, startDate, endDate, field))
return _ret_data(code, result)
def StockFactorsOneDay(self, tradeDate='', secID='', ticker='', field=''):
"""
高频数据，获取多只股票历史上某一天的因子数据
"""
code, result = self.client.getData(vs.STOCKFACTORSONEDAY %
(tradeDate, secID, ticker, field))
return _ret_data(code, result)
def StockFactorsDateRange(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
高频数据，获取一只股票历史上某一时间段的因子数据
"""
code, result = self.client.getData(
vs.STOCKFACTORSDATERANGE %
(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def SecTips(self, tipsTypeCD='', field=''):
"""
上海证券交易所、深圳证券交易所今日停复牌股票列表。数据更新频率：日。
"""
code, result = self.client.getData(vs.SECTIPS % (tipsTypeCD, field))
return _ret_data(code, result)
def BarRTIntraDayOneMinute(self, time='', field=''):
"""
获取所有股票某一分钟的分钟线
"""
code, result = self.client.getData(vs.BARRTINTRADAYONEMINUTE %
(time, field))
return _ret_data(code, result)
def EquRTRank(self, desc='', exchangeCD='', field=''):
"""
获取沪深股票涨跌幅排行
"""
code, result = self.client.getData(vs.EQURTRANK %
(desc, exchangeCD, field))
return _ret_data(code, result)
def MktMFutd(self,
contractMark='',
contractObject='',
mainCon='',
tradeDate='',
endDate='',
startDate='',
field=''):
"""
获取四大期货交易所主力合约、上海黄金交易所黄金(T+D)、白银(T+D)以及国外主要期货连续合约行情信息。 历史追溯至2006年，每日16:00更新。
"""
code, result = self.client.getData(
vs.MKTMFUTD % (contractMark, contractObject, mainCon, tradeDate,
endDate, startDate, field))
return _ret_data(code, result)
def OptionTickRTSnapshot(self, optionId='', field=''):
"""
高频数据，获取期权最新市场信息快照
"""
code, result = self.client.getData(vs.OPTIONTICKRTSNAPSHOT %
(optionId, field))
return _ret_data(code, result)
def FutureBarRTIntraDay(self,
instrumentID='',
endTime='',
startTime='',
field=''):
"""
高频数据，获取当日期货分钟线
"""
code, result = self.client.getData(
vs.FUTUREBARRTINTRADAY % (instrumentID, endTime, startTime, field))
return _ret_data(code, result)
def IndustryTickRTSnapshot(self, securityID='', field=''):
"""
获取行业（证监会行业标准）资金流向，内容包括小单成交金额、中单成交金额、大单成交金额、超大单成交金额、本次成交单总金额等。
"""
code, result = self.client.getData(vs.INDUSTRYTICKRTSNAPSHOT %
(securityID, field))
return _ret_data(code, result)
def MktEqudLately(self, field=''):
"""
获取沪深股票个股最近一次日行情，默认日期区间是过去1年，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，每日15:30更新
"""
code, result = self.client.getData(vs.MKTEQUDLATELY % (field))
return _ret_data(code, result)
def MktEqud(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取沪深AB股日行情信息，默认日期区间是过去1年，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，每日15:30更新
"""
code, result = self.client.getData(
vs.MKTEQUD % (secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktHKEqud(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取香港交易所股票开、收、高、低，成交等日行情信息，每日17:00前更新
"""
code, result = self.client.getData(
vs.MKTHKEQUD %
(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktBondd(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取债券交易开、收、高、低，成交等日行情信息，每日16:00前更新
"""
code, result = self.client.getData(
vs.MKTBONDD %
(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktRepod(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取债券回购交易开、收、高、低，成交等日行情信息，每日16:00前更新
"""
code, result = self.client.getData(
vs.MKTREPOD %
(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFundd(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取基金买卖交易开、收、高、低，成交等日行情信息，每日16:00前更新。
"""
code, result = self.client.getData(
vs.MKTFUNDD %
(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutd(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取四大期货交易所期货合约、上海黄金交易所黄金(T+D)、白银(T+D)以及国外主要期货连续合约行情信息。 默认日期区间是过去一年。日线数据第一次更新为交易结束后（如遇线路不稳定情况数据可能存在误差），第二次更新为18:00pm，其中主力合约是以连续三个交易日持仓量最大为基准计算的。
"""
code, result = self.client.getData(
vs.MKTFUTD % (secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMTR(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取期货会员在各交易日期货合约的成交量、成交排名及成交量增减信息，每日16:00前更新。
"""
code, result = self.client.getData(
vs.MKTFUTMTR % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMSR(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取期货会员在各交易日期货合约的空头持仓、排名及空头持仓增减信息，每日16:00前更新。
"""
code, result = self.client.getData(
vs.MKTFUTMSR % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktFutMLR(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取期货会员在各交易日期货合约的多头持仓、排名及多头持仓增减信息，每日16:00前更新。
"""
code, result = self.client.getData(
vs.MKTFUTMLR % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktIdxd(self,
indexID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取指数日线行情信息，包含昨收价、开盘价、最高价、最低价、收盘价、成交量、成交金额等字段，默认日期区间是过去1年，其中沪深指数行情每日15:30更新。
"""
code, result = self.client.getData(
vs.MKTIDXD %
(indexID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktBlockd(self,
secID='',
ticker='',
tradeDate='',
assetClass='',
beginDate='',
endDate='',
field=''):
"""
获取沪深交易所交易日大宗交易成交价，成交量等信息。
"""
code, result = self.client.getData(
vs.MKTBLOCKD %
(secID, ticker, tradeDate, assetClass, beginDate, endDate, field))
return _ret_data(code, result)
def MktOptd(self,
optID='',
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
主要记录上交所期权行情，包含昨结算、昨收盘、开盘价、最高价、最低价、收盘价、结算价、成交量、成交金额、持仓量等字段，每日16:00前更新。
"""
code, result = self.client.getData(
vs.MKTOPTD %
(optID, secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktEqudAdj(self,
secID='',
ticker='',
tradeDate='',
beginDate='',
endDate='',
field=''):
"""
获取获取沪深A股和B股前复权日行情信息，包含前复权昨收价、前复权开盘价、前复权最高价、前复权最低价、前复权收盘价，每日开盘前更新数据。
"""
code, result = self.client.getData(
vs.MKTEQUDADJ %
(secID, ticker, tradeDate, beginDate, endDate, field))
return _ret_data(code, result)
def MktAdjf(self, secID='', ticker='', field=''):
"""
获取获取沪深A股和B股用来调整行情的前复权因子数据，包含除权除息日、除权除息事项具体数据、本次复权因子、累积复权因子以及因子调整的截止日期。该因子用来调整历史行情，不作为预测使用，于除权除息日进行计算调整。
"""
code, result = self.client.getData(vs.MKTADJF % (secID, ticker, field))
return _ret_data(code, result)
def MktFutdVol(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取四大期货交易所期货合约行情信息。 默认日期区间是过去一年。日线数据第一次更新为交易结束后（如遇线路不稳定情况数据可能存在误差），第二次更新为18:00pm，其中主力合约是以成交量最大为基准计算的。
"""
code, result = self.client.getData(
vs.MKTFUTDVOL % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def MktLimit(self, secID='', ticker='', tradeDate='', field=''):
"""
主要记录盘前每日个股及基金涨跌停板价格，每日9:00更新
"""
code, result = self.client.getData(vs.MKTLIMIT %
(secID, ticker, tradeDate, field))
return _ret_data(code, result)
def MktFunddAdjAf(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
主要记录基金每日后复权行情，包括开高低收、成交量、成交价格等
"""
code, result = self.client.getData(
vs.MKTFUNDDADJAF % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
class Bond():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Bond(self, secID='', ticker='', field=''):
"""
债券的基本面信息，涵盖了债券计息方式、付息频率、起息日、到期日、兑付形式等。
"""
code, result = self.client.getData(vs.BOND % (secID, ticker, field))
return _ret_data(code, result)
def BondCf(self,
secID='',
ticker='',
beginDate='',
cashTypeCD='',
endDate='',
field=''):
"""
债券在每个计息周期付息兑付的相关数据。日期区间默认为过去一年。
"""
code, result = self.client.getData(
vs.BONDCF % (secID, ticker, beginDate, cashTypeCD, endDate, field))
return _ret_data(code, result)
def BondCoupon(self, secID='', ticker='', field=''):
"""
固定利率债券、浮动利率债券每个计息周期的票面利率，包括分段计息的具体利率。
"""
code, result = self.client.getData(vs.BONDCOUPON %
(secID, ticker, field))
return _ret_data(code, result)
def BondGuar(self, secID='', ticker='', guarModeCD='', field=''):
"""
收录债券担保信息，如担保人、担保类型、担保方式、担保期限等。
"""
code, result = self.client.getData(vs.BONDGUAR %
(secID, ticker, guarModeCD, field))
return _ret_data(code, result)
def BondIssue(self, secID='', ticker='', raiseModeCD='', field=''):
"""
债券在一级市场发行信息，记录的要素包括有发行方式、发行价格、当次发行规模等
"""
code, result = self.client.getData(vs.BONDISSUE %
(secID, ticker, raiseModeCD, field))
return _ret_data(code, result)
def BondOption(self, secID='', ticker='', field=''):
"""
记录债券在发行时约定在存续期内投资人或发行人可行使的选择权，如债券回售、债券赎回等。
"""
code, result = self.client.getData(vs.BONDOPTION %
(secID, ticker, field))
return _ret_data(code, result)
def BondRating(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
债券的长期评级、短期评级以及历史评级变动记录。
"""
code, result = self.client.getData(
vs.BONDRATING % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def GuarRating(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
各评级机构公布的债券担保人的信用评级数据及历史变动记录。
"""
code, result = self.client.getData(
vs.GUARRATING % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def IssuerRating(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
各评级机构公布的债券发行人的信用评级数据及历史变动记录。
"""
code, result = self.client.getData(
vs.ISSUERRATING % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def Repo(self, secID='', ticker='', field=''):
"""
债券回购基本面信息，涵盖了回购交易代码、回购期限、申报价格最小变动单位(RMB)、申报参与价格单位(RMB)等。
"""
code, result = self.client.getData(vs.REPO % (secID, ticker, field))
return _ret_data(code, result)
class Fund():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Fund(self, etfLof='', listStatusCd='', secID='', ticker='', category='',
operationMode='', field=''):
"""
获取基金的基本档案信息，包含基金名称、交易代码、分级情况、所属类别、保本情况、上市信息、相关机构、投资描述等信息。
收录了2005年以来的历史数据，数据更新频率为不定期。
"""
code, result = self.client.getData(vs.FUND%(etfLof, listStatusCd, secID,
ticker, category, operationMode, field))
return _ret_data(code, result)
def FundNav(self, dataDate='', secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取某只基金的历史净值数据(货币型、短期理财债券型除外),包括了单位份额净值、累计净值与复权净值。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(vs.FUNDNAV%(dataDate, secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
def FundDivm(self, dataDate='', secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取某只货币型基金或短期理财债券型基金的历史收益情况，包含了每万份收益，七日年化收益率等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(vs.FUNDDIVM%(dataDate, secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
def FundDiv(self, secID='', ticker='', adjustedType='', beginDate='', endDate='', field=''):
"""
获取基金的净值调整信息，包括基金分红和基金拆分两种调整情况。分红包含每份分红，除息日，分红在投资日；拆分包含份额折算比例，拆分日。
收录了2005年以来的历史数据，数据更新频率为不定期。
"""
code, result = self.client.getData(vs.FUNDDIV%(secID, ticker, adjustedType,
beginDate, endDate, field))
return _ret_data(code, result)
def FundAssets(self, reportDate='', secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取基金定期披露的资产配置情况，包含了资产总值、资产净值，以及资产总值中权益类、固定收益类、现金及其他四种资产的市值与占比情况。
收录了2005年以来的历史数据，数据更新频率为季度。获取方式支持：
1）输入一个或多个secID/ticker，并输入beginDate和endDate，可以查询到指定基金，一段时间的资产配置；
2）输入reportDate,不输入其他参数，可以查询到输入日期的全部基金资产配置
"""
code, result = self.client.getData(vs.FUNDASSETS%(reportDate, secID, ticker,
beginDate, endDate, field))
return _ret_data(code, result)
def FundHoldings(self, reportDate='', secID='', ticker='', beginDate='', endDate='',
secType='', field=''):
"""
获取基金定期披露的持仓明细，包含所持有的股票、债券、基金的持仓明细数据。收录了2005年以来的历史数据，数据更新频率为季度。获取方式支持：
1）输入一个或多个secID/ticker，并输入beginDate和endDate，可以查询到指定基金，一段时间的基金持仓；
2）输入reportDate,不输入其他参数，可以查询到输入日期的全部基金持仓数据。
"""
code, result = self.client.getData(vs.FUNDHOLDINGS%(reportDate, secID, ticker,
beginDate, endDate, secType, field))
return _ret_data(code, result)
def FundETFPRList(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取ETF基金交易日的申赎清单基本信息，包含标的指数名称，上一交易日的现金差额、最小申赎单位净值、
单位净值，交易日当日的预估现金差额、最小申赎单位、现金替代比例上限、是否允许申购赎回、是否公布IOPV等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近两天的数据。
"""
code, result = self.client.getData(vs.FUNDETFPRLIST%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundETFCons(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取ETF基金每个交易日的跟踪的标的指数成分券清单，包含成分券的代码、简称、股票数量、现金替代溢价比、固定替代金额等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近两天的数据。
"""
code, result = self.client.getData(vs.FUNDETFCONS%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundRating(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取上海证券基金评级信息。收录了10年以来的历史数据，数据更新频率为月。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(vs.FUNDRATING%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundSharesChg(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
获取场内基金的份额变动信息，包含基金名称、交易代码、交易市场、截止日期、流通份额等信息。收录了2005年以来的历史数据，数据更新频率为日。
"""
code, result = self.client.getData(vs.FUNDSHARESCHG%(secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundLeverageInfo(self, exchangeCDLeverage='', secID='', ticker='', field=''):
"""
获取分级基金的基本信息，包含母、子基金名称、交易代码、分拆比例、折算等信息。
"""
code, result = self.client.getData(vs.FUNDLEVERAGEINFO%(exchangeCDLeverage, secID, ticker, field))
return _ret_data(code, result)
def __init__(self, client=None):
if not client:
self.client = Client(up.get_token())
else:
self.client = client
class Fundamental():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def FdmtBS(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的合并资产负债表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的资产负债表数据；
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTBS % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSBank(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的银行业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是银行业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTBSBANK % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSSecu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的证券业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTBSSECU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSIndu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的一般工商业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTBSINDU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtBSInsu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的保险业资产负债表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的资产负债表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括期末和期初数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元。
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTBSINSU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCF(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的合并现金流量表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的现金流量表数据；
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTCF % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFBank(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的银行业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是银行业上市公司） 2、仅收集合并报表数据，包括本期和上期数据； 3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示； 4、本表中单位为人民币元；5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTCFBANK % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFSecu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的证券业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTCFSECU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFIndu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的一般工商业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTCFINDU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtCFInsu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的保险业现金流量表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的现金流量表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTCFINSU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtIS(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的合并利润表模板，收集了2007年以来沪深上市公司定期报告中各个会计期间的利润表数据；
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTIS % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISBank(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的银行业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是银行业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTISBANK % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISSecu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的证券业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是证券业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTISSECU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISIndu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的一般工商业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是一般工商业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTISINDU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISInsu(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、根据2007年新会计准则制定的保险业利润表模板，收集了2007年以来沪深上市公司定期报告中所有以此模板披露的利润表数据；（主要是保险业上市公司）
2、仅收集合并报表数据，包括本期和上期数据；
3、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
4、本表中单位为人民币元；
5、每季更新。
"""
code, result = self.client.getData(
vs.FDMTISINSU % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtEe(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
获取2007年及以后年度上市公司披露的业绩快报中的主要财务指标等其他数据，
包括本期，去年同期，及本期与期初数值同比数据。每季证券交易所披露相关公告时更新数据，
公司ipo时发布相关信息也会同时更新。每日9：00前完成证券交易所披露的数据更新，中午发布公告每日12：45前完成更新。
"""
code, result = self.client.getData(
vs.FDMTEE % (reportType, secID, ticker, beginDate, endDate,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtEf(self,
reportType='',
secID='',
ticker='',
beginDate='',
endDate='',
forecastType='',
publishDateBegin='',
publishDateEnd='',
field=''):
"""
1、获取2007年及以后年度上市公司披露的公告中的预期下一报告期收入、净利润、归属于母公司净利润、基本每股收益及其幅度变化数据。
2、上市公司对经营成果科目的预计情况数据一般为其上限与下限，上限取值为公告中披露该科目中绝对值较大值，下限取值为公告中披露该科目中绝对值较小值。
3、数值为"正"代表该公司预计盈利，数值为"负"代表该公司预计亏损。若上下限"正"、"负"符号不同，代表该公司盈利亏损情况尚不确定。
4、业绩预期类型以公告中文字披露预期类型为准，若公告中未有文字披露预期类型，则根据数据情况判断预期类型。
5、每季证券交易所披露相关公告时更新数据，公司ipo时发布相关信息也会同时更新。每日9：00前完成证券交易所披露的数据更新，中午发布公告每日12：45前完成更新。
"""
code, result = self.client.getData(
vs.FDMTEF %
(reportType, secID, ticker, beginDate, endDate, forecastType,
publishDateBegin, publishDateEnd, field))
return _ret_data(code, result)
def FdmtISLately(self, field=''):
"""
1、可获取上市公司最近一次数据，根据2007年新会计准则制定的合并利润表模板，仅收集合并报表数据；
2、如果上市公司对外财务报表进行更正，调整，均有采集并对外展示；
3、本表中单位为人民币元；
4、每季更新。
"""
code, result = self.client.getData(vs.FDMTISLATELY % (field))
return _ret_data(code, result)
class Master():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def SecID(self,
assetClass='',
cnSpell='',
partyID='',
ticker='',
field=''):
"""
通过机构partyID,或证券简称拼音cnSpell,或证券交易代码ticker，
检索证券ID（证券在数据结构中的一个唯一识别的编码），
也可通过证券简称拼音cnSpell检索证券交易代码ticker等；同时可以获取输入证券的基本上市信息，如交易市场，上市状态，交易币种，ISIN编码等。
"""
code, result = self.client.getData(
vs.SECID % (assetClass, cnSpell, partyID, ticker, field))
return _ret_data(code, result)
def TradeCal(self, exchangeCD='', beginDate='', endDate='', field=''):
"""
记录了上海证券交易所,深圳证券交易所,中国银行间市场,大连商品交易所,郑州商品交易所,上海期货交易所,
中国金融期货交易所和香港交易所等交易所在日历日期当天是否开市的信息，
其中上证、深证记录了自成立以来的全部日期是否开始信息。各交易日节假日安排通知发布当天即更新数据。
"""
code, result = self.client.getData(
vs.TRADECAL % (exchangeCD, beginDate, endDate, field))
return _ret_data(code, result)
def Industry(self,
industryVersion='',
industryVersionCD='',
industryLevel='',
isNew='',
field=''):
"""
输入行业分类通联编码(如，010303表示申万行业分类2014版)或输入一个行业分类标准名称，获取行业分类标准下行业划分
"""
code, result = self.client.getData(
vs.INDUSTRY %
(industryVersion, industryVersionCD, industryLevel, isNew, field))
return _ret_data(code, result)
def SecTypeRel(self, secID='', ticker='', typeID='', field=''):
"""
记录证券每个分类的成分，证券分类可通过在getSecType获取。
"""
code, result = self.client.getData(vs.SECTYPEREL %
(secID, ticker, typeID, field))
return _ret_data(code, result)
def EquInfo(self, ticker='', field=''):
"""
根据拼音或股票代码，匹配股票代码、名称。包含正在上市的全部沪深股票。
"""
code, result = self.client.getData(vs.EQUINFO % (ticker, field))
return _ret_data(code, result)
def SecTypeRegionRel(self, secID='', ticker='', typeID='', field=''):
"""
获取沪深股票地域分类，以注册地所在行政区域为标准。
"""
code, result = self.client.getData(vs.SECTYPEREGIONREL %
(secID, ticker, typeID, field))
return _ret_data(code, result)
def SecType(self, field=''):
"""
证券分类列表，一级分类包含有沪深股票、港股、基金、债券、期货、期权等，每个分类又细分有不同类型；可一次获取全部分类。
"""
code, result = self.client.getData(vs.SECTYPE % (field))
return _ret_data(code, result)
def SecTypeRegion(self, field=''):
"""
获取中国地域分类，以行政划分为标准。
"""
code, result = self.client.getData(vs.SECTYPEREGION % (field))
return _ret_data(code, result)
def SysCode(self, codeTypeID='', valueCD='', field=''):
"""
各api接口有枚举值特性的输出列，如getSecID输出项exchangeCD值，编码分别代表的是什么市场，所有枚举值都可以在这个接口获取。
"""
code, result = self.client.getData(vs.SYSCODE %
(codeTypeID, valueCD, field))
return _ret_data(code, result)
class Fund():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Fund(self,
etfLof='',
listStatusCd='',
secID='',
ticker='',
category='',
operationMode='',
field=''):
"""
获取基金的基本档案信息，包含基金名称、交易代码、分级情况、所属类别、保本情况、上市信息、相关机构、投资描述等信息。
收录了2005年以来的历史数据，数据更新频率为不定期。
"""
code, result = self.client.getData(
vs.FUND % (etfLof, listStatusCd, secID, ticker, category,
operationMode, field))
return _ret_data(code, result)
def FundNav(self,
dataDate='',
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取某只基金的历史净值数据(货币型、短期理财债券型除外),包括了单位份额净值、累计净值与复权净值。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(
vs.FUNDNAV % (dataDate, secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundDivm(self,
dataDate='',
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取某只货币型基金或短期理财债券型基金的历史收益情况，包含了每万份收益，七日年化收益率等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(
vs.FUNDDIVM % (dataDate, secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundDiv(self,
secID='',
ticker='',
adjustedType='',
beginDate='',
endDate='',
field=''):
"""
获取基金的净值调整信息，包括基金分红和基金拆分两种调整情况。分红包含每份分红，除息日，分红在投资日；拆分包含份额折算比例，拆分日。
收录了2005年以来的历史数据，数据更新频率为不定期。
"""
code, result = self.client.getData(
vs.FUNDDIV %
(secID, ticker, adjustedType, beginDate, endDate, field))
return _ret_data(code, result)
def FundAssets(self,
reportDate='',
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取基金定期披露的资产配置情况，包含了资产总值、资产净值，以及资产总值中权益类、固定收益类、现金及其他四种资产的市值与占比情况。
收录了2005年以来的历史数据，数据更新频率为季度。获取方式支持：
1）输入一个或多个secID/ticker，并输入beginDate和endDate，可以查询到指定基金，一段时间的资产配置；
2）输入reportDate,不输入其他参数，可以查询到输入日期的全部基金资产配置
"""
code, result = self.client.getData(
vs.FUNDASSETS %
(reportDate, secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundHoldings(self,
reportDate='',
secID='',
ticker='',
beginDate='',
endDate='',
secType='',
field=''):
"""
获取基金定期披露的持仓明细，包含所持有的股票、债券、基金的持仓明细数据。收录了2005年以来的历史数据，数据更新频率为季度。获取方式支持：
1）输入一个或多个secID/ticker，并输入beginDate和endDate，可以查询到指定基金，一段时间的基金持仓；
2）输入reportDate,不输入其他参数，可以查询到输入日期的全部基金持仓数据。
"""
code, result = self.client.getData(
vs.FUNDHOLDINGS %
(reportDate, secID, ticker, beginDate, endDate, secType, field))
return _ret_data(code, result)
def FundETFPRList(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取ETF基金交易日的申赎清单基本信息，包含标的指数名称，上一交易日的现金差额、最小申赎单位净值、
单位净值，交易日当日的预估现金差额、最小申赎单位、现金替代比例上限、是否允许申购赎回、是否公布IOPV等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近两天的数据。
"""
code, result = self.client.getData(
vs.FUNDETFPRLIST % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundETFCons(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取ETF基金每个交易日的跟踪的标的指数成分券清单，包含成分券的代码、简称、股票数量、现金替代溢价比、固定替代金额等信息。
收录了2005年以来的历史数据，数据更新频率为日。不输入日期则默认获取近两天的数据。
"""
code, result = self.client.getData(
vs.FUNDETFCONS % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundRating(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取上海证券基金评级信息。收录了10年以来的历史数据，数据更新频率为月。不输入日期则默认获取近一年以来的历史数据。
"""
code, result = self.client.getData(
vs.FUNDRATING % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundSharesChg(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取场内基金的份额变动信息，包含基金名称、交易代码、交易市场、截止日期、流通份额等信息。收录了2005年以来的历史数据，数据更新频率为日。
"""
code, result = self.client.getData(
vs.FUNDSHARESCHG % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FundLeverageInfo(self,
exchangeCDLeverage='',
secID='',
ticker='',
field=''):
"""
获取分级基金的基本信息，包含母、子基金名称、交易代码、分拆比例、折算等信息。
"""
code, result = self.client.getData(
vs.FUNDLEVERAGEINFO % (exchangeCDLeverage, secID, ticker, field))
return _ret_data(code, result)
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
class Equity():
def __init__(self, client=None):
if client is None:
self.client = Client(up.get_token())
else:
self.client = client
def Equ(self,
equTypeCD='',
secID='',
ticker='',
listStatusCD='',
field=''):
"""
获取股票的基本信息，包含股票交易代码及其简称、股票类型、上市状态、上市板块、上市日期等；上市状态为最新数据，不显示历史变动信息。
"""
code, result = self.client.getData(
vs.EQU % (equTypeCD, secID, ticker, listStatusCD, field))
return _ret_data(code, result)
def EquAllot(self,
isAllotment='',
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取股票历次配股的基本信息，包含每次配股方案的内容、方案进度、历史配股预案公布次数以及最终是否配股成功。
"""
code, result = self.client.getData(
vs.EQUALLOT %
(isAllotment, secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def EquDiv(self,
eventProcessCD='',
exDivDate='',
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取股票历次分红(派现、送股、转增股)的基本信息，包含历次分红预案的内容、实施进展情况以及历史宣告分红次数。
"""
code, result = self.client.getData(
vs.EQUDIV % (eventProcessCD, exDivDate, secID, ticker, beginDate,
endDate, field))
return _ret_data(code, result)
def EquIndustry(self,
industry='',
industryID='',
industryVersionCD='',
secID='',
ticker='',
intoDate='',
field=''):
"""
输入证券ID或股票交易代码，获取股票所属行业分类
"""
code, result = self.client.getData(
vs.EQUINDUSTRY % (industry, industryID, industryVersionCD, secID,
ticker, intoDate, field))
return _ret_data(code, result)
def EquIPO(self, eventProcessCD='', secID='', ticker='', field=''):
"""
获取股票首次公开发行上市的基本信息，包含股票首次公开发行的进程及发行结果。
"""
code, result = self.client.getData(
vs.EQUIPO % (eventProcessCD, secID, ticker, field))
return _ret_data(code, result)
def EquRef(self,
secID='',
ticker='',
beginDate='',
endDate='',
eventProcessCD='',
field=''):
"""
获取股票股权分置改革的基本信息，包含股改进程、股改实施方案以及流通股的变动情况。
"""
code, result = self.client.getData(
vs.EQUREF %
(secID, ticker, beginDate, endDate, eventProcessCD, field))
return _ret_data(code, result)
def EquRetud(self,
listStatusCD='',
secID='',
ticker='',
beginDate='',
dailyReturnNoReinvLower='',
dailyReturnNoReinvUpper='',
dailyReturnReinvLower='',
dailyReturnReinvUpper='',
endDate='',
isChgPctl='',
field=''):
"""
获取股票每日回报率的基本信息，包含交易当天的上市状态、日行情以及除权除息事项的基本数据。
"""
code, result = self.client.getData(
vs.EQURETUD %
(listStatusCD, secID, ticker, beginDate, dailyReturnNoReinvLower,
dailyReturnNoReinvUpper, dailyReturnReinvLower,
dailyReturnReinvUpper, endDate, isChgPctl, field))
return _ret_data(code, result)
def EquSplits(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取股票进行股本拆细或者缩股的基本信息。
"""
code, result = self.client.getData(
vs.EQUSPLITS % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def FstTotal(self, beginDate='', endDate='', exchangeCD='', field=''):
"""
获取上海、深圳交易所公布的每个交易日的融资融券交易汇总的信息，包括成交量、成交金额。本交易日可获取前一交易日的数据。
"""
code, result = self.client.getData(
vs.FSTTOTAL % (beginDate, endDate, exchangeCD, field))
return _ret_data(code, result)
def FstDetail(self,
secID='',
ticker='',
beginDate='',
endDate='',
field=''):
"""
获取上海、深圳交易所公布的每个交易日的融资融券交易具体的信息，包括标的证券信息、融资融券金额以及数量方面的数据。本交易日可获取前一交易日的数据。
"""
code, result = self.client.getData(
vs.FSTDETAIL % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
def EquShare(self,
secID='',
ticker='',
beginDate='',
endDate='',
partyID='',
field=''):
"""
获取上市公司股本结构及历次股本变动数据。
"""
code, result = self.client.getData(
vs.EQUSHARE % (secID, ticker, beginDate, endDate, partyID, field))
return _ret_data(code, result)
def SecST(self, secID='', ticker='', beginDate='', endDate='', field=''):
"""
通过输入股票ID（通联编制）或股票交易代码（支持多值输入，最大支持50只），选择查询开始日期与结束日期，获取股票在一段时间ST标记信息。
"""
code, result = self.client.getData(
vs.SECST % (secID, ticker, beginDate, endDate, field))
return _ret_data(code, result)
