gt_fundamentals() 函數(shù)

該函數(shù)可查詢一只股票或多只股票的財(cái)務(wù)數(shù)據(jù)，其語(yǔ)法如下：

get_fundamentals(query_object, date=None, statDate=None)

參數(shù)解析：

• query_object : 這是一個(gè) sqlalchemy.orm.query.Query 對(duì)象，可以通過(guò)全局的 query 函數(shù)獲取 Query 對(duì)象

• date : 表示查詢?nèi)掌?，可以是一個(gè)字符串或者datetime.date/datetime.datetime對(duì)象。可以是None，使用默認(rèn)日期，這個(gè)默認(rèn)日期在回測(cè)和研究模塊上有點(diǎn)差別：

  • 回測(cè)模塊：默認(rèn)值會(huì)隨著回測(cè)日期變化而變化，等于 context.current_dt 的前一天（實(shí)際生活中我們只能看到前一天的財(cái)報(bào)和市值數(shù)據(jù)，所以要用前一天）
  • 研究模塊：使用平臺(tái)財(cái)務(wù)數(shù)據(jù)的最新日期，一般是昨天

  需要注意的是，如果傳入的date不是交易日，則使用這個(gè)日期之前的最近的一個(gè)交易日

• statDate : 是一個(gè)字符串，表示財(cái)報(bào)統(tǒng)計(jì)的季度或者年份，有兩種格式，具體如下：

  • 季度：格式是年+“q”+季度序號(hào)，例如：“2018q1”，“2017q4“
  • 年份：格式就是年份的數(shù)字，如”2017“，”2018“

  date 和 statDate 參數(shù)只能傳入一個(gè)。傳入date時(shí)，查詢指定日期 date 收盤后所能看到最近的數(shù)據(jù)；傳入 statDate 時(shí)，查詢 statDate 指定的季度或者年份的財(cái)務(wù)數(shù)據(jù)。當(dāng)兩個(gè)參數(shù)都沒(méi)有傳入成功時(shí)，相當(dāng)于使用 date 參數(shù)，即使用默認(rèn)日期

  為了防止返回?cái)?shù)據(jù)量過(guò)大，每次最多返回10000行。另外，當(dāng)相關(guān)股票上市前、退市后，財(cái)務(wù)數(shù)據(jù)返回各字段為空

實(shí)例代碼：

import pandas as pd

# query表示查詢
# filter表示條件篩選
# valuation是內(nèi)置市值數(shù)據(jù)對(duì)象(這里表示查詢valuation下所有的屬性)
# 最終返回一個(gè)Query對(duì)象
myq = query(valuation).filter(valuation.code=='000001.XSHE')
df = get_fundamentals(myq,'2018-4-12')
df

valuation市值數(shù)據(jù)對(duì)象中的字段有：

• id: 每行數(shù)據(jù)的索引，不重復(fù)
• code: 股票代碼
• pr_ratio: 是股票的市盈率（PE,TTM），即動(dòng)態(tài)市盈率。
• turnover_ratio: 是股票的換手率。
• pb_ratio: 是股票的市 凈率（PB）
• ps_ratio: 是股票的市現(xiàn)率
• capitalization: 是股票的總股本（萬(wàn)股）
• market_cap: 是股票的流通股本（萬(wàn)股）
• circulating_market_cap: 是股票的流通市值（億元）
• day: 是指查詢股票賬務(wù)數(shù)據(jù)的具體日期
• pe_ratio_lyr: 是股票的市盈率（PE）。以上一年度每股盈利計(jì)算的靜態(tài)市盈率

示例：輸出指定字段

import pandas as pd

# query表示查詢
# filter表示條件篩選
# valuation是內(nèi)置市值數(shù)據(jù)對(duì)象(這里表示查詢valuation下所有的屬性)
# 最終返回一個(gè)Query對(duì)象
myq = query(valuation).filter(valuation.code=='000001.XSHE')
df = get_fundamentals(myq,'2018-4-12')

print("當(dāng)日動(dòng)態(tài)市盈率是：", df['pe_ratio'])
print('當(dāng)日換手率是：', df['turnover_ratio'])
print('當(dāng)日市銷率是：', df['ps_ratio'])

當(dāng)日動(dòng)態(tài)市盈率是： 0    8.53
Name: pe_ratio, dtype: float64
當(dāng)日換手率是： 0    0.6934
Name: turnover_ratio, dtype: float64
當(dāng)日市銷率是： 0    1.8698
Name: ps_ratio, dtype: float64

示例：顯示多只股票的財(cái)務(wù)數(shù)據(jù)

