无法通过Finnhub.io获取标的5年盈利日历，寻求技术解决方案

先明确各接口的用途限制 #

• /calendar/earnings接口：该接口仅用于获取未来30天内的盈利发布预告，并非历史财报数据查询工具。你传入2022-2023的过去日期后返回空列表，属于接口设计的正常逻辑，这个接口不适合查询历史数据。
• /stock/earnings接口：这是历史财报数据接口，但数据获取范围受API订阅级别限制：
  • 免费版/基础版仅能获取最近12个月的历史盈利数据；
  • 要获取5年完整数据，需升级至付费套餐（如Starter及以上级别），付费套餐支持更长时间范围的历史数据访问权限。

具体解决步骤 #

1. 确认API订阅权限
   登录Finnhub后台查看你的套餐级别，若为免费版，无法获取超过12个月的数据，必须升级付费套餐才能解锁更长时间范围的历史数据访问权限。
2. 修正接口使用方式
   若已升级付费套餐，确保请求参数格式正确：
   • 使用Unix时间戳时，必须为秒级时间戳（避免使用毫秒级），示例Python代码生成5年前的时间戳：

     import time
     from datetime import datetime
     
     # 生成5年前的起始时间戳（2019-03-01）
     from_unix = int(time.mktime(datetime(2019, 3, 1).timetuple()))
     # 生成当前时间戳
     to_unix = int(time.time())
     
     url = f'https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&from={from_unix}&to={to_unix}&token={FINNHUB_KEY}'
     

   • 使用日期字符串时，确保格式为YYYY-MM-DD，且日期范围完整覆盖5年（例如from=2019-03-01&to=2024-03-01）。
3. 排查其他可能问题
   • 确认标的代码无拼写错误（AAPL为苹果公司正确代码）；
   • 检查API密钥是否有效，无权限限制或过期情况；
   • 直接在Finnhub官方API测试页面（后台API Playground）测试请求，排除Python SDK或代码逻辑问题。

免费用户替代方案 #

若无法升级付费套餐，可结合其他免费数据源补充历史数据：

• 使用yfinance库（Yahoo Finance的Python封装）获取历史财报数据；
• 使用Alpha Vantage免费API层获取盈利数据（注意其免费版的请求频率限制）。

内容的提问来源于stack exchange，提问作者eyal gromzin