用 Python SDK 获取 A 股数据：pip install ashareapi

pip install ashareapi            # 基础：返回 list[dict]
pip install "ashareapi[pandas]"  # 加 DataFrame 支持（推荐）

from ashareapi import AShareAPI

cli = AShareAPI()                       # 免费端点无需 Key
df = cli.quote("sh600667")              # 实时行情 → DataFrame
print(df[["date", "last", "turnover"]])

print(cli.kline("600667.SH", count=5))  # 代码格式随便写（自动归一化）
print(cli.hot(limit=10))                # 热搜榜
print(cli.changedist())                 # 涨跌分布（市场广度）

from ashareapi import AShareAPI

cli = AShareAPI("ct-你的Key")            # 或设环境变量 ASHARE_API_KEY
df = cli.screen(preset="low_pe", orderby="ROETTM", limit=10)
print(df.head())

print(cli.fund("sh600667"))              # 资金流 + 龙虎榜 + 大宗 + 两融
print(cli.finance("sh600667"))           # 三大报表
print(cli.lhb("institution"))            # 龙虎榜机构榜

from ashareapi import (AShareAPI, AuthError, RateLimitError,
                       UpstreamError, EmptyResultError)

cli = AShareAPI()
try:
    df = cli.fund("sh600667")
except AuthError as e:          # 401 → 这是付费端点，去拿 Key
    print(e)
except RateLimitError as e:     # 429 → 降频 / 解一次 PoW 提额 / 升级档位
    print(e)
except UpstreamError as e:      # 上游取数失败（已自动换源、不扣次数）→ 重试一次
    print(e)
except EmptyResultError as e:   # 当前无数据（如当天无大宗交易）→ 不计费，换条件
    print(e)