aquery-sdk 1.0.0__tar.gz

aquery_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 superxu520
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aquery_sdk-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include aquery *.py

aquery_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: aquery-sdk
+Version: 1.0.0
+Summary: A-Query Open API Python SDK - A股20年全量数据查询服务
+Author: superxu520
+License: MIT
+Project-URL: Homepage, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Documentation, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Repository, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Issues, https://huggingface.co/spaces/superxu520/A-query/discussions
+Keywords: aquery,a-share,stock,finance,tushare,quant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+---
+title: A-Query Open API
+emoji: 📊
+colorFrom: blue
+colorTo: green
+sdk: docker
+pinned: false
+---
+
+# A-Query Open API
+
+A股20年全量数据查询服务 - 统一API接口
+
+## 项目概述
+
+基于Hugging Face数据集构建的A股数据查询服务，提供统一、高效、易用的数据查询接口。
+
+**数据范围**: 2000年-2026年，覆盖全部A股上市公司  
+**数据来源**: Tushare Pro  
+**存储位置**: Hugging Face Datasets
+
+## 快速开始
+
+### 1. 安装客户端
+
+```bash
+pip install pandas requests
+# 然后将client文件夹复制到你的项目中
+```
+
+### 2. 使用Python SDK
+
+```python
+from client import AQueryClient
+
+# 初始化客户端
+client = AQueryClient(token="your_token")
+
+# 查询股票基础信息
+df = client.stock_basic(market="主板")
+print(df.head())
+
+# 查询个股历史数据
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231,
+    fields=["trade_date", "open", "close", "vol", "pe"]
+)
+print(df)
+
+# 查询某日全市场数据
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount"]
+)
+print(df.head(10))
+```
+
+### 3. HTTP API调用
+
+```bash
+curl -X POST https://your-space.hf.space/api/v1/query \
+  -H "Content-Type: application/json" \
+  -H "X-Token: your_token" \
+  -d '{
+    "api_name": "daily_history",
+    "params": {
+      "ts_code": "000001.SZ",
+      "start_date": 20240101,
+      "end_date": 20240131
+    },
+    "fields": "trade_date,open,high,low,close,vol"
+  }'
+```
+
+## 支持的API列表
+
+| api_name | 数据集 | 说明 | 主要参数 |
+|----------|--------|------|----------|
+| stock_basic | A_meta_info | 股票基础信息 | ts_code, market |
+| trade_cal | A_meta_info | 交易日历 | start_date, end_date |
+| company_info | A_meta_info | 公司信息 | ts_code |
+| industry_sw | A_meta_info | 申万行业映射 | ts_code, industry_level |
+| industry_sw_class | A_meta_info | 申万行业分类 | level |
+| fina_indicator | A_meta_info | 财务指标 | ts_code, end_date |
+| daily | A_by_date | 日线行情 | ts_code, trade_date, start_date, end_date |
+| daily_all | A_by_date | 某日全市场 | trade_date |
+| daily_history | A_by_code | 个股历史 | ts_code, start_date, end_date |
+
+## 统一接口规范
+
+### 请求格式
+
+```json
+{
+  "api_name": "daily_history",
+  "token": "your_token",
+  "params": {
+    "ts_code": "000001.SZ",
+    "start_date": 20240101,
+    "end_date": 20241231
+  },
+  "fields": "trade_date,open,close,vol"
+}
+```
+
+### 响应格式
+
+```json
+{
+  "code": 0,
+  "msg": "success",
+  "data": {
+    "fields": ["trade_date", "open", "close", "vol"],
+    "items": [
+      [20240102, 9.5, 9.7, 1000000],
+      [20240103, 9.7, 9.8, 1200000]
+    ],
+    "count": 2,
+    "has_more": false
+  },
+  "request_id": "req_abc123"
+}
+```
+
+## 本地部署
+
+### 1. 克隆项目
+
+```bash
+git clone <repository-url>
+cd a-query
+```
+
+### 2. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 3. 运行服务
+
+```bash
+python -m uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload
+```
+
+### 4. Docker部署
+
+```bash
+docker build -t aquery-api .
+docker run -p 7860:7860 aquery-api
+```
+
+## Hugging Face Space部署
+
+1. 在Hugging Face创建新的Space，选择Docker模板
+2. 将代码推送到Space仓库
+3. 配置环境变量（如果需要）
+4. 访问Space URL查看API文档
+
+## 查询示例
+
+### 示例1: 获取某股票历史数据
+
+```python
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231
+)
+```
+
+### 示例2: 获取某日全市场数据
+
+```python
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount", "total_mv"]
+)
+```
+
+### 示例3: 条件选股
+
+```python
+# 查询某日PE<20且净流入>1亿的股票
+df = client.daily_all(trade_date=20240320)
+df = df[(df['pe'] < 20) & (df['net_mf_amount'] > 1e8)]
+```
+
+### 示例4: 获取财务指标
+
+```python
+df = client.fina_indicator(
+    ts_code="000001.SZ",
+    fields=["end_date", "roe", "eps", "grossprofit_margin"]
+)
+```
+
+## 性能指标
+
+| 场景 | 数据量 | 响应时间 |
+|------|--------|----------|
+| 股票基础信息 | 5,200条 | < 50ms |
+| 个股全历史 | 5,000条 | < 200ms |
+| 单日全市场 | 5,200条 | < 100ms |
+| 时间段截面 | 100万条 | < 2s |
+
+## 项目结构
+
+```
+.
+├── app/                    # FastAPI服务端
+│   ├── main.py            # 应用入口
+│   ├── core/              # 配置、认证
+│   ├── routers/           # API路由
+│   └── services/          # 查询服务
+├── client/                 # Python SDK
+│   └── aquery.py         # 客户端实现
+├── tests/                  # 测试
+├── Dockerfile             # 容器配置
+├── requirements.txt       # Python依赖
+└── README.md              # 本文档
+```
+
+## 技术栈
+
+- **FastAPI**: 高性能Web框架
+- **DuckDB**: 嵌入式OLAP查询引擎
+- **Polars**: 极速数据处理
+- **Hugging Face Datasets**: 数据存储
+
+## 许可证
+
+MIT License
+
+## 联系方式
+
+- 数据集: https://huggingface.co/datasets/superxu520/
+- 问题反馈: 请提交GitHub Issue

