Earnings API

An API for earnings related information for US stocks

原始信息汇总

数据集概述：Earnings API

该数据集提供美国上市公司的盈利相关信息，通过一个无服务器 Express.js API 实现，涵盖历史每股收益（EPS）、历史收入、即将发布的盈利日历以及盈利惊喜数据。

核心功能与端点

该API包含以下4个主要端点，供用户查询不同维度的盈利数据：

序号	方法	端点	描述
1	GET	/api/eps/:symbol	获取特定股票的历史每股收益（包括基本和稀释后）。
2	GET	/api/revenue/:symbol	获取特定股票的历史收入数据。
3	GET	/api/earningscalendar	获取即将到来的盈利发布日期。
4	GET	/api/earningssurprise/:symbol	获取特定股票的盈利超预期/未达预期历史记录。

详细参数说明

1. EPS History — GET /api/eps/:symbol

• 路径参数：symbol（字符串，必填）- 美国股票代码，例如 AAPL。
• 查询参数：
  • period（字符串，可选）- 报告周期，可选 quarterly（季度，默认）或 annual（年度）。
  • startDate（字符串，可选）- 数据筛选起始日期，格式为 YYYY-MM-DD。
  • endDate（字符串，可选）- 数据筛选结束日期，格式为 YYYY-MM-DD。
• 用例：获取苹果公司过去两年的季度EPS数据，用于绘制盈利趋势图。

2. Revenue History — GET /api/revenue/:symbol

• 路径参数：symbol（字符串，必填）- 美国股票代码。
• 查询参数：与EPS History端点的period、startDate、endDate参数相同。
• 用例：在财务仪表盘中，比较不同科技公司的季度收入增长情况。

3. Earnings Calendar — GET /api/earningscalendar

• 查询参数：
  • date（字符串，可选）- 目标日期，格式为 YYYY-MM-DD，默认为当天。
• 用例：构建一周的盈利日历小部件，显示本周内发布财报的公司。

4. Earnings Surprise — GET /api/earningssurprise/:symbol

• 路径参数：symbol（字符串，必填）- 美国股票代码。
• 用例：在做投资决策前，分析某只股票的盈利超预期比率。

相关细节

• 错误处理：所有端点均返回JSON格式的错误信息。例如，无效股票代码会返回 { "error": "Invalid symbol "XYZ123"..." }。
• HTTP状态码：
  • 200：请求成功。
  • 500：服务器错误（可能由无效输入、数据获取失败或爬取问题导致）。
• 提供商：由用户 marcusyks 创建。
• 类别：金融（Financial）。
• 订阅模式：提供从免费（BASIC：$0.00/月）到高级（MEGA：$150.00/月）的多种套餐选择。