import pandas as pd

# query表示查詢
# filter表示條件篩選
# valuation是內(nèi)置市值數(shù)據(jù)對(duì)象(  這里表示查詢valuation下所有的屬性)
# 最終返回一個(gè)Query對(duì)象
myq = query(valuation).filter(valuation.code.in_(['000001.XSHE', '600000.XSHG', '000009.XSHE']))
df = get_fundamentals(myq,'2018-4-12')
df

示例：更多不同的財(cái)務(wù)數(shù)據(jù)條件篩選

import pandas as pd

df = get_fundamentals(query(
    valuation
    ).filter(
        valuation.market_cap > 1000,  # 篩選市值大于1000的
        valuation.pe_ratio < 10,  # 篩選市盈率小于10的
        ).order_by(
            valuation.market_cap.desc()  # 按照市值倒序排列
            ).limit(
                5  # 最多只顯示5條數(shù)據(jù)
                ), date='2018-4-12')
df

示例：顯示某股票2016年第四季度的季報(bào)，并放到列表中顯示

# query這里指定了要查詢顯示的字段
q = query(
    # income為利潤(rùn)數(shù)據(jù)對(duì)象
    income.statDate, # 統(tǒng)計(jì)日期
    income.code,  # 股票代碼
    income.basic_eps,  # 基本每股收益
    # balance為負(fù)債數(shù)據(jù)對(duì)象
    balance.cash_equivalents,  # 貨幣資金
    # cash_flow為現(xiàn)金流數(shù)據(jù)對(duì)象
    cash_flow.goods_sale_and_service_render_cash  # 銷售商品、提供勞務(wù)獲得的現(xiàn)金
    ).filter(
        income.code == '000001.XSHE'
        )

rets = [get_fundamentals(q, statDate='2016q'+str(i)) for i in range(1, 5)]
rets

[     statDate         code  basic_eps  cash_equivalents  \
 0  2016-03-31  000001.XSHE       0.43      2.961440e+11   
 
    goods_sale_and_service_render_cash  
 0                                 NaN  ,
      statDate         code  basic_eps  cash_equivalents  \
 0  2016-06-30  000001.XSHE       0.29      2.781780e+11   
 
    goods_sale_and_service_render_cash  
 0                                 NaN  ,
      statDate         code  basic_eps  cash_equivalents  \
 0  2016-09-30  000001.XSHE       0.37      3.039360e+11   
 
    goods_sale_and_service_render_cash  
 0                                 NaN  ,
      statDate         code  basic_eps  cash_equivalents  \
 0  2016-12-31  000001.XSHE       0.23      3.112580e+11   
 
    goods_sale_and_service_render_cash  
 0                                 NaN  ]

各財(cái)務(wù)數(shù)據(jù)的意義：

• statDate: 財(cái)報(bào)統(tǒng)計(jì)的季度的最后一天，例如 2016-03-31
• code: 股票代碼
• basic_eps: 基本每股收益
• cash_equivalents: 貨幣資金
• good_sale_ane_service_render_cash: 銷售商品、提供勞務(wù)收到的現(xiàn)金

get_fundamentals_continuously() 函數(shù)

get_fundamentals()函數(shù)只能查詢某一交易日的股票財(cái)務(wù)數(shù)信息，如果要查詢多個(gè)交易日的股票財(cái)務(wù)數(shù)據(jù)信息，就要使用本函數(shù)；其語(yǔ)法如下：

get_fundamentls_continuously(query_object, end_date=None, count=None)

參數(shù)意義：

• query_object : 這是一個(gè) sqlalchemy.orm.query.Query 對(duì)象，可以通過(guò)全局的 query 函數(shù)獲取 Query 對(duì)象
• end_date: 查詢?nèi)掌?/li>
• count: 獲取end_date之前 count 個(gè)日期的數(shù)據(jù)

本函數(shù)返回值是一個(gè)pandas.Panel

出于性能考慮，返回總條數(shù)不超過(guò)10000條的限制

示例：查詢平安銀行和浦發(fā)銀行的財(cái)務(wù)信息

import pandas as pd

q = query(
    valuation
).filter(
    valuation.code.in_(
        ['000001.XSHE', '600000.XSHG']))
panel = get_fundamentals_continuously(q, end_date='2018-01-01', count=5)
panel.minor_xs('600000.XSHG')

get_index_stocks() 函數(shù)

該函數(shù)可以獲取一個(gè)指數(shù)給定日期的平臺(tái)可交易的成分股列表；其語(yǔ)法如下：

get_index_stocks(index_symbol, date=None)

