SuperAPI AI 工具集

us-stock

数据与分析

查看项目

更新于 10-16 01:34

技能介绍

用途:面向美股标的(如 AAPL、NVDA)查询价格以外的数据,包括基本面、持股结构、内部人交易、财务、新闻与股息拆股。价格与K线内部调用 TwelveData(付费);基本面等主要用 yfinance。

主要能力:get_realtime_quote、get_company_info、get_institutional_holders、get_mutualfund_holders、get_insider_transactions、get_financials、get_earnings、get_dividends、get_splits、get_news、get_kline、get_recommendations、get_options_expirations、get_etf_holdings,以及合并的 get_full_report。多数返回统一信封 {ok, source, data, error, ts}。

用法:优先通过 core.skill_tools 调用以避免 import 冲突;单技能脚本可按 exports.py 路径用 importlib 载入。不要使用 sys.path.insert + from exports import,避免与 cn-stock 的同名 exports.py 冲突。仅支持纯美股代码,如 AAPL、MSFT,双类股 BRK.B 等原样传入。

限制:yfinance 有速率限制(约 2000/小时),get_info 较重(约1-2秒),批量时建议 sleep(0.3);缺失字段返回 NaN 并转为 null;季度财务仅回溯约4个季度;盘中 yfinance 约1分钟延迟,与 TwelveData 冲突时以 TwelveData 为准;13F 机构持股有约45天滞后;期权完整链未暴露。SEC EDGAR 深度解析、原始 Form 4、盘前盘后、期权希腊值为未实现计划。使用时建议标注数据来源并非投资建议。