efinance

Warnings

• breaking The library relies on web scraping data from Eastmoney. Changes to Eastmoney's website structure or APIs may cause `efinance` functions to break or return incorrect data without warning.
  Fix: Regularly update the library to the latest version. Monitor GitHub issues and releases for updates regarding data source changes. Consider implementing fallback mechanisms or data validation in your application.
• gotcha The library explicitly states it is 'only for learning and exchange, and must not be used for commercial purposes' (本项目仅供学习交流使用，不得用于商业用途。). Using it for commercial applications may violate their terms or expose you to legal risks.
  Fix: Adhere strictly to the stated non-commercial use policy. For commercial projects, seek alternative, commercially licensed data providers.
• gotcha Users may encounter rate limiting or network errors (限流或网络报错) when fetching large amounts of data or making frequent requests, as data is scraped from public sources.
  Fix: Implement delays between requests, use caching, or consider alternative data sources suggested by the library (e.g., TickFlow as mentioned in documentation) if persistent issues occur. Check your network connection.
• gotcha Scraped data may not be perfectly real-time or entirely accurate. It's unsuitable for high-frequency trading or applications requiring guaranteed data integrity.
  Fix: Use the library for educational, research, or personal analysis where minor data delays or discrepancies are acceptable. For critical financial applications, use dedicated, reliable, and often paid, financial APIs with strong service level agreements.

Install

• pip install efinance Install with pip

Imports

• efinance

  import efinance as ef

• ef.stock

  import efinance as ef
  data = ef.stock.get_quote_history('600519')

• ef.fund

  import efinance as ef
  info = ef.fund.get_base_info(['161725', '005827'])

Quickstart

Fetches historical daily K-line data for a specified stock and retrieves basic information for a list of funds, demonstrating common usage patterns.

import efinance as ef

# Get historical daily K-line data for a stock (e.g., '600519' for Kweichow Moutai)
stock_code = '600519'
history_data = ef.stock.get_quote_history(stock_code)
print(f"Historical data for {stock_code}:\n{history_data.head()}")

# Get basic information for multiple funds (e.g., '161725', '005827')
fund_codes = ['161725', '005827']
fund_info = ef.fund.get_base_info(fund_codes)
print(f"Basic info for funds {fund_codes}:\n{fund_info.head()}")