openbb-akshare 0.3.1__tar.gz

openbb_akshare-0.3.1/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.3
+Name: openbb-akshare
+Version: 0.3.1
+Summary: AKShare extension for OpenBB
+License: AGPL-3.0-only
+Author: Roger Ye
+Author-email: shugaoye@yahoo.com
+Requires-Python: >=3.9,<3.13
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: akshare (==1.16.98)
+Requires-Dist: openbb-core (>=1.4.7,<2.0.0)
+Description-Content-Type: text/markdown
+
+# How to Use AKShare as a Data Source for OpenBB
+
+**OpenBB**, as an open-source financial data platform, is dedicated to providing free and transparent financial data interfaces for investors, analysts, and developers. For a detailed introduction to OpenBB and its usage, please refer to [Introduction to OpenBB and How to Use It to Aid Financial Data Analysis of China A-share and Hong Kong Stocks]().
+
+Although OpenBB supports multi-source data interfaces, the acquisition of financial data in China (including Hong Kong) mainly relies on Yahoo Finance. As a free basic data source, it can meet basic needs, but its coverage depth for the Chinese and Hong Kong markets is still insufficient. More importantly, mainland Chinese users need to use a VPN to access this service, creating significant usage barriers.
+
+To enhance service capabilities in Greater China, OpenBB urgently needs to improve the implementation of localized financial data sources. The mainstream paid solutions include Wind, Eastmoney Choice, and 同花顺 iFind (mainly for institutional clients), while the free solutions focus on the open-source tool AKShare as the core solution. By integrating data interfaces from platforms such as Eastmoney, 同花顺, Tencent, Sina, and 雪球, AKShare has become one of the most comprehensive, up-to-date, and developer-friendly financial data aggregation libraries in the domestic Python ecosystem.
+
+The `openbb_akshare` project, as a data source extension for OpenBB, enables seamless integration of AKShare data into the OpenBB platform. Below is a detailed usage guide:
+
+## 💻 Environment Setup and Installation Process
+
+As developers, we primarily interact with the platform through the OpenBB Platform CLI. To integrate the AKShare data source, follow these steps to configure the development environment:
+
+1. **Create a Python Virtual Environment**
+
+   You can use `venv`, `uv`, or `poetry` to create a virtual environment. Here, we use venv (built into Python):
+
+   ```bash
+   # Create a virtual environment  
+   python3 -m venv .venv  
+   
+   # Activate the virtual environment (Linux/Mac)  
+   source .venv/bin/activate  
+   
+   # For Windows  
+   .venv\Scripts\activate  
+   ```
+
+2. **Install OpenBB Platform CLI**
+
+   Install the core OpenBB CLI via pip. Users in mainland China can configure a mirror for faster installation:
+
+   ```bash
+   # (Optional) Set a domestic mirror for pip  
+   # For Linux/Mac  
+   export PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple 
+   
+   # Install OpenBB CLI
+   pip install openbb-cli
+   ```
+
+3. **Install openbb_akshare**
+
+   Next, install the `openbb_akshare` extenstion to use the AKShare data source:
+
+   ```bash
+   # Install the AKShare data source extension  
+   pip install openbb_akshare  
+   
+   # Rebuild OpenBB resources to activate the plugin  
+   python -c "import openbb; openbb.build()"  
+   ```
+
+## 🚀 Using the AKShare Data Source
+
+### Case 1: Query A-Share Company News (Vanke as an Example)
+
+**Jupyter Notebook**：
+
+```Python
+from openbb import obb
+messages = obb.news.company("000002", provider="akshare")
+for result in messages.results:
+    print(f"{result.title}")
+```
+
+Output：
+
+```plaintext
+开源证券发布万科A研报，公司信息更新报告：销售均价有所提升，股东持续借款提供支持
+万科A出售2086万股库存股，金额1.36亿元
+万科A：已完成所有A股库存股出售 所得资金4.79亿元
+...
+```
+
+**Using OpenBB CLI**：
+
+```bash
+openbb
+2025 Jun 26, 03:11 (🦋) /news/ $ company --symbol 000002 --provider akshare
+```
+
+After entering the command, the results will be displayed in a WebView, as shown below：
+
+![openbb04](images/openbb04.png)
+
+### Case 2: Obtain Historical Stock Prices of Hong Kong Stocks (Hong Kong Telecom as an Example)
+
+**Using OpenBB CLI**:
+
+```
+2025 Jun 26, 03:28 (🦋) /equity/price/ $ historical --symbol 06823 --provider akshare
+```
+
+Results in WebView：![openbb05](images/openbb05.png)
+
+**Jupyter Notebook**：
+
+```Python
+from openbb import obb
+prices = obb.equity.price.historical(symbol='06823', start_date="2025-06-01", end_date="2025-06-10", provider="akshare")
+prices.results[0].date, prices.results[0].open, prices.results[0].close, prices.results[0].high, prices.results[0].low, prices.results[0].volume
+```
+
+Output：
+
+```
+(datetime.date(2025, 6, 2), 11.28, 11.3, 11.3, 11.14, 10308375)
+```
+
+## 🌟 openbb_akshare Project Ecosystem
+
+The `openbb_akshare` project is currently in an active development phase, and contributions from the open-source community are welcome:
+
+### Code Repositories
+
+- **GitHub**: https://github.com/finanalyzer/openbb_akshare
+
+- **GitCode (Domestic Mirror)**: https://gitcode.com/finanalyzer/openbb_akshare
+
+### Ways to Contribute
+
+1. Submit Issues to report data needs or bugs.
+
+2. Contribute PRs to optimize data source interfaces.
+
+3. Improve documentation to help more users.
+
+Through the integration of AKShare and OpenBB, users in China can more conveniently access real-time and historical data for markets such as A-Shares and Hong Kong Stocks, providing strong data support for quantitative analysis and investment research.