參數(shù)解析：

• date: 是一個(gè)時(shí)間字符串或者一個(gè)時(shí)間對(duì)象。None會(huì)采用默認(rèn)值。如果是默認(rèn)值，在回測(cè)模塊中，會(huì)動(dòng)態(tài)采用回測(cè)日期，相當(dāng)于context.current_dt；如果是在研究模塊中，默認(rèn)時(shí)間會(huì)采用當(dāng)前時(shí)間
• index_symbol: 是指指數(shù)代碼；代碼可以在看盤軟件上查詢或者在相關(guān)行情網(wǎng)站查詢，例如：000001.XSHG 上證指數(shù)、 000002.XSHG A股指數(shù)、 000003.XSHG B股指數(shù)

代碼實(shí)例：獲得滬深300指數(shù)的所有股票代碼

stocks = get_index_stocks('000300.XSHG')
stocks

['000001.XSHE',
 '000002.XSHE',
 '000060.XSHE',
 '000063.XSHE',
 ......,
 '603833.XSHG',
 '603858.XSHG',
 '603993.XSHG']

get_industry_stocks()函數(shù)

該函數(shù)可以獲取在給定日期一個(gè)行業(yè)的所有股票代碼；其語(yǔ)法如下：

get_industry_stocks(industry_code, date=None)

參數(shù)解析：

• date: 同上
• industry_code: 行業(yè)代碼；例如：A01 農(nóng)業(yè)、A02 林業(yè)、 C27 醫(yī)藥制造業(yè)

代碼示例：獲得汽車制造業(yè)指數(shù)的所有股票代碼

stocks = get_industry_stocks('C36')
stocks

['000030.XSHE',
 '000338.XSHE',
 '000549.XSHE',
 '000550.XSHE',
......,
'603809.XSHG',
 '603922.XSHG',
 '603926.XSHG',
 '603997.XSHG']

get_concept_stocks() 函數(shù)

該函數(shù)可以獲取在給定日期一個(gè)概念板塊的所有股票；其語(yǔ)法如下：

get_concept_stocks(conpect_code, date=None)

參數(shù)解析：

• date: 同上
• conpect_code: 概念板塊代碼；例如：GN028 智能電網(wǎng)、 GN030 物聯(lián)網(wǎng)

代碼示例：獲得一帶一中概念板塊的所有股票代碼：

stocks = get_concept_stocks('GN181')
stocks

['000018.XSHE',
 '000022.XSHE',
 '000063.XSHE',
 '000065.XSHE',
 ......,
  '601857.XSHG',
 '601872.XSHG',
 '601880.XSHG',
 '601919.XSHG',
 '601989.XSHG',
 '603169.XSHG']

get_all_secruities()函數(shù)

本函數(shù)可以獲取平臺(tái)支持的所有股票、基金、指數(shù)、期貨信息；其語(yǔ)法如下：

get_all_securities(types=[], date=None)

參數(shù)解析：

• types: 表示列表類型，用來(lái)過(guò)濾 securities 的類型，列表元素及意義如下：

  • stock:　表示股票類型，即顯示所有股票信息
  • fund: 表示基金類型，即顯示所有基金信息
  • index: 表示指數(shù)類型，即顯示所有指數(shù)信息
  • futures: 表示期貨類型，即顯示所有期貨合約信息
  • eft: 表示 ETF基金，即顯示所有 ETF 基金信息
  • lof: 表示 lof 基金，即顯示所有 lof 基金信息
  • fja: 表示分級(jí)A，即顯示所有分級(jí)基金A的信息
  • fjb: 表示分級(jí)B，即顯示所有分級(jí)基金B(yǎng)的信息
  • open_fund: 表示開(kāi)放式基金，即顯示所有開(kāi)放式基金的信息
  • bond_fund: 表示股票型基金，即顯示所有股票型基金的信息
  • QDII_fund: 表示 QDII 基金，即顯示所有 QDII 基金的信息
  • money_market_fund: 表示貨幣基金，即顯示所有貨幣基金的信息
  • mixture_fund: 表示混合型基金，即顯示所有混合型基金的信息

  需要注意的是，types為空時(shí)返回所有股票信息，不包括基金、指數(shù)和期貨信息

• date:是一個(gè)時(shí)間字符串或一個(gè)時(shí)間對(duì)象，用于獲取某日期還在上市的股票信息，默認(rèn)值是None，表示獲取所有日期的股票信息

本函數(shù)返回的類型是 pandas.DataFrame 類型

代碼實(shí)例：獲取所有的股票信息

