Access Finnhub API for real-time stock quotes, company news, market data, financial statements, and trading signals

Finnhub 是一个专注于全球金融市场的数据 API 服务平台，核心能力覆盖实时股票报价、历史行情（OHLCV）、公司基本面数据（财务报表、盈利预测）、SEC 文件智能检索及技术分析信号（RSI、支撑阻力、形态识别等）。其显著优势在于免费层级即可覆盖大多数基础需求——包括 60 次/分钟调用频率、实时美股报价及历史 K 线数据，降低了个人投资者和开发者的准入门槛；API 设计遵循 RESTful 规范，返回结构清晰（报价端点直接提供当前价、高开低收、前收盘等字段），文档示例完整，上手成本较低；同时支持公司新闻聚合与通用市场资讯，便于结合事件驱动策略。潜在局限性在于：高级功能（技术指标扫描、形态识别、高频实时流等）需订阅付费层级；免费版在调用频次和实时性上存在硬性天花板，不适合高频交易场景；数据源虽覆盖美股为主，但其他市场深度可能不及专业终端；API 以轮询模式为主，缺少原生 WebSocket 推送，对延迟敏感型策略需自行优化。适合人群包括：量化研究员、个人投资者、金融科技开发者、学生及教育机构——尤其是需要低成本获取标准化市场数据进行策略回测、信号验证或教学演示的用户。常规风险方面：API Key 需妥善保管（建议通过环境变量注入，避免硬编码泄露）；金融数据存在延迟可能（免费版非交易所直连），不宜用于实盘高频决策；SEC 文件检索功能依赖文本解析准确性，关键信息应人工复核原始披露文件；此外，服务稳定性受第三方云服务商影响，生产环境建议实现熔断降级与本地缓存机制。

核心用法

Finnhub Skill 是一个纯文档型技能，提供 Finnhub 金融数据 API 的完整使用指南。用户需自行配置 FINNHUB_API_KEY 环境变量，即可通过标准 HTTP GET 请求获取各类金融数据。核心端点包括：

• 实时报价 (/quote): 获取股票当前价格、开盘/最高/最低价、昨收
• 公司新闻 (/company-news): 按日期范围获取特定公司的新闻
• 财务报表 (/financials-reported): 查询利润表、资产负债表、现金流量表
• 市场数据 (/candle): 获取 OHLCV 历史 K 线数据
• 技术指标 (/indicator): RSI、支撑/阻力位、形态识别（部分需付费）
• SEC 文件搜索 (/search-in-filing): 在 10-K、10-Q 等文件中搜索关键词

显著优点

1. 数据源权威: Finnhub.io 是知名金融数据服务商，覆盖全球 60+ 交易所，数据实时性高
2. 功能全面: 一站式覆盖报价、新闻、财报、技术信号、日历等多维度数据
3. 免费可用: 提供 60 调用/分钟的免费额度，适合个人投资者轻度使用
4. 无代码风险: 纯文档型 Skill，无可执行代码，无供应链攻击面
5. 透明合规: 用户自主管理 API Key，无数据外泄或隐私收集风险

潜在缺点与局限性

• 速率限制严格: 免费版仅 60 次/分钟，高频策略或实时盯盘需付费升级
• 技术指标付费墙: RSI、形态识别等高级功能需订阅付费套餐
• 非官方封装: Skill 仅为使用文档，无 SDK 级封装，需用户自行构造 HTTP 请求
• 延迟考量: 免费版实时数据有延迟，毫秒级交易场景不适用
• 数据覆盖: 部分小众市场或 OTC 股票可能数据不全

适合人群

• 个人投资者进行基本面研究和技术分析
• 量化开发者快速验证策略原型
• 财经内容创作者获取实时数据素材
• 学习金融 API 调用的开发者

常规风险

1. API Key 泄露风险: 用户需妥善保管 FINNHUB_API_KEY，避免硬编码提交到代码仓库
2. 数据依赖风险: 金融数据仅供参考，不构成投资建议，需自行交叉验证
3. 服务可用性: 依赖 Finnhub 官方服务稳定性，极端行情下可能出现延迟
4. 合规使用: 获取的数据需遵守 Finnhub 服务条款，禁止未经授权的再分发