{"repo":"Micro-sheep/efinance","free":true,"listed":false,"github":"https://github.com/Micro-sheep/efinance","clone":"git clone https://github.com/Micro-sheep/efinance.git","description":"efinance 是一个可以快速获取基金、股票、债券、期货数据的 Python 库，回测以及量化交易的好帮手！🚀🚀🚀","language":"Python","stars":3939,"topics":["bond","finance","fund","futures","quant","stock"],"license":"MIT","category":"quant_tool","readme_excerpt":"## Introduction\n\n[![Python Version](https://img.shields.io/badge/python-3.6+-blue.svg?style=flat)](https://pypi.python.org/pypi/efinance)\n[![Pypi Package](https://img.shields.io/pypi/v/efinance.svg?maxAge=60)](https://pypi.python.org/pypi/efinance)\n[![Pypi-Install](https://img.shields.io/pypi/dm/efinance.svg?maxAge=2592000&label=installs&color=%2327B1FF)](https://pypi.python.org/pypi/efinance)\n[![Docs](https://readthedocs.org/projects/efinance/badge/?version=latest)](https://efinance.readthedocs.io)\n[![CodeFactor](https://www.codefactor.io/repository/github/micro-sheep/efinance/badge)](https://www.codefactor.io/repository/github/micro-sheep/efinance/overview/main)\n[![Github Stars](https://img.shields.io/github/stars/Micro-sheep/efinance.svg?style=social&label=Star&maxAge=60)](https://github.com/Micro-sheep/efinance)\n\n[`efinance`](https://github.com/Micro-sheep/efinance) 是由个人打造的用于获取股票、基金、期货数据的免费开源 Python 库，你可以使用它很方便地获取数据以便更好地服务于个人的交易系统需求。\n\n**郑重声明：本项目仅供学习交流使用，不得用于商业用途。**\n\n> **💡 遇到限流或网络报错？** 使用过程中若遇到限流、连接超时等网络相关报错，可尝试 **[TickFlow](https://tickflow.org?utm_source=efinance&utm_medium=readme)** 作为替代数据源：  \n> [https://tickflow.org](https://tickflow.org?utm_source=efinance&utm_medium=readme)\n\n- [`Source Code`](https://github.com/Micro-sheep/efinance)\n- [`Docs`](https://efinance.readthedocs.io)\n- [`Changelog`](https://github.com/Micro-sheep/efinance/blob/main/changelog.md)\n\n---\n\n## Installation\n\n- 通过 `pip` 安装\n\n```bash\npip install efinance\n```\n\n- 通过 `pip` 更新\n\n```bash\npip install efinance --upgrade\n```\n\n- 通过 `docker` 安装\n\n```bash\n# 克隆代码\ngit clone https://github.com/Micro-sheep/efinance\n# 切换工作目录为该项目的根目录\ncd efinance\n# 构建镜像(-t 指定构建后生成的镜像名称 . 指定 build 的对象是当前工作目录下的 dockerfile)\ndocker build -t efinance . --no-cache\n# 以交互的方式运行镜像(运行之后自动删除容器,如不想删除 则可去掉 --rm)\ndocker run --rm -it efinance\n```\n\n- 源码安装（用于开发）\n\n```bash\ngit clone https://github.com/Micro-sheep/efinance\ncd efinance\npip install -e .\n```\n\n---\n\n## Examples\n\n### Stock\n\n- 获取股票历史日 K 线数据\n\n```python\n>>> import efinance as ef\n>>> # 股票代码\n>>> stock_code = '600519'\n>>> ef.stock.get_quote_history(stock_code)\n      股票名称    股票代码          日期       开盘       收盘       最高       最低       成交量           成交额    振幅   涨跌幅    涨跌额    换手率\n0     贵州茅台  600519  2001-08-27   -89.74   -89.53   -89.08   -90.07  406318.0  1.410347e+09 -1.10  0.92   0.83  56.83\n1     贵州茅台  600519  2001-08-28   -89.64   -89.27   -89.24   -89.72  129647.0  4.634630e+08 -0.54  0.29   0.26  18.13\n2     贵州茅台  600519  2001-08-29   -89.24   -89.36   -89.24   -89.42   53252.0  1.946890e+08 -0.20 -0.10  -0.09   7.45\n3     贵州茅台  600519  2001-08-30   -89.38   -89.22   -89.14   -89.44   48013.0  1.775580e+08 -0.34  0.16   0.14   6.72\n4     贵州茅台  600519  2001-08-31   -89.21   -89.24   -89.12   -89.28   23231.0  8.623100e+07 -0.18 -0.02  -0.02   3.25\n...    ...     ...         ...      ...      ...      ...      ...       ...           ...   ...   ...    ...    ...\n4756  贵州茅台  600519  2021-07-23  1937.82  1900.00  1937.82  1895.09   47585.0  9.057762e+09  2.20 -2.06 -40.01   0.38\n4757  贵州茅台  600519  2021-07-26  1879.00  1804.11  1879.00  1780.00   98619.0  1.789436e+10  5.21 -5.05 -95.89   0.79\n4758  贵州茅台  600519  2021-07-27  1803.00  1712.89  1810.00  1703.00   86577.0  1.523081e+10  5.93 -5.06 -91.22   0.69\n4759  贵州茅台  600519  2021-07-28  1703.00  1768.90  1788.20  1682.12   85369.0  1.479247e+10  6.19  3.27  56.01   0.68\n4760  贵州茅台  600519  2021-07-29  1810.01  1740.00  1823.00  1734.34   51035.0  9.067345e+09  5.01 -1.63 -28.90   0.41\n\n[4761 rows x 13 columns]\n```\n\n- 获取非 A 股的股票 K 线数据（支持输入股票名称以及代码）\n\n```python\n>>> import efinance as ef\n>>> # 股票代码\n>>> stock_code = 'AAPL'\n>>> ef.stock.get_quote_history(stock_code)\n     股票名称  股票代码          日期      开盘      收盘      最高      最低          成交量           成交额    振幅   涨跌幅   涨跌额   换手率\n0      苹果  AAPL  1984-09-07   -5.37   -5.37   -5.36   -5.37    2981600.0  0.000000e+00  0.00  0.00  0.00  0.02\n1      苹果  AAPL  1984-09-10   -5.37   -5.37   -5.36   -5.37    2346400.0  0.000000e+00 -0.19  0.00  0.00  0.01\n2      苹果  AAPL  1984-09-11   -5.36   -5.36   -5.36   -5.36    5444000.0  0.000000e+00  0.00  0.19  0.01  0.03\n3      苹果  AAPL  1984-09-12   -5.36   -5.37   -5.36   -5.37    4773600.0  0.000000e+00 -0.19 -0.19 -0.01  0.03\n4      苹果  AAPL  1984-09-13   -5.36   -5.36   -5.36   -5.36    7429600.0  0.000000e+00  0.00  0.19  0.01  0.04\n...   ...   ...         ...     ...     ...     ...     ...          ...           ...   ...   ...   ...   ...\n8739   苹果  AAPL  2021-07-22  145.94  146.80  148.19  145.81   77338156.0  1.137623e+10  1.64  0.96  1.40  0.47\n8740   苹果  AAPL  2021-07-23  147.55  148.56  148.72  146.92   71447416.0  1.058233e+10  1.23  1.20  1.76  0.43\n8741   苹果  AAPL  2021-07-26  148.27  148.99  149.83  147.70   72434089.0  1.080774e+10  1.43  0.29  0.43  0.44\n8742   苹果  AAPL  2021-07-27  149.12  146.77  149.21  145.55  104818578.0  1.540140e+10  2.46 -1.49 -2.22  0.63\n8743   苹果  AAPL  2021-07-28  144.81  144.98  146.97  142.54  118931191.0  1.723188e+10  3.02 -1.22 -1.79  0.72\n\n[8744 rows x 13 columns]\n\n>>> # 股票名称\n>>> stock_name = '微软'\n>>> ef.stock.get_quote_history(stock_name)\n       股票名称  股票代码          日期      开盘      收盘      最高      最低           成交量           成交额    振幅   涨跌幅   涨跌额    换手率\n0      微软  MSFT  1986-03-13  -20.74  -20.73  -20.73  -20.74  1.031789e+09  0.000000e+00  0.00  0.00  0.00  13.72\n1      微软  MSFT  1986-03-14  -20.73  -20.73  -20.73  -20.73  3.081600e+08  0.000000e+00  0.00  0.00  0.00   4.10\n2      微软  MSFT  1986-03-17  -20.73  -20.73  -20.73  -20.73  1.331712e+08  0.000000e+00  0.00  0.00  0.00   1.77\n3      微软  MSFT  1986-03-18  -20.73  -20.73  -20.73  -20.73  6.776640e+07  0.000000e+00  0.00  0.00  0.00   0.90\n4      微软  MSFT  1986-03-19  -20.73  -20.73  -20.73  -20.73  4.789440e+07  0.000000e+00  0.00  0.00  0.00   0.64\n...   ...   ...         ...     ...     ...     ...     ...           ...           ...   ...   ...   ...    ...\n8357   微软  MSFT  2021-07-22  283.84  286.14  286.42  283.42  2.338406e+07  6.677062e+09  1.07  1.68  4.74   0.31\n8358   微软  MSFT  2021-07-23  287.37  289.67  289.99  286.50  2.276807e+07  6.578686e+09  1.22  1.23  3.53   0.30\n8359   微软  MSFT  2021-07-26  289.00  289.05  289.69  286.64  2.317607e+07  6.685868e+09  1.05 -0.21 -0.62   0.31\n8360   微软  MSFT  2021-07-27  289.43  286.54  289.58  282.95  3.360407e+07  9.599993e+09  2.29 -0.87 -2.51   0.45\n8361   微软  MSFT  2021-07-28  288.99  286.22  290.15  283.83  3.356685e+07  9.638499e+09  2.21 -0.11 -0.32   0.45\n\n[8362 rows x 13 columns]\n```\n\n- 获取 ETF K 线数据\n\n```python\n>>> import efinance as ef\n>>> # ETF 代码（以中概互联网 ETF 为例）\n>>> etf_code = '513050'\n>>> ef.stock.get_quote_history(etf_code)\n      股票名称    股票代码          日期     开盘     收盘     最高     最低         成交量           成交额    振幅   涨跌幅    涨跌额    换手率\n0     中概互联网ETF  513050  2017-01-18  0.989  0.977  0.989  0.969    345605.0  3.381795e+07  0.00  0.00  0.000   0.26\n1     中概互联网ETF  513050  2017-01-19  0.978  0.989  0.990  0.978    257716.0  2.542553e+07  1.23  1.23  0.012   0.19\n2     中概互联网ETF  513050  2017-01-20  0.989  0.988  0.990  0.986     50980.0  5.043289e+06  0.40 -0.10 -0.001   0.04\n3     中概互联网ETF  513050  2017-01-23  0.988  0.988  0.989  0.986     13739.0  1.356129e+06  0.30  0.00  0.000   0.01\n4     中概互联网ETF  513050  2017-01-24  0.989  0.989  0.992  0.987     17937.0  1.774398e+06  0.51  0.10  0.001   0.01\n...        ...     ...         ...    ...    ...    ...    ...         ...           ...   ...   ...    ...    ...\n1097  中概互联网ETF  513050  2021-07-23  1.789  1.760  1.789  1.758   4427623.0  7.836530e+08  1.73 -1.51 -0.027   3.32\n1098  中概互联网ETF  513050  2021-07-26  1.679  1.645  1.698  1.642  13035366.0  2.182816e+09  3.18 -6.53 -0.115   9.78\n1099  中概互联网ETF  513050  2021-07-27  1.600  1.547  1.620  1.546  14269546.0  2.257610e+09  4.50 -5.96 -0.098  10.70\n1100  中概互联网ETF  513050  2021-07-28  1.545  1.552  1.578  1.506  13141023.0  2.024106e+09  4.65  0.32  0.005   9.85\n1101  中概互联网ETF  513050  2021-07-29  1.615  1.641  1.651  1.606  10658041.0  1.734404e+09  2.90  5.73  0.089   7.99\n\n[1102 rows x 13 columns]\n```\n\n- 获取单只股票 5 分钟 K 线数据\n\n```python\n>>> import efinance as ef\n>>> # 股票代码\n>>> stock_code = '600519'\n>>> # 5 分钟\n>>> frequency = 5\n>>> ef.stock.get_quote_history(stock_code, klt=frequency)\n      股票名称    股票代码                日期       开盘       收盘       最高       最低     成交量          成交额    振幅   涨跌幅    涨跌额   换手率\n0     贵州茅台  600519  2021-06-16 09:35  2172.71  2159.71  2175.71  2150.74  1885.0  411159309.0  1.15 -0.64 -14.00  0.02\n1     贵州茅台  600519  2021-06-16 09:40  2156.69  2148.71  2160.48  2143.37  1238.0  268790684.0  0.79 -0.51 -11.00  0.01\n2     贵州茅台  600519  2021-06-16 09:45  2149.79  2159.71  2160.69  2149.79   706.0  153631002.0  0.51  0.51  11.00  0.01\n3     贵州茅台  600519  2021-06-16 09:50  2159.61  2148.87  2159.71  2148.87   586.0  127346502.0  0.50 -0.50 -10.84  0.00\n4     贵州茅台  600519  2021-06-16 09:55  2148.87  2161.04  2163.71  2148.72   788.0  171491075.0  0.70  0.57  12.17  0.01\n...    ...     ...               ...      ...      ...      ...      ...     ...          ...   ...   ...    ...   ...\n1521  贵州茅台  600519  2021-07-29 13:50  1746.51  1746.09  1748.95  1746.01   738.0  128889575.0  0.17 -0.09  -1.49  0.01\n1522  贵州茅台  600519  2021-07-29 13:55  1746.08  1742.01  1746.09  1741.96   831.0  144968679.0  0.24 -0.23  -4.08  0.01\n1523  贵州茅台  600519  2021-07-29 14:00  1742.00  1739.58  1742.00  1739.58   864.0  150446840.0  0.14 -0.14  -2.43  0.01\n1524  贵州茅台  600519  2021-07-29 14:05  1741.87  1740.00  1745.00  1738.88  1083.0  188427970.0  0.35  0.02   0.42  0.01\n1525  贵州茅台  600519  2021-07-29 14:10  1740.00  1740.02  1740.10  1740.00    59.0   10315488.0  0.01  0.00   0.02  0.00\n\n[1526 rows x 13 columns]\n```\n\n- 沪深市场 A 股最新状况\n\n```python\n>>> import efinance as ef\n>>> ef.stock.get_realtime_quotes()\n        股票代码   股票名称     涨跌幅     最新价      最高      最低      今开     涨跌额    换手率    量比    动态市盈率     成交量           成交额   昨日收盘           总市值         流通市值      行情ID 市场类型\n0     688787    N海天  277.59  139.48  172.39  139.25  171.66  102.54  85.62     -    ","default_branch":"main","files":46,"tree":[".DS_Store",".env",".gitignore",".readthedocs.yaml","Dockerfile","LICENSE","README.md","changelog.md","docker-compose.yaml","docs/api.md","docs/conf.py","docs/example.md","docs/index.md","docs/install.md","docs/requirements.txt","efinance/__init__.py","efinance/api/__init__.py","efinance/bond/__init__.py","efinance/bond/config.py","efinance/bond/getter.py","efinance/common/__init__.py","efinance/common/config.py","efinance/common/getter.py","efinance/config/__init__.py","efinance/fund/__init__.py","efinance/fund/config.py","efinance/fund/getter.py","efinance/fund/utils.py","efinance/futures/__init__.py","efinance/futures/config.py","efinance/futures/getter.py","efinance/futures/utils.py","efinance/shared/__init__.py","efinance/shared/tickflow_prompt.py","efinance/stock/__init__.py","efinance/stock/config.py","efinance/stock/getter.py","efinance/stock/utils.py","efinance/utils/__init__.py","examples/bond.ipynb","examples/fund.ipynb","examples/futures.ipynb","examples/stock.ipynb","pyproject.toml","requirements.txt","tox.ini"],"storefront":"/r/Micro-sheep","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Micro-sheep/efinance/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}