# 下面兩行代碼顯示的結(jié)果是一樣的
df = get_all_securities(['stock'])
stocks = get_all_securities()
stocks

3551 rows × 5 columns

列名字段解析：

• display_name : 上市公司的股票的名稱
• name: 上市公司股票名稱的縮寫簡(jiǎn)稱
• start_date: 上市公司的上市日期
• end_date: 上市公司的退市日期
• type: 類型

代碼示例：顯示所有分級(jí)A與分級(jí)B的信息

df = get_all_securities(['stock'])
stocks = get_all_securities()
stocks

254 rows × 5 columns

示例代碼：顯示2017-10-10日還在上市的eft和lof基金信息

df = get_all_securities(['etf', 'lof'], '2017-10-10')
df

396 rows × 5 columns

get_security_info()函數(shù)

本函數(shù)可以獲取一只股票（基金或指數(shù)）的信息，其語(yǔ)法如下：

get_security_info(code)

參數(shù)解析：

• code: 是指證券代碼。返回值是 pandas.DataFrame 類型，返回值的屬性與 get_all_securities() 函數(shù)基本上是一樣的；但返回值中多一個(gè)parent屬性，是指分級(jí)基金的線基金的代碼

代碼示例：

print('代碼502050的證券名：', get_security_info('502050.XSHG').display_name)
print('代碼502050的證券縮寫簡(jiǎn)稱：', get_security_info('502050.XSHG').name)
print('代碼502050的證券上市日期：', get_security_info('502050.XSHG').start_date)
print('代碼502050的證券退市日期：', get_security_info('502050.XSHG').end_date)
print('代碼502050的證券類型：', get_security_info('502050.XSHG').type)
print('代碼502050的證券分級(jí)基金的母基金：', get_security_info('502050.XSHG').parent)

代碼502050的證券名： 上證50B
代碼502050的證券縮寫簡(jiǎn)稱： SZ50B
代碼502050的證券上市日期： 2015-04-27
代碼502050的證券退市日期： 2200-01-01
代碼502050的證券類型： fjb
代碼502050的證券分級(jí)基金的母基金： 502048.XSHG

get_billboard_list()函數(shù)

本函數(shù)可以獲取指定日期區(qū)間內(nèi)的龍虎榜數(shù)據(jù)，語(yǔ)法如下：

get_billboard_list(stock_list, start_date, end_date, count)

參數(shù)解析：

• stock_list: 一個(gè)股票代碼的list，當(dāng)值為None時(shí)，返回指定日期的所有股票
• start_date: 開(kāi)始日期
• end_date: 結(jié)束日期
• count: 交易日數(shù)量，可以與end_date同時(shí)使用，表示獲取 end_date 前 count 個(gè)交易日的數(shù)據(jù)

返回類型： pandas.DataFrame

代碼示例：

df = get_billboard_list(stock_list=None, end_date='2018-04-09', count=1)
df

869 rows × 14 columns

各字段含義如下：

• code: 股票代碼
• day: 日期
• direction: All 表示 ”匯總“，Sell表示”賣“，Buy表示”買“
• abnormal_code: 異常波動(dòng)類型
• abnormal_name: 異常波動(dòng)名稱
• sales_depart_name: 營(yíng)業(yè)部名稱
• rank: 0表示匯總， 1~5表示買一到買五，6~10表示賣一到賣五
• buy_value: 買入金額
• buy_rate: 買入金額占比（買入金額/市場(chǎng)總成交額度）
• sell_value: 賣出金額
• sell_rate: 賣出金額占比（賣出金額/市場(chǎng)總成交額）
• net_value: 凈額（買入金額-賣出金額）
• amount: 市場(chǎng)總成交額

get_locked_shares()函數(shù)

本函數(shù)可以獲取指定日期區(qū)間內(nèi)的限售解禁數(shù)據(jù)，其語(yǔ)法如下：

get_locked_shares(stock_list, start_date, end_date, forward_count)

參數(shù)解析：各項(xiàng)參數(shù)與get_billbord_list差不多

這里只說(shuō)一下返回信息中字段的意義

• day: 解禁日期
• code: 股票代碼
• num: 解禁股數(shù)
• rate1: 解禁股數(shù)/總股本
• rate2: 解禁股數(shù)/總流通股本

代碼示例：

df = get_locked_shares(stock_list=['000001.XSHE','000002.XSHG','000009.XSHE'], start_date='2016-4-16',forward_count=1200)
df

注：本文章為個(gè)人學(xué)習(xí)筆記，參考了一些書籍與官方教程，不作任何商業(yè)用途！