aquery_sdk-1.0.0/README.md

@@ -0,0 +1,240 @@
+---
+title: A-Query Open API
+emoji: 📊
+colorFrom: blue
+colorTo: green
+sdk: docker
+pinned: false
+---
+
+# A-Query Open API
+
+A股20年全量数据查询服务 - 统一API接口
+
+## 项目概述
+
+基于Hugging Face数据集构建的A股数据查询服务，提供统一、高效、易用的数据查询接口。
+
+**数据范围**: 2000年-2026年，覆盖全部A股上市公司  
+**数据来源**: Tushare Pro  
+**存储位置**: Hugging Face Datasets
+
+## 快速开始
+
+### 1. 安装客户端
+
+```bash
+pip install pandas requests
+# 然后将client文件夹复制到你的项目中
+```
+
+### 2. 使用Python SDK
+
+```python
+from client import AQueryClient
+
+# 初始化客户端
+client = AQueryClient(token="your_token")
+
+# 查询股票基础信息
+df = client.stock_basic(market="主板")
+print(df.head())
+
+# 查询个股历史数据
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231,
+    fields=["trade_date", "open", "close", "vol", "pe"]
+)
+print(df)
+
+# 查询某日全市场数据
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount"]
+)
+print(df.head(10))
+```
+
+### 3. HTTP API调用
+
+```bash
+curl -X POST https://your-space.hf.space/api/v1/query \
+  -H "Content-Type: application/json" \
+  -H "X-Token: your_token" \
+  -d '{
+    "api_name": "daily_history",
+    "params": {
+      "ts_code": "000001.SZ",
+      "start_date": 20240101,
+      "end_date": 20240131
+    },
+    "fields": "trade_date,open,high,low,close,vol"
+  }'
+```
+
+## 支持的API列表
+
+| api_name | 数据集 | 说明 | 主要参数 |
+|----------|--------|------|----------|
+| stock_basic | A_meta_info | 股票基础信息 | ts_code, market |
+| trade_cal | A_meta_info | 交易日历 | start_date, end_date |
+| company_info | A_meta_info | 公司信息 | ts_code |
+| industry_sw | A_meta_info | 申万行业映射 | ts_code, industry_level |
+| industry_sw_class | A_meta_info | 申万行业分类 | level |
+| fina_indicator | A_meta_info | 财务指标 | ts_code, end_date |
+| daily | A_by_date | 日线行情 | ts_code, trade_date, start_date, end_date |
+| daily_all | A_by_date | 某日全市场 | trade_date |
+| daily_history | A_by_code | 个股历史 | ts_code, start_date, end_date |
+
+## 统一接口规范
+
+### 请求格式
+
+```json
+{
+  "api_name": "daily_history",
+  "token": "your_token",
+  "params": {
+    "ts_code": "000001.SZ",
+    "start_date": 20240101,
+    "end_date": 20241231
+  },
+  "fields": "trade_date,open,close,vol"
+}
+```
+
+### 响应格式
+
+```json
+{
+  "code": 0,
+  "msg": "success",
+  "data": {
+    "fields": ["trade_date", "open", "close", "vol"],
+    "items": [
+      [20240102, 9.5, 9.7, 1000000],
+      [20240103, 9.7, 9.8, 1200000]
+    ],
+    "count": 2,
+    "has_more": false
+  },
+  "request_id": "req_abc123"
+}
+```
+
+## 本地部署
+
+### 1. 克隆项目
+
+```bash
+git clone <repository-url>
+cd a-query
+```
+
+### 2. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 3. 运行服务
+
+```bash
+python -m uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload
+```
+
+### 4. Docker部署
+
+```bash
+docker build -t aquery-api .
+docker run -p 7860:7860 aquery-api
+```
+
+## Hugging Face Space部署
+
+1. 在Hugging Face创建新的Space，选择Docker模板
+2. 将代码推送到Space仓库
+3. 配置环境变量（如果需要）
+4. 访问Space URL查看API文档
+
+## 查询示例
+
+### 示例1: 获取某股票历史数据
+
+```python
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231
+)
+```
+
+### 示例2: 获取某日全市场数据
+
+```python
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount", "total_mv"]
+)
+```
+
+### 示例3: 条件选股
+
+```python
+# 查询某日PE<20且净流入>1亿的股票
+df = client.daily_all(trade_date=20240320)
+df = df[(df['pe'] < 20) & (df['net_mf_amount'] > 1e8)]
+```
+
+### 示例4: 获取财务指标
+
+```python
+df = client.fina_indicator(
+    ts_code="000001.SZ",
+    fields=["end_date", "roe", "eps", "grossprofit_margin"]
+)
+```
+
+## 性能指标
+
+| 场景 | 数据量 | 响应时间 |
+|------|--------|----------|
+| 股票基础信息 | 5,200条 | < 50ms |
+| 个股全历史 | 5,000条 | < 200ms |
+| 单日全市场 | 5,200条 | < 100ms |
+| 时间段截面 | 100万条 | < 2s |
+
+## 项目结构
+
+```
+.
+├── app/                    # FastAPI服务端
+│   ├── main.py            # 应用入口
+│   ├── core/              # 配置、认证
+│   ├── routers/           # API路由
+│   └── services/          # 查询服务
+├── client/                 # Python SDK
+│   └── aquery.py         # 客户端实现
+├── tests/                  # 测试
+├── Dockerfile             # 容器配置
+├── requirements.txt       # Python依赖
+└── README.md              # 本文档
+```
+
+## 技术栈
+
+- **FastAPI**: 高性能Web框架
+- **DuckDB**: 嵌入式OLAP查询引擎
+- **Polars**: 极速数据处理
+- **Hugging Face Datasets**: 数据存储
+
+## 许可证
+
+MIT License
+
+## 联系方式
+
+- 数据集: https://huggingface.co/datasets/superxu520/
+- 问题反馈: 请提交GitHub Issue