openbb_akshare-0.3.1/README.md

@@ -0,0 +1,130 @@
+# How to Use AKShare as a Data Source for OpenBB
+
+**OpenBB**, as an open-source financial data platform, is dedicated to providing free and transparent financial data interfaces for investors, analysts, and developers. For a detailed introduction to OpenBB and its usage, please refer to [Introduction to OpenBB and How to Use It to Aid Financial Data Analysis of China A-share and Hong Kong Stocks]().
+
+Although OpenBB supports multi-source data interfaces, the acquisition of financial data in China (including Hong Kong) mainly relies on Yahoo Finance. As a free basic data source, it can meet basic needs, but its coverage depth for the Chinese and Hong Kong markets is still insufficient. More importantly, mainland Chinese users need to use a VPN to access this service, creating significant usage barriers.
+
+To enhance service capabilities in Greater China, OpenBB urgently needs to improve the implementation of localized financial data sources. The mainstream paid solutions include Wind, Eastmoney Choice, and 同花顺 iFind (mainly for institutional clients), while the free solutions focus on the open-source tool AKShare as the core solution. By integrating data interfaces from platforms such as Eastmoney, 同花顺, Tencent, Sina, and 雪球, AKShare has become one of the most comprehensive, up-to-date, and developer-friendly financial data aggregation libraries in the domestic Python ecosystem.
+
+The `openbb_akshare` project, as a data source extension for OpenBB, enables seamless integration of AKShare data into the OpenBB platform. Below is a detailed usage guide:
+
+## 💻 Environment Setup and Installation Process
+
+As developers, we primarily interact with the platform through the OpenBB Platform CLI. To integrate the AKShare data source, follow these steps to configure the development environment:
+
+1. **Create a Python Virtual Environment**
+
+   You can use `venv`, `uv`, or `poetry` to create a virtual environment. Here, we use venv (built into Python):
+
+   ```bash
+   # Create a virtual environment  
+   python3 -m venv .venv  
+   
+   # Activate the virtual environment (Linux/Mac)  
+   source .venv/bin/activate  
+   
+   # For Windows  
+   .venv\Scripts\activate  
+   ```
+
+2. **Install OpenBB Platform CLI**
+
+   Install the core OpenBB CLI via pip. Users in mainland China can configure a mirror for faster installation:
+
+   ```bash
+   # (Optional) Set a domestic mirror for pip  
+   # For Linux/Mac  
+   export PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple 
+   
+   # Install OpenBB CLI
+   pip install openbb-cli
+   ```
+
+3. **Install openbb_akshare**
+
+   Next, install the `openbb_akshare` extenstion to use the AKShare data source:
+
+   ```bash
+   # Install the AKShare data source extension  
+   pip install openbb_akshare  
+   
+   # Rebuild OpenBB resources to activate the plugin  
+   python -c "import openbb; openbb.build()"  
+   ```
+
+## 🚀 Using the AKShare Data Source
+
+### Case 1: Query A-Share Company News (Vanke as an Example)
+
+**Jupyter Notebook**：
+
+```Python
+from openbb import obb
+messages = obb.news.company("000002", provider="akshare")
+for result in messages.results:
+    print(f"{result.title}")
+```
+
+Output：
+
+```plaintext
+开源证券发布万科A研报，公司信息更新报告：销售均价有所提升，股东持续借款提供支持
+万科A出售2086万股库存股，金额1.36亿元
+万科A：已完成所有A股库存股出售 所得资金4.79亿元
+...
+```
+
+**Using OpenBB CLI**：
+
+```bash
+openbb
+2025 Jun 26, 03:11 (🦋) /news/ $ company --symbol 000002 --provider akshare
+```
+
+After entering the command, the results will be displayed in a WebView, as shown below：
+
+![openbb04](images/openbb04.png)
+
+### Case 2: Obtain Historical Stock Prices of Hong Kong Stocks (Hong Kong Telecom as an Example)
+
+**Using OpenBB CLI**:
+
+```
+2025 Jun 26, 03:28 (🦋) /equity/price/ $ historical --symbol 06823 --provider akshare
+```
+
+Results in WebView：![openbb05](images/openbb05.png)
+
+**Jupyter Notebook**：
+
+```Python
+from openbb import obb
+prices = obb.equity.price.historical(symbol='06823', start_date="2025-06-01", end_date="2025-06-10", provider="akshare")
+prices.results[0].date, prices.results[0].open, prices.results[0].close, prices.results[0].high, prices.results[0].low, prices.results[0].volume
+```
+
+Output：
+
+```
+(datetime.date(2025, 6, 2), 11.28, 11.3, 11.3, 11.14, 10308375)
+```
+
+## 🌟 openbb_akshare Project Ecosystem
+
+The `openbb_akshare` project is currently in an active development phase, and contributions from the open-source community are welcome:
+
+### Code Repositories
+
+- **GitHub**: https://github.com/finanalyzer/openbb_akshare
+
+- **GitCode (Domestic Mirror)**: https://gitcode.com/finanalyzer/openbb_akshare
+
+### Ways to Contribute
+
+1. Submit Issues to report data needs or bugs.
+
+2. Contribute PRs to optimize data source interfaces.
+
+3. Improve documentation to help more users.
+
+Through the integration of AKShare and OpenBB, users in China can more conveniently access real-time and historical data for markets such as A-Shares and Hong Kong Stocks, providing strong data support for quantitative analysis and investment research.

