SuperAPI AI 工具集

finlab

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

FinLab 是一个量化交易 Python 包,支持台股(默认)、美股、韩股、日股、港股,以及台湾兴柜(rotc)和台湾可转债(tw_cb),覆盖个股与 ETF/基金。

用途与主要能力:通过 data.get("<表>:<列>") 获取价格、财报、估值、法人买卖、技术指标等数据;用 FinLabDataFrame 方法构建因子与布尔条件;用 sim() 回测并输出年化报酬、夏普、最大回撤等指标;可选通过 OrderExecutor 连接券商执行实盘订单。

安装与登录:需先安装 uv,再执行 uv python install 3.12 与 uv pip install --system "finlab>=2.0.0",或用 uv run --with "finlab" python3 script.py 零配置运行。登录用 python -m finlab login;无头环境用 python -m finlab token --env 导出 FINLAB_REFRESH_TOKEN、FINLAB_SESSION_ID、FINLAB_API_KEY 三个变量。旧版 FINLAB_API_TOKEN 已弃用,可用 python -m finlab migrate 迁移。

使用方式:先用 data.set_market(<code>) 选择市场,再取数据、建条件、组合成持仓 DataFrame(索引为日期、列为股票代码、值为布尔或仓位),最后 sim(position, resample="M") 回测。回测后应调用 report.to_html("report.html") 生成官方 HTML 报告作为交付物,不要自行手写报告。

限制:免费版每日 500 MB、VIP 5000 MB,每日 UTC+8 上午 8 点重置;超额需等待重置或升级。应避免前视偏差,不要用 reindex() 手动对齐数据。旧版 token 的移除时间官方未确认。部分美股数据(分析师共识、比率、DCF)仅限当前快照,不可用于历史回测。