a-share-data查询A股行情、历史K线与复权、财务指标、公司新闻公告、概念及入选依据、行业分类与成分、解禁、回购、股东增减持、涨停炸板详情、龙虎榜席位、板块热力图、指数、宏观及A+H上市信息。用于股票数据查询、原始数据测试和数据源异常排查。
Independent GitHub snapshot · Automated classification · Original documentation governs
从本技能的 scripts/ 调用取数程序，先按下表选择入口，再按需读取对应参考。代码、依赖和参考文件均随本技能目录安装。
SKILL_DIR="<本技能安装目录的绝对路径>"
cd "$SKILL_DIR"
python3 -m pip install akshare MyTT pandas numpy requests beautifulsoup4
Python 3.9+；仅查询公司资讯时只需 requests；新增概念/公司事件/池详情/席位只需 requests，概念的同花顺解析另需 beautifulsoup4。以下示例均从技能根目录执行。
| 用户要查什么 | 入口 | 何时阅读参考 |
|---|---|---|
| 单票/批量报价、分钟线、大盘指数、龙虎榜、涨跌停、资金流 | scripts/fetch_realtime.py | 参数见 API参考 |
| 历史K线、复权选择、分红、交易日历、指数成分、业绩预告/快报、宏观 | scripts/fetch_history.py | 普通参数见 API参考；复权与缓存见 数据口径 |
| 综合或单项财务指标、某日之前已公告的指标 | scripts/fetch_history.py | 先读 财务日期口径 |
| MA、MACD、KDJ、RSI、BOLL等技术指标 | scripts/fetch_technical.py | API参考 |
| 某公司最近新闻/公告、近7天发生什么 | scripts/fetch_company_news.py | 公司资讯；优先于全市场业绩或舆情入口 |
| 公司有哪些概念、为何入选、同花顺常规/新兴/其他概念 | scripts/fetch_stock_concepts.py | 先读 概念与重点数据说明；保留供应商依据原文 |
| 个股/日期窗口解禁、回购计划及进度、已披露股东增减持 | scripts/fetch_corporate_actions.py | 先读 公司事件说明；按公告/解禁日期分别查询 |
| 涨停/炸板的封板时间、炸板次数、封单、连板及原始详情；龙虎榜买卖席位 | scripts/fetch_market_details.py | 先读 池详情与龙虎榜席位；核对真实交易日及沪深/全A覆盖范围 |
| 行业目录、申万1/2/3级分类、指定行业真实成分、行业指数历史 | scripts/fetch_industry.py | 先读 行业目录与成分 |
| 单只/多只股票所属行业与证券名称 | scripts/fetch_sector_info.py | API参考；当前文档化路径加 --no-concepts |
| 热门行业/概念、涨跌幅榜、热力图、指定板块groupKey成员、市场快讯 | scripts/fetch_danginvest.py | 先读 板块与快讯；检查stale |
| 个股业绩预告/快报和旧事件聚合入口 | scripts/fetch_stock_events.py | API参考；解禁/回购/增减持优先用新的公司事件入口，未分类新闻不能填成合同/监管事件 |
| A+H公司清单、H股上市日期范围 | scripts/fetch_ah_stocks.py | API参考 |
| A股赴港递表、聆讯、备案、招股、定价、配售、上市节点 | scripts/fetch_ah_ipo_timeline.py | API参考 |
行业目录/成员与“今天热门板块”是不同查询。SW、东财行业、东财概念、DangInvest的分类分别注明，不能用不同分类标准静默替换。
新增概念、公司事件、池详情和席位统一返回status/meta/data，供应商原值放在raw。partial表示有数据但覆盖不全；分页上限、断源、市场范围受限均须随结果说明。新增入口与完整参数见 重点数据使用说明书。
000001为平安银行。上证指数使用sh000001；支持sh600519、sz000001、600519.XSHG等格式。updated_at/queried_at是查询时间；交易日、新闻发布时间、公告日期和缓存的fetched_at分别读取，不能互相代替。--adjust raw，可选qfq/hfq；跨源降级必须保持所选口径。只有历史入口支持这里的显式复权参数，实时和技术入口按各自实现提供数据。stale=true只可作为旧快照呈现。需要最新板块/快讯可显式加--require-fresh，无法满足时返回失败；不能把查询成功当作数据最新。# 报价与批量报价
python3 scripts/fetch_realtime.py --quote 600519 --json
python3 scripts/fetch_realtime.py --multi-quote 600519,000001 --json
# 历史：明确复权，附带来源和缓存信息；测试在线取数可加--no-cache
python3 scripts/fetch_history.py --kline 600519 --adjust raw --count 10 --with-meta --json
# 公司近期资讯：保留原始候选与公告，不作语义筛选
python3 scripts/fetch_company_news.py --code 601899 --name 紫金矿业 --days 7 --json
# 概念和原始入选依据；未来30个自然日的解禁计划
python3 scripts/fetch_stock_concepts.py --code 601899 --source all --json
python3 scripts/fetch_corporate_actions.py --kind unlock --days 30 --json
# 涨停/炸板详情默认核实真实交易日；席位须给出明确日期
python3 scripts/fetch_market_details.py --pool broken --json
python3 scripts/fetch_market_details.py --seats 002317 --date 20261009 --json
# 行业目录与真实成分
python3 scripts/fetch_industry.py --action directory --taxonomy sw --level 1 --json
python3 scripts/fetch_industry.py --action members --taxonomy sw --symbol 801080 --json
# 热门板块：仅接受供应商明确标为新鲜的结果
python3 scripts/fetch_danginvest.py --summary --mode sub --limit 10 --require-fresh --json
# A+H清单和赴港上市节点
python3 scripts/fetch_ah_stocks.py --since 2020-01-01 --until 2024-12-31 --json
python3 scripts/fetch_ah_ipo_timeline.py --code 002352 --json
缓存为本地JSON文件，默认在本技能cache/；历史5分钟、行业目录1天、行业成员/指数历史5分钟、证券清单12小时。公司新闻另有结果和HTTP响应两层5分钟缓存。具体覆盖、环境变量、绕过缓存和当前限制见 缓存说明。缓存、并发及适配器由scripts负责，查询任务无需自行实现缓存服务。
新增入口缓存：概念5分钟、公司事件/龙虎榜席位2分钟、涨停/炸板池30秒；仅缓存完整成功或合法空结果，partial/unavailable不写缓存。所有新增入口支持--no-cache在线验证。