大白鹅
接口文档

接口文档

1、安装库

安装cashare库

pip install cashare

更新库 (注意为两个–)

pip install --upgrade cashare

注意:you_token请联系管理员获取(首页联系我们中有管理员联系方式:qq:3254597724)

2、获取列表:

type取值:

ushkeutsxfxetf
us美国9900多支香港欧洲交易所多伦多交易所2800支外汇1500种全球etf 10000只

字段意义:

symbolnameexchangeShortNametype
代码公司名称交易所名称类型
from cashare.stock_list import stock_list
df=stock_list(type='us',token='you_token')
print(df) 

symbol  (代码)                           name(公司名称)  ... exchangeShortName(交易所名称)   type(类型)
0          A       Agilent Technologies, Inc.  ...              NYSE  stock
1         AA                Alcoa Corporation  ...              NYSE  stock
2        AAC     Ares Acquisition Corporation  ...              NYSE  stock
3     AAC-UN     Ares Acquisition Corporation  ...              NYSE  stock
4     AAC-WT  Ares Acquisition Corporation Re  ...              NYSE  stock
...      ...                              ...  ...               ...    ...
9837      ZY                    Zymergen Inc.  ...            NASDAQ  stock
9838    ZYME                   Zymeworks Inc.  ...              NYSE  stock
9839    ZYNE    Zynerba Pharmaceuticals, Inc.  ...            NASDAQ  stock
9840    ZYXI                      Zynex, Inc.  ...            NASDAQ  stock
9841     ZZZ                                   ...              NYSE  stock

2、日线(美股(30年)、港股(20年)欧洲、多伦多)注意sk_code的值需要和获取列表的返回值一致。例如:中芯国际代码0981.HK(可能会和部分券商的代码不太一致)

from cashare.day_data import daily_data
df = daily_data(sk_code="aapl", token='you_token', start_date='2022-04-02',end_date='2023-05-02')
print(df)

  stock_id        date     open  ...  change  changePercent    vwap
0       AAPL  2023-05-02  170.090  ...  -1.550       -0.91128  168.70
1       AAPL  2023-05-01  169.280  ...   0.310        0.18313  169.66
2       AAPL  2023-04-28  168.490  ...   1.190        0.70627  168.95
3       AAPL  2023-04-27  165.190  ...   3.220        1.95000  167.32
4       AAPL  2023-04-26  163.055  ...   0.705        0.43237  163.91
..       ...         ...      ...  ...     ...            ...     ...
266     AAPL  2022-04-08  171.780  ...  -1.690       -0.98382  170.52
267     AAPL  2022-04-07  171.160  ...   0.980        0.57256  171.80
268     AAPL  2022-04-06  172.360  ...  -0.530       -0.30750  171.79
269     AAPL  2022-04-05  177.500  ...  -2.440       -1.37000  175.98
270     AAPL  2022-04-04  174.570  ...   3.870        2.22000  177.49

3、历史分钟美股(20年)、实时分钟、港股,欧洲、多伦多,外汇)type取值范围(1min、5min、15min、30min、1hour、4hour);实时分钟取当天日期即可。

stock_iddateopenvolume
代码时间日期开盘成交量(手)
from cashare.minute_data import m_data
df=m_data(sk_code="aapl",token='you_token',type='30min',start_date='2023-03-02',end_date='2023-05-02')
print(df)

 stock_id                 date      open  ...      high     close   volume
0       aapl  2023-03-02 09:30:00  144.3800  ...  144.7900  144.3400  6362453
1       aapl  2023-03-02 10:00:00  144.3550  ...  144.7050  144.5500  4197339
2       aapl  2023-03-02 10:30:00  144.5600  ...  144.6600  144.4871  3094298
3       aapl  2023-03-02 11:00:00  144.4850  ...  144.7315  144.2000  2094373
4       aapl  2023-03-02 11:30:00  144.2099  ...  144.3800  144.3489  1956338
..       ...                  ...       ...  ...       ...       ...      ...
597     aapl  2023-05-02 14:00:00  168.6800  ...  168.7650  168.4700  1693717
598     aapl  2023-05-02 14:30:00  168.4700  ...  169.0500  169.0300  1732934
599     aapl  2023-05-02 15:00:00  169.0300  ...  169.2800  168.9650  2416626
600     aapl  2023-05-02 15:30:00  168.9700  ...  168.9800  168.5500  4535150
601     aapl  2023-05-02 16:00:00  168.5400  ...  168.6300  168.4000  1037803

4、美股、港股实时接口(只获取当前时间点的价格):type取值 具体的股票代码,例如aapl

ushkeutsxcpindexfx其他
全部美股全部港股全部欧洲全部多伦多全部指数全部外汇也可获取以上的当个code实时价格
from cashare.stock_now import now_data
df=now_data(type='hk',token='you_token')
print('美国全部实时',df)

        symbol  ...                time
