美股数据一站查，内部人交易尽在掌握

Finnhub 免费层 CLI 工具，专注美股实时报价、公司档案、内部人交易等 10 项核心数据，60 次/分钟配额，适合个人投资者快速查价与基本面研究

基本信息

• 技能名称?Finnhub Pro
• 中文名称?美股数据一站查，内部人交易尽在掌握
• 作者?lsj210001
• 分类?专业技能
• 版本?1.1.0
• 标签?finance, stock-market, quantitative-trading, fundamental-analysis, cli-tool, api-wrapper, free-tier

使用方法

使用说明
核心用法
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 ），无复杂第三方依赖链
   潜在缺点与局限性
6. 严格速率限制 ：60 次/分钟对批量扫描场景捉襟见肘，监控多只股票时易触发 429 错误
7. 关键功能缺失 ：K 线数据、分析师目标价、新闻情绪分析等核心量化功能需付费升级（月费 $25-75）
8. 无历史深度 ：免费层新闻仅 7 天、内部人交易仅 90 天，无法做长期回溯分析
9. 美股单一市场 ：不支持 A 股、港股等其他市场，地域局限性明显
10. CLI 门槛 ：非技术用户需要配置 Python 环境和环境变量，使用门槛高于网页工具
    适合人群
    个人价值投资者：快速查价 + 监控内部人交易信号
    量化研究员：作为数据管道原型验证，正式生产需评估付费升级
    财经自媒体：批量获取公司档案和新闻素材
    Python 开发者：需要金融数据 CLI 工具集成到 CI/CD 或自动化脚本
    常规风险
11. API Key 泄露风险 ：脚本强制要求环境变量传入，但用户可能误将 Key 写入代码仓库或 shell 历史记录，建议配合 direnv 或 1Password CLI 管理密钥
12. 数据延迟风险 ：免费层报价延迟约 1-15 分钟（非实时），不适合高频交易决策
13. 服务稳定性风险 ：Finnhub 为第三方数据聚合商，非交易所官方数据源，极端行情下可能存在数据中断
14. 合规边界 ：内部人交易数据仅供信息参考，不构成投资建议，需遵守 SEC Reg FD 信息披露规则
15. 速率超限惩罚 ：频繁触发 429 可能导致临时 IP 封禁，建议实现指数退避重试机制