openbb_akshare-0.3.1/openbb_akshare/__init__.py

@@ -0,0 +1,26 @@
+"""openbb_akshare OpenBB Platform Provider."""
+
+from openbb_core.provider.abstract.provider import Provider
+from openbb_akshare.models.company_news import AKShareCompanyNewsFetcher
+from openbb_akshare.models.equity_quote import AKShareEquityQuoteFetcher
+from openbb_akshare.models.equity_historical import AKShareEquityHistoricalFetcher
+from openbb_akshare.models.historical_dividends import AKShareHistoricalDividendsFetcher
+
+# mypy: disable-error-code="list-item"
+
+provider = Provider(
+    name="akshare",
+    description="Data provider for openbb-akshare.",
+    # Only add 'credentials' if they are needed.
+    # For multiple login details, list them all here.
+    # credentials=["api_key"],
+    website="https://akshare.akfamily.xyz/",
+    # Here, we list out the fetchers showing what our provider can get.
+    # The dictionary key is the fetcher's name, used in the `router.py`.
+    fetcher_dict={
+        "CompanyNews": AKShareCompanyNewsFetcher,
+        "EquityQuote": AKShareEquityQuoteFetcher,
+        "EquityHistorical": AKShareEquityHistoricalFetcher,
+        "HistoricalDividends": AKShareHistoricalDividendsFetcher,
+    }
+)

