ASL · ashare-lake — 本地可日更的 A 股研究湖
别再每次重拉、自己拼复权了。 一行命令,把能日更的 A 股研究湖落到本地。取数工具给你现在,湖给你历史。
CLI:asl · 包名:ashare_lake · Python ≥ 3.10 · 只做数据层(回测和信号留给下游)。
- 真数上手:
asl demo几分钟出可复权日线(不是 mock) - 日更能挂着跑:水位 / 失败重试 / 质量审计
- 研究口径一次定好:复权 · universe · PIT;相对拉数库多编排,相对云端宽表可本地续跑
安装与一分钟体验
需要 Python 3.10+,且能访问 TDX 行情主机(大陆出口更稳)。
pip install ashare-lake
asl demo
写入 data/ashare-lake-demo/(几只流动性股票 × 约 30 个交易日),并打印样例表。
asl query --config configs/ashare-lake.demo.toml --sql "
SELECT symbol, trade_date, close, volume, source
FROM daily_bars
WHERE symbol = '600519.SH'
ORDER BY trade_date DESC
LIMIT 10
"
全量日更(仍不必 clone;在含配置的工作目录执行):
asl config init # → configs/ashare-lake.toml(data.root 写为绝对路径)
# 或显式指定:
# asl config init --data-root /data/ashare-lake --force
asl config validate --config configs/ashare-lake.toml
asl init --config configs/ashare-lake.toml
asl run daily --config configs/ashare-lake.toml
有什么数据
数据集名即 load() 的第一个参数。字段见 schema,编排元数据见 catalog。
| 类别 | 数据集 |
|---|---|
| 基础参考 | instruments · trading_calendar · trading_status(停复牌 / ST) |
| 行情 | daily_bars(未复权) · index_bars · adj_factors · minute_bars / minute_bars_5m(可选日内) |
| 公司事件 | corporate_actions · announcement_index · earnings_disclosure_schedule |
| 基本面 / 估值 | financial_statement_items(PIT) · valuation_metrics · analyst_consensus |
| 资金面 | fund_flow · margin_trading · northbound_flows / northbound_holdings · dragon_tiger · block_trades · institutional_holdings |
| 结构 / 行业 | sector_members · index_constituents · industry_members |
| 宏观 | macro_indicators · market_breadth |
| 舆情 / 轮动 | sentiment_scores · hot_rank · sector_bars · sector_fund_flow · news_headlines |
| 风险 | share_unlock_schedule · regulatory_events |
读数据
from ashare_lake.query import load
bars = load("daily_bars", start="2020-01-01", end="2025-12-31", adjust="hfq")
roe = load("financial_statement_items", items=["roe"], as_of="2024-04-30")
无 extras —— pip install ashare-lake 即装齐所有数据源。
完整文档
详细 schema、runbook、定位对照与合规说明以 GitHub 为准:
代码 Apache-2.0。落盘行情 / 公告仍受上游条款约束——本包不附带、也不再分发数据湖。
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ashare_lake-0.5.0.tar.gz
(620.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ashare_lake-0.5.0-py3-none-any.whl
(707.9 kB
view details)