0     0001.HK  ... 2023-09-29 08:08:20
1     0002.HK  ... 2023-09-29 08:08:20
2     0003.HK  ... 2023-09-29 08:08:20

5、美股、港股个股市值

字段意义:

symboldatemarketCap
代码日期(市值)

示例:

from cashare.mc_data import mark_c_data
df=mark_c_data(code='AAPL',token='you_token',start_date='2012-09-09',end_date='2022-09-09')
print(df)  

 symbol        date      marketCap(市值)
0      AAPL  2022-09-09  2551906097310
1      AAPL  2022-09-08  2504717644980
2      AAPL  2022-09-07  2529041589480
3      AAPL  2022-09-06  2505852762390
4      AAPL  2022-09-02  2526609195030
...     ...         ...            ...
2512   AAPL  2012-09-14   646221734894
2513   AAPL  2012-09-13   638460875858
2514   AAPL  2012-09-12   626132496074
2515   AAPL  2012-09-11   617531422620
2516   AAPL  2012-09-10   619541655247

6、个股技术指标

ma取值如下,格式为5_ema。格式不正确,无法返回,其中5代表5天。

emasmaWMADEMATEMARSIADXwasd
指数移动平均线简单移动平均线加权移动平均线双指数移动平均线三重指数移动平均线相对强弱指标平均趋向指数威廉指标标准差
from cashare.ti_data import ti_data
df=ti_data(ma='5_ema',sk_code="aapl",token=you_token,type='1min',start_date='2023-09-21',end_date='2023-09-24')
print(df)

  code                 date      open  ...     close   volume   williams
0     aapl  2023-09-19 09:30:00  177.5200  ...  177.6800   899870 -62.295082
1     aapl  2023-09-19 09:31:00  177.6800  ...  177.9289   372669 -17.480000
2     aapl  2023-09-19 09:32:00  177.9600  ...  177.9420   331971 -32.765957
3     aapl  2023-09-19 09:33:00  177.9169  ...  177.7100   327170 -57.446809
4     aapl  2023-09-19 09:34:00  177.7050  ...  178.0999   304934 -15.968085

7、所有股票拆分(港美)

datesymbolnumeratordenominator
日期代码合并后合并前
from cashare.stock_sp import sp_data
df = sp_data(token='you_token', end_date='2023-09-08', start_date='2023-02-01')
print(df)

      date             label   symbol  numerator  denominator
0    2023-02-07   February 07, 23      LCI        1.0          4.0
1    2023-02-08   February 08, 23     PCAR        3.0          2.0

8、个股股息

 from cashare.stock_sd import sd_data
 df=sd_data(code='aapl',token='you_token')
 print(df)

     code        date            label  ...  recordDate  paymentDate declarationDate
0   AAPL  2023-08-11    August 11, 23  ...  2023-08-14   2023-08-17      2023-08-03
1   AAPL  2023-05-12       May 12, 23  ...  2023-05-15   2023-05-18      2023-05-04
2   AAPL  2023-02-10  February 10, 23  ...  2022-12-28   2023-02-16      2022-12-19
3   AAPL  2022-11-04  November 04, 22  ...  2022-11-07   2022-11-10      2022-10-27
4   AAPL  2022-08-05    August 05, 22  ...  2022-08-08   2022-08-11      2022-07-28

9 经济数据

type 取值:

treasuryGDPCPI
国债国内生产总值消费者物价指数
from cashare.econ import eco
df = eco(start_date='2021-01-01', end_date='2023-03-09', type='treasury', token='you_token')
print(df)

        date  month1  month2  month3  ...  year7  year10  year20  year30
0    2021-01-04    0.09    0.09    0.09  ...   0.64    0.93    1.46    1.66
1    2021-01-05    0.08    0.09    0.09  ...   0.66    0.96    1.49    1.70
2    2021-01-06    0.09    0.09    0.09  ...   0.74    1.04    1.60    1.81
3    2021-01-07    0.09    0.09    0.09  ...   0.78    1.08    1.64    1.85
4    2021-01-08    0.08    0.08    0.08  ...   0.81    1.13    1.67    1.87


5、大A实时接口:

from cashare.stock.c_now import get_c_now
df=get_c_now(sk_code='all',token=you_token)
print('大A全部实时数据',df)

大A全部实时数据       Symbol StockName     Latest  ...  TurnoverRate  PERatioDynamic  PBRatio
0     000001      平安银行  11.200000  ...          0.27        4.280000     0.57
1     000002     万  科A  13.080000  ...          0.31        7.910000     0.64
2     000003     PT金田A   0.000000  ...          0.00        0.000000     0.00