openbb_akshare-0.3.1/openbb_akshare/models/__init__.py

@@ -0,0 +1 @@
+"""AKShare models directory."""

openbb_akshare-0.3.1/openbb_akshare/models/company_news.py

@@ -0,0 +1,100 @@
+"""AKShare Company News Model."""
+
+# pylint: disable=unused-argument
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.company_news import (
+    CompanyNewsData,
+    CompanyNewsQueryParams,
+)
+from pydantic import Field, field_validator
+
+class AKshareCompanyNewsQueryParams(CompanyNewsQueryParams):
+    """AKShare Company News Query.
+
+    Source: https://so.eastmoney.com/news/s
+    """
+
+    __json_schema_extra__ = {"symbol": {"multiple_items_allowed": True}}
+
+    @field_validator("symbol", mode="before", check_fields=False)
+    @classmethod
+    def _symbol_mandatory(cls, v):
+        """Symbol mandatory validator."""
+        if not v:
+            raise ValueError("Required field missing -> symbol")
+        return v
+
+
+class AKShareCompanyNewsData(CompanyNewsData):
+    """AKShare Company News Data."""
+
+    source: Optional[str] = Field(
+        default=None, description="Source of the news article"
+    )
+
+
+class AKShareCompanyNewsFetcher(
+    Fetcher[
+        AKshareCompanyNewsQueryParams,
+        List[AKShareCompanyNewsData],
+    ]
+):
+    """Transform the query, extract and transform the data from the AKShare endpoints."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> AKshareCompanyNewsQueryParams:
+        """Define example transform_query.
+
+        Here we can pre-process the query parameters and add any extra parameters that
+        will be used inside the extract_data method.
+        """
+        return AKshareCompanyNewsQueryParams(**params)
+
+    @staticmethod
+    async def aextract_data(
+        query: AKshareCompanyNewsQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[dict]:
+        """Extract data."""
+        # pylint: disable=import-outside-toplevel
+        import asyncio  # noqa
+        from openbb_core.provider.utils.errors import EmptyDataError
+        from openbb_core.provider.utils.helpers import get_requests_session
+        import akshare as ak
+
+        results: list = []
+        symbols = query.symbol.split(",")  # type: ignore
+        async def get_one(symbol):
+            data = ak.stock_news_em(symbol)
+            for idx, d in data.iterrows():
+                new_content: dict = {}
+                new_content["text"] = d["新闻内容"]
+                new_content["url"] = d["新闻链接"]
+                new_content["source"] = d["文章来源"]
+                new_content["title"] = d["新闻标题"]
+                new_content["date"] = d["发布时间"]
+
+                results.append(new_content)
+
+        tasks = [get_one(symbol) for symbol in symbols]
+
+        await asyncio.gather(*tasks)
+
+        if not results:
+            raise EmptyDataError("No data was returned for the given symbol(s)")
+
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: AKshareCompanyNewsQueryParams, data: List[dict], **kwargs: Any
+    ) -> List[AKShareCompanyNewsData]:
+        """Define example transform_data.
+
+        Right now, we're converting the data to fit our desired format.
+        You can apply other transformations to it here.
+        """
+        return [AKShareCompanyNewsData(**d) for d in data]

openbb_akshare-0.3.1/openbb_akshare/models/equity_historical.py

@@ -0,0 +1,118 @@
+"""AKShare Equity Historical Price Model."""
+
+# pylint: disable=unused-argument
+
+import asyncio
+from datetime import datetime
+from typing import Any, Dict, List, Literal, Optional
+from warnings import warn
+
+from dateutil.relativedelta import relativedelta
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.equity_historical import (
+    EquityHistoricalData,
+    EquityHistoricalQueryParams,
+)
+from openbb_core.provider.utils.descriptions import (
+    DATA_DESCRIPTIONS,
+    QUERY_DESCRIPTIONS,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from openbb_core.provider.utils.helpers import (
+    amake_request,
+    get_querystring,
+)
+from openbb_fmp.utils.helpers import get_interval
+from pydantic import Field
+
+
+class AKShareEquityHistoricalQueryParams(EquityHistoricalQueryParams):
+    """AKShare Equity Historical Price Query.
+
+    Source: https://financialmodelingprep.com/developer/docs/#Stock-Historical-Price
+    """
+
+    __json_schema_extra__ = {
+        "symbol": {"multiple_items_allowed": True},
+        "period": {"choices": ["daily", "weekly", "monthly"]},
+    }
+
+    period: Literal["daily", "weekly", "monthly"] = Field(
+        default="daily", description=QUERY_DESCRIPTIONS.get("period", "")
+    )
+
+
+class AKShareEquityHistoricalData(EquityHistoricalData):
+    """AKShare Equity Historical Price Data."""
+
+    __alias_dict__ = {
+        "date": "日期",
+        "open": "开盘",
+        "close": "收盘",
+        "high": "最高",
+        "low": "最低",
+        "volume": "成交量",
+        "change": "涨跌额",
+        "change_percent": "涨跌幅",
+    }
+
+    change: Optional[float] = Field(
+        default=None,
+        description="Change in the price from the previous close.",
+    )
+    change_percent: Optional[float] = Field(
+        default=None,
+        description="Change in the price from the previous close, as a normalized percent.",
+        json_schema_extra={"x-unit_measurement": "percent", "x-frontend_multiply": 100},
+    )
+
+
+class AKShareEquityHistoricalFetcher(
+    Fetcher[
+        AKShareEquityHistoricalQueryParams,
+        List[AKShareEquityHistoricalData],
+    ]
+):
+    """Transform the query, extract and transform the data from the AKShare endpoints."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> AKShareEquityHistoricalQueryParams:
+        """Transform the query params."""
+        transformed_params = params
+
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = now - relativedelta(years=1)
+
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return AKShareEquityHistoricalQueryParams(**transformed_params)
+
+    @staticmethod
+    def extract_data(
+        query: AKShareEquityHistoricalQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Return the raw data from the AKShare endpoint."""
+        from openbb_akshare.utils.helpers import ak_download
+
+        data = ak_download(symbol=query.symbol, start_date=query.start_date, end_date=query.end_date, period="daily", adjust="")
+
+        if data.empty:
+            raise EmptyDataError()
+
+        return data
+
+
+    @staticmethod
+    def transform_data(
+        query: AKShareEquityHistoricalQueryParams, data: List[Dict], **kwargs: Any
+    ) -> List[AKShareEquityHistoricalData]:
+        """Return the transformed data."""
+
+        return [
+            AKShareEquityHistoricalData.model_validate(d)
+            for d in data.to_dict("records")
+        ]

openbb_akshare-0.3.1/openbb_akshare/models/equity_quote.py

@@ -0,0 +1,153 @@
+"""AKShare Equity Quote Model."""
+
+# pylint: disable=unused-argument
+
+from typing import Any, Dict, List, Optional
+from warnings import warn
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.equity_quote import (
+    EquityQuoteData,
+    EquityQuoteQueryParams,
+)
+from pydantic import Field
+import logging
+from openbb_akshare.utils.tools import setup_logger, normalize_symbol, get_symbol_base
+
+logger = logging.getLogger(__name__)
+
+class AKShareEquityQuoteQueryParams(EquityQuoteQueryParams):
+    """AKShare Equity Quote Query."""
+
+    __json_schema_extra__ = {"symbol": {"multiple_items_allowed": True}}
+
+
+class AKShareEquityQuoteData(EquityQuoteData):
+    """AKShare Equity Quote Data."""
+
+    __alias_dict__ = {
+        "symbol": "代码",
+        "name": "名称",
+        "exchange": "交易所",
+        "last_price": "现价",
+        "open": "今开",
+        "close": "均价",
+        "high": "最高",
+        "low": "最低",
+        "prev_close": "昨收",
+        "year_high": "52周最高",
+        "year_low": "52周最低",
+        "volume": "成交量",
+        "change": "涨跌",
+        "participant_timestamp": "时间",
+        "market_cap": "流通值",
+        "pe_ratio": "市盈率(动)",
+        "pe_ratio_ttm": "市盈率(TTM)",
+        "turnover": "成交额",
+        "currency": "货币",
+    }
+
+    market_cap: Optional[float] = Field(
+        default=None,
+        description="Market capitalization.",
+    )
+    pe_ratio: Optional[float] = Field(
+        default=None,
+        description="Price-to-earnings ratio.",
+    )
+    pe_ratio_ttm: Optional[float] = Field(
+        default=None,
+        description="Price-to-earnings ratio (TTM).",
+    )
+    turnover: Optional[float] = Field(
+        default=None,
+        description="Turnover of the stock.",
+    )
+    currency: Optional[str] = Field(
+        default=None,
+        description="Currency of the price.",
+    )
+
+
+class AKShareEquityQuoteFetcher(
+    Fetcher[AKShareEquityQuoteQueryParams, List[AKShareEquityQuoteData]]
+):
+    """AKShare Equity Quote Fetcher."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> AKShareEquityQuoteQueryParams:
+        """Transform the query."""
+        return AKShareEquityQuoteQueryParams(**params)
+
+    @staticmethod
+    async def aextract_data(
+        query: AKShareEquityQuoteQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the raw data from AKShare."""
+        # pylint: disable=import-outside-toplevel
+        import asyncio  # noqa
+        from curl_adapter import CurlCffiAdapter
+        from openbb_core.provider.utils.helpers import get_requests_session
+        import akshare as ak
+
+        symbols = query.symbol.split(",")
+        results = []
+        fields = ['代码', 
+                  '名称', 
+                  '交易所', 
+                  '现价', 
+                  '今开',
+                  '均价', 
+                  '最高', 
+                  '最低', 
+                  '昨收', 
+                  '52周最高', 
+                  '52周最低', 
+                  '成交量', 
+                  '涨跌', 
+                  '时间', 
+                  '流通值', 
+                  '市盈率(动)', 
+                  '市盈率(TTM)',
+                  '成交额', 
+                  '货币']
+        async def get_one(symbol):
+            """Get the data for one ticker symbol."""
+            result: dict = {}
+            ticker: dict = {}
+            try:
+                symbol_b, symbol_f, market = normalize_symbol(symbol)
+                if market == "SH" or market == "SZ":
+                    symbol = market+symbol_b
+                elif market == "BJ":
+                    symbol = "NQ"+symbol_b
+                ticker_df = ak.stock_individual_spot_xq(symbol)
+                if ticker_df.empty:
+                    logger.debug("ticker_df is empty.")
+                else:
+                    ticker = dict(zip(ticker_df['item'], ticker_df['value']))
+            except Exception as e:
+                warn(f"Error getting data for {symbol}: {e}")
+            if ticker:
+                for field in fields:
+                    if field in ticker:
+                        result[field] = ticker.get(field, None)
+                if result:
+                    results.append(result)
+
+        tasks = [get_one(symbol) for symbol in symbols]
+
+        await asyncio.gather(*tasks)
+
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: AKShareEquityQuoteQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[AKShareEquityQuoteData]:
+        """Transform the data."""
+        return [AKShareEquityQuoteData.model_validate(d) for d in data]