Finnhub 免费层 CLI 工具，专注美股实时报价、公司档案、内部人交易等 10 项核心数据，60 次/分钟配额，适合个人投资者快速查价与基本面研究
说明：
## 核心用法
Finnhub Pro 是一个 Python CLI 封装工具，将 Finnhub API 的免费层功能打包为命令行接口。用户需先注册获取 API Key 并通过环境变量 `FINNHUB_API_KEY` 传入，不支持硬编码密钥。
**主要功能模块（10 项免费功能）：**
– **实时报价**：`quote ` 获取最新股价、涨跌额、成交量
– **公司档案**：`profile ` 查看公司行业、市值、官网等元信息
– **公司新闻**：`news ` 获取最近 7 天新闻，支持日期筛选和数量限制
– **分析师推荐趋势**：`recommend ` 查看买入/持有/卖出评级分布
– **内部人交易记录**：`insiders ` 追踪高管和大股东最近 90 天交易动向
– **盈利日历**：`earnings [ticker]` 查询未来 30 天财报发布日期
– **基本面财务指标**：`financials ` 获取收入、利润、资产负债等核心数据
– **市场状态**：`market [exchange]` 查看交易所开盘/休市状态
– **同行公司**：`peers ` 列出同行业竞争对手
– **股票代码搜索**：`search ` 模糊匹配 ticker
**输出格式**：默认表格化展示，加 `–json` 可获取原始 API 响应便于二次处理。
## 显著优点
1. **零成本入门**：完全基于 Finnhub 免费层，无需订阅费用即可获取机构级金融数据
2. **命令行效率**：适合量化研究员、开发者集成到自动化工作流，比网页查询快 10 倍以上
3. **内部人交易特色功能**：免费层罕见提供高管交易追踪，对价值投资者判断管理层信心极具参考价值
4. **数据覆盖面广**：美股全市场覆盖，包含纳斯达克、NYSE、AMEX 三大交易所
5. **Python 原生**：依赖单一官方 SDK（`finnhub-python`），无复杂第三方依赖链
## 潜在缺点与局限性
1. **严格速率限制**：60 次/分钟对批量扫描场景捉襟见肘，监控多只股票时易触发 429 错误
2. **关键功能缺失**：K 线数据、分析师目标价、新闻情绪分析等核心量化功能需付费升级（月费 $25-75）
3. **无历史深度**：免费层新闻仅 7 天、内部人交易仅 90 天，无法做长期回溯分析
4. **美股单一市场**：不支持 A 股、港股等其他市场，地域局限性明显
5. **CLI 门槛**：非技术用户需要配置 Python 环境和环境变量，使用门槛高于网页工具
## 适合人群
– 个人价值投资者：快速查价 + 监控内部人交易信号
– 量化研究员：作为数据管道原型验证，正式生产需评估付费升级
– 财经自媒体：批量获取公司档案和新闻素材
– Python 开发者：需要金融数据 CLI 工具集成到 CI/CD 或自动化脚本
## 常规风险
1. **API Key 泄露风险**：脚本强制要求环境变量传入，但用户可能误将 Key 写入代码仓库或 shell 历史记录，建议配合 `direnv` 或 1Password CLI 管理密钥
2. **数据延迟风险**：免费层报价延迟约 1-15 分钟（非实时），不适合高频交易决策
3. **服务稳定性风险**：Finnhub 为第三方数据聚合商，非交易所官方数据源，极端行情下可能存在数据中断
4. **合规边界**：内部人交易数据仅供信息参考，不构成投资建议，需遵守 SEC Reg FD 信息披露规则
5. **速率超限惩罚**：频繁触发 429 可能导致临时 IP 封禁，建议实现指数退避重试机制
会员专属
