Ashare 轻量行情数据工具

定位

Ashare 是 GitHub 上 3.2k Stars 的极简 A 股行情库，单文件、零配置、零注册。核心只有一个函数 get_price()，用新浪+腾讯双数据源自动切换，稳定性极高。

它的价值不在于数据丰富度（只有行情K线），而在于可靠性——当 akshare、efinance、adata 因为上游网站改版或反爬而暂时不可用时，Ashare 几乎总是能正常工作。

依赖

bash
pip install requests pandas

无需安装额外包，requests 和 pandas 通常已存在于 Python 环境中。

使用

唯一脚本：scripts/quote_data.py

单只股票行情

bash
# 日线（最近30天）
python quote_data.py quote --code sh000001 --count 30

# 周线
python quote_data.py quote --code sh600519 --freq 1w --count 20

# 月线
python quote_data.py quote --code sz000001 --freq 1M --count 12

# 5分钟线
python quote_data.py quote --code sh600519 --freq 5m --count 48

# 指定结束日期
python quote_data.py quote --code sh600519 --freq 1d --count 60 --end 2026-01-31

批量获取

bash
python quote_data.py multi --code sh600519,sz000001,sh000300 --count 10

代码格式

| 格式 | 说明 | 示例 | |------|------|------| | sh + 代码 | 上海证券交易所 | sh600519（茅台）、sh000001（上证指数） | | sz + 代码 | 深圳证券交易所 | sz000001（平安银行） | | 代码.XSHG | JoinQuant 格式（沪） | 000001.XSHG | | 代码.XSHE | JoinQuant 格式（深） | 000001.XSHE |

支持的周期

| 周期 | 参数 | 数据源 | |------|------|--------| | 日线 | 1d | 新浪（主）→ 腾讯（备） | | 周线 | 1w | 新浪（主）→ 腾讯（备） | | 月线 | 1M | 新浪（主）→ 腾讯（备） | | 1分钟 | 1m | 腾讯（独占） | | 5分钟 | 5m | 新浪（主）→ 腾讯（备） | | 15分钟 | 15m | 新浪（主）→ 腾讯（备） | | 30分钟 | 30m | 新浪（主）→ 腾讯（备） | | 60分钟 | 60m | 新浪（主）→ 腾讯（备） |

返回字段

time, open, close, high, low, volume（前复权）

与其他数据源的关系

Ashare 只做行情K线，没有财务、资金流、北向资金等数据。它的定位是：

• 行情获取的最终回退方案：当其他源全部不可用时，Ashare 大概率还能工作
• 最快的行情查询：单文件、零配置、响应快
• 分钟级K线的补充源：1m 数据只有腾讯有，Ashare 是获取它的最简方式

使用优先级建议：

1. 先尝试 efinance-data / akshare-finance（数据最全）
2. 如果挂了，尝试 adata-source
3. 如果还挂了，用 ashare-data（几乎不会挂）

注意事项

1. 数据来源为新浪财经和腾讯财经公开接口
2. 返回数据为前复权（qfq）
3. 非交易时段返回最近交易日数据
4. count 参数控制返回K线根数，不是天数