aquery_sdk-1.0.0/aquery/__init__.py

@@ -0,0 +1,17 @@
+"""
+A-Query Open API Python SDK
+
+A股20年全量数据查询服务客户端
+
+快速开始:
+    >>> from aquery import AQueryClient
+    >>> client = AQueryClient(token="your_token")
+    >>> df = client.daily_history(ts_code="000001.SZ", start_date=20240101)
+
+文档: https://huggingface.co/spaces/superxu520/A-query
+"""
+from .client import AQueryClient, AQueryError
+
+__version__ = "1.0.0"
+__author__ = "superxu520"
+__all__ = ["AQueryClient", "AQueryError"]

aquery_sdk-1.0.0/aquery/client.py

@@ -0,0 +1,327 @@
+"""
+A-Query Python Client SDK
+提供便捷的数据查询接口，自动转换DataFrame格式
+"""
+import os
+from typing import Dict, Any, Optional, List, Union
+from urllib.parse import urljoin
+
+import pandas as pd
+import requests
+
+
+class AQueryError(Exception):
+    """AQuery客户端异常"""
+    pass
+
+
+class AQueryClient:
+    """
+    A-Query 数据查询客户端
+    
+    Attributes:
+        token: API认证Token
+        base_url: API服务地址
+        timeout: 请求超时时间(秒)
+    
+    Example:
+        >>> client = AQueryClient(token="your_token")
+        >>> # 查询股票基础信息
+        >>> df = client.stock_basic(market="主板")
+        >>> # 查询个股历史
+        >>> df = client.daily_history(ts_code="000001.SZ", start_date=20240101)
+        >>> # 查询某日全市场
+        >>> df = client.daily_all(trade_date=20240320)
+    """
+    
+    def __init__(
+        self, 
+        token: Optional[str] = None,
+        base_url: str = "https://superxu520-aquery.hf.space",
+        timeout: int = 60
+    ):
+        """
+        初始化客户端
+        
+        Args:
+            token: API认证Token，默认从环境变量AQUERY_TOKEN读取
+            base_url: API服务地址
+            timeout: 请求超时时间(秒)
+        """
+        self.token = token or os.getenv("AQUERY_TOKEN")
+        if not self.token:
+            raise AQueryError("请提供token参数或设置AQUERY_TOKEN环境变量")
+        
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Content-Type": "application/json",
+            "X-Token": self.token
+        })
+    
+    def _request(
+        self, 
+        method: str, 
+        endpoint: str, 
+        **kwargs
+    ) -> Dict[str, Any]:
+        """发送HTTP请求"""
+        url = urljoin(self.base_url, endpoint)
+        
+        try:
+            response = self.session.request(
+                method=method,
+                url=url,
+                timeout=self.timeout,
+                **kwargs
+            )
+            response.raise_for_status()
+            
+            data = response.json()
+            
+            if data.get("code") != 0:
+                raise AQueryError(f"API错误: {data.get('msg', '未知错误')}")
+            
+            return data
+            
+        except requests.exceptions.Timeout:
+            raise AQueryError(f"请求超时(>{self.timeout}秒)")
+        except requests.exceptions.ConnectionError:
+            raise AQueryError(f"连接失败，请检查base_url: {self.base_url}")
+        except requests.exceptions.HTTPError as e:
+            raise AQueryError(f"HTTP错误: {e.response.status_code} - {e.response.text}")
+    
+    def _to_dataframe(self, response: Dict[str, Any]) -> pd.DataFrame:
+        """将响应数据转换为DataFrame"""
+        data = response.get("data", {})
+        if "items" not in data or "fields" not in data:
+            raise AQueryError("响应数据格式错误，缺少items或fields字段")
+
+        df = pd.DataFrame(data["items"], columns=data["fields"])
+        # 附加元数据到DataFrame
+        df.attrs["count"] = response.get("count", 0)
+        df.attrs["has_more"] = response.get("has_more", False)
+        df.attrs["request_id"] = response.get("request_id")
+        return df
+    
+    def query(
+        self,
+        api_name: str,
+        params: Optional[Dict[str, Any]] = None,
+        fields: Optional[Union[str, List[str]]] = None
+    ) -> pd.DataFrame:
+        """
+        通用查询接口
+        
+        Args:
+            api_name: 接口名称，如stock_basic, daily, daily_history等
+            params: 查询参数字典
+            fields: 返回字段列表，可以是逗号分隔字符串或列表
+        
+        Returns:
+            pd.DataFrame: 查询结果
+        
+        Example:
+            >>> df = client.query("stock_basic", params={"market": "主板"})
+            >>> df = client.query("daily_history", 
+            ...                   params={"ts_code": "000001.SZ", "start_date": 20240101},
+            ...                   fields=["trade_date", "close", "pe"])
+        """
+        payload = {
+            "api_name": api_name,
+            "token": self.token,
+            "params": params or {}
+        }
+        
+        if fields:
+            if isinstance(fields, list):
+                fields = ",".join(fields)
+            payload["fields"] = fields
+        
+        result = self._request("POST", "/api/v1/query", json=payload)
+        return self._to_dataframe(result)
+    
+    # ===== 便捷方法 =====
+    
+    def stock_basic(
+        self,
+        ts_code: Optional[str] = None,
+        market: Optional[str] = None,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询股票基础信息
+        
+        Args:
+            ts_code: 股票代码，如000001.SZ
+            market: 市场类型，如主板/创业板/科创板/北交所
+            fields: 返回字段列表
+        
+        Returns:
+            包含ts_code, symbol, name, industry等字段的DataFrame
+        """
+        params = {}
+        if ts_code:
+            params["ts_code"] = ts_code
+        if market:
+            params["market"] = market
+        
+        return self.query("stock_basic", params=params, fields=fields)
+    
+    def trade_cal(
+        self,
+        start_date: Optional[int] = None,
+        end_date: Optional[int] = None,
+        is_open: Optional[int] = None,
+        exchange: str = "SSE",
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询交易日历
+        
+        Args:
+            start_date: 开始日期，如20240101
+            end_date: 结束日期，如20241231
+            is_open: 是否交易日，1是/0否
+            exchange: 交易所，SSE/SZSE
+            fields: 返回字段列表
+        """
+        params = {"exchange": exchange}
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+        if is_open is not None:
+            params["is_open"] = is_open
+        
+        return self.query("trade_cal", params=params, fields=fields)
+    
+    def daily(
+        self,
+        ts_code: str,
+        trade_date: Optional[int] = None,
+        start_date: Optional[int] = None,
+        end_date: Optional[int] = None,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询日线行情
+        
+        Args:
+            ts_code: 股票代码，如000001.SZ
+            trade_date: 特定交易日期
+            start_date: 开始日期
+            end_date: 结束日期
+            fields: 返回字段列表，如["trade_date", "open", "close", "vol"]
+        """
+        params = {"ts_code": ts_code}
+        if trade_date:
+            params["trade_date"] = trade_date
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+        
+        return self.query("daily", params=params, fields=fields)
+    
+    def daily_history(
+        self,
+        ts_code: str,
+        start_date: Optional[int] = None,
+        end_date: Optional[int] = None,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询个股历史数据（推荐用于回测）
+        
+        Args:
+            ts_code: 股票代码
+            start_date: 开始日期
+            end_date: 结束日期
+            fields: 返回字段列表
+        
+        Returns:
+            按trade_date排序的历史数据
+        """
+        params = {"ts_code": ts_code}
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+        
+        return self.query("daily_history", params=params, fields=fields)
+    
+    def daily_all(
+        self,
+        trade_date: int,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询某日全市场数据（适合选股）
+        
+        Args:
+            trade_date: 交易日期，如20240320
+            fields: 返回字段列表
+        
+        Returns:
+            该交易日所有股票的数据
+        """
+        params = {"trade_date": trade_date}
+        return self.query("daily_all", params=params, fields=fields)
+    
+    def fina_indicator(
+        self,
+        ts_code: str,
+        end_date: Optional[int] = None,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询财务指标
+        
+        Args:
+            ts_code: 股票代码
+            end_date: 报告期，如20241231
+            fields: 返回字段列表，如["end_date", "roe", "eps", "grossprofit_margin"]
+        """
+        params = {"ts_code": ts_code}
+        if end_date:
+            params["end_date"] = end_date
+        
+        return self.query("fina_indicator", params=params, fields=fields)
+    
+    def industry_sw(
+        self,
+        ts_code: Optional[str] = None,
+        industry_level: Optional[str] = None,
+        fields: Optional[List[str]] = None
+    ) -> pd.DataFrame:
+        """
+        查询申万行业分类映射
+        
+        Args:
+            ts_code: 股票代码
+            industry_level: 行业级别，L1/L2/L3
+            fields: 返回字段列表
+        """
+        params = {}
+        if ts_code:
+            params["ts_code"] = ts_code
+        if industry_level:
+            params["industry_level"] = industry_level
+        
+        return self.query("industry_sw", params=params, fields=fields)
+    
+    def list_apis(self) -> List[Dict[str, Any]]:
+        """
+        获取支持的API列表
+
+        Returns:
+            包含所有API信息的列表
+        """
+        result = self._request("GET", "/api/v1/apis")
+        return result.get("apis", [])
+
+
+# 向后兼容的别名
+Client = AQueryClient

aquery_sdk-1.0.0/aquery_sdk.egg-info/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: aquery-sdk
+Version: 1.0.0
+Summary: A-Query Open API Python SDK - A股20年全量数据查询服务
+Author: superxu520
+License: MIT
+Project-URL: Homepage, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Documentation, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Repository, https://huggingface.co/spaces/superxu520/A-query
+Project-URL: Issues, https://huggingface.co/spaces/superxu520/A-query/discussions
+Keywords: aquery,a-share,stock,finance,tushare,quant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+---
+title: A-Query Open API
+emoji: 📊
+colorFrom: blue
+colorTo: green
+sdk: docker
+pinned: false
+---
+
+# A-Query Open API
+
+A股20年全量数据查询服务 - 统一API接口
+
+## 项目概述
+
+基于Hugging Face数据集构建的A股数据查询服务，提供统一、高效、易用的数据查询接口。
+
+**数据范围**: 2000年-2026年，覆盖全部A股上市公司  
+**数据来源**: Tushare Pro  
+**存储位置**: Hugging Face Datasets
+
+## 快速开始
+
+### 1. 安装客户端
+
+```bash
+pip install pandas requests
+# 然后将client文件夹复制到你的项目中
+```
+
+### 2. 使用Python SDK
+
+```python
+from client import AQueryClient
+
+# 初始化客户端
+client = AQueryClient(token="your_token")
+
+# 查询股票基础信息
+df = client.stock_basic(market="主板")
+print(df.head())
+
+# 查询个股历史数据
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231,
+    fields=["trade_date", "open", "close", "vol", "pe"]
+)
+print(df)
+
+# 查询某日全市场数据
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount"]
+)
+print(df.head(10))
+```
+
+### 3. HTTP API调用
+
+```bash
+curl -X POST https://your-space.hf.space/api/v1/query \
+  -H "Content-Type: application/json" \
+  -H "X-Token: your_token" \
+  -d '{
+    "api_name": "daily_history",
+    "params": {
+      "ts_code": "000001.SZ",
+      "start_date": 20240101,
+      "end_date": 20240131
+    },
+    "fields": "trade_date,open,high,low,close,vol"
+  }'
+```
+
+## 支持的API列表
+
+| api_name | 数据集 | 说明 | 主要参数 |
+|----------|--------|------|----------|
+| stock_basic | A_meta_info | 股票基础信息 | ts_code, market |
+| trade_cal | A_meta_info | 交易日历 | start_date, end_date |
+| company_info | A_meta_info | 公司信息 | ts_code |
+| industry_sw | A_meta_info | 申万行业映射 | ts_code, industry_level |
+| industry_sw_class | A_meta_info | 申万行业分类 | level |
+| fina_indicator | A_meta_info | 财务指标 | ts_code, end_date |
+| daily | A_by_date | 日线行情 | ts_code, trade_date, start_date, end_date |
+| daily_all | A_by_date | 某日全市场 | trade_date |
+| daily_history | A_by_code | 个股历史 | ts_code, start_date, end_date |
+
+## 统一接口规范
+
+### 请求格式
+
+```json
+{
+  "api_name": "daily_history",
+  "token": "your_token",
+  "params": {
+    "ts_code": "000001.SZ",
+    "start_date": 20240101,
+    "end_date": 20241231
+  },
+  "fields": "trade_date,open,close,vol"
+}
+```
+
+### 响应格式
+
+```json
+{
+  "code": 0,
+  "msg": "success",
+  "data": {
+    "fields": ["trade_date", "open", "close", "vol"],
+    "items": [
+      [20240102, 9.5, 9.7, 1000000],
+      [20240103, 9.7, 9.8, 1200000]
+    ],
+    "count": 2,
+    "has_more": false
+  },
+  "request_id": "req_abc123"
+}
+```
+
+## 本地部署
+
+### 1. 克隆项目
+
+```bash
+git clone <repository-url>
+cd a-query
+```
+
+### 2. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 3. 运行服务
+
+```bash
+python -m uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload
+```
+
+### 4. Docker部署
+
+```bash
+docker build -t aquery-api .
+docker run -p 7860:7860 aquery-api
+```
+
+## Hugging Face Space部署
+
+1. 在Hugging Face创建新的Space，选择Docker模板
+2. 将代码推送到Space仓库
+3. 配置环境变量（如果需要）
+4. 访问Space URL查看API文档
+
+## 查询示例
+
+### 示例1: 获取某股票历史数据
+
+```python
+df = client.daily_history(
+    ts_code="000001.SZ",
+    start_date=20240101,
+    end_date=20241231
+)
+```
+
+### 示例2: 获取某日全市场数据
+
+```python
+df = client.daily_all(
+    trade_date=20240320,
+    fields=["ts_code", "close", "pe", "net_mf_amount", "total_mv"]
+)
+```
+
+### 示例3: 条件选股
+
+```python
+# 查询某日PE<20且净流入>1亿的股票
+df = client.daily_all(trade_date=20240320)
+df = df[(df['pe'] < 20) & (df['net_mf_amount'] > 1e8)]
+```
+
+### 示例4: 获取财务指标
+
+```python
+df = client.fina_indicator(
+    ts_code="000001.SZ",
+    fields=["end_date", "roe", "eps", "grossprofit_margin"]
+)
+```
+
+## 性能指标
+
+| 场景 | 数据量 | 响应时间 |
+|------|--------|----------|
+| 股票基础信息 | 5,200条 | < 50ms |
+| 个股全历史 | 5,000条 | < 200ms |
+| 单日全市场 | 5,200条 | < 100ms |
+| 时间段截面 | 100万条 | < 2s |
+
+## 项目结构
+
+```
+.
+├── app/                    # FastAPI服务端
+│   ├── main.py            # 应用入口
+│   ├── core/              # 配置、认证
+│   ├── routers/           # API路由
+│   └── services/          # 查询服务
+├── client/                 # Python SDK
+│   └── aquery.py         # 客户端实现
+├── tests/                  # 测试
+├── Dockerfile             # 容器配置
+├── requirements.txt       # Python依赖
+└── README.md              # 本文档
+```
+
+## 技术栈
+
+- **FastAPI**: 高性能Web框架
+- **DuckDB**: 嵌入式OLAP查询引擎
+- **Polars**: 极速数据处理
+- **Hugging Face Datasets**: 数据存储
+
+## 许可证
+
+MIT License
+
+## 联系方式
+
+- 数据集: https://huggingface.co/datasets/superxu520/
+- 问题反馈: 请提交GitHub Issue

aquery_sdk-1.0.0/aquery_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+aquery/__init__.py
+aquery/client.py
+aquery_sdk.egg-info/PKG-INFO
+aquery_sdk.egg-info/SOURCES.txt
+aquery_sdk.egg-info/dependency_links.txt
+aquery_sdk.egg-info/requires.txt
+aquery_sdk.egg-info/top_level.txt

aquery_sdk-1.0.0/aquery_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aquery_sdk-1.0.0/aquery_sdk.egg-info/requires.txt

@@ -0,0 +1,8 @@
+pandas>=1.3.0
+requests>=2.25.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+black>=22.0.0
+flake8>=4.0.0

aquery_sdk-1.0.0/aquery_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+aquery

aquery_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aquery-sdk"
+version = "1.0.0"
+description = "A-Query Open API Python SDK - A股20年全量数据查询服务"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "superxu520"}
+]
+keywords = ["aquery", "a-share", "stock", "finance", "tushare", "quant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pandas>=1.3.0",
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=22.0.0",
+    "flake8>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://huggingface.co/spaces/superxu520/A-query"
+Documentation = "https://huggingface.co/spaces/superxu520/A-query"
+Repository = "https://huggingface.co/spaces/superxu520/A-query"
+Issues = "https://huggingface.co/spaces/superxu520/A-query/discussions"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["aquery*"]
+exclude = ["tests*", "app*"]
+
+[tool.black]
+line-length = 100
+target-version = ['py38']
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"

aquery_sdk-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+