Skip to main content
GET
Get Earnings Data
某只股票已公布的财报数据,包含实际值与预期值的对比。每条记录包含 report_period、fiscal_period、filing_date、filing_url 和 accession_number,一个包含 revenue、estimated_revenue、revenue_surprise 和 revenue_surprise_pct 的 quarterly 区块,earnings_per_share 的同样三项,以及同比变化字段。它还会返回 signals:由上游计算的标记,例如带 headline 以及其背后 actual / estimate / surprise_pct 的 EPS_BEAT。ticker 为必填,也是唯一的参数。适合用于查看公司实际公布了什么。如需尚未发生的前瞻性一致预期,请使用 get_financial_analyst_estimates。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。之后智能体通过几个元工具调用所有端点: search、list_categories、get_details 和 batch_quote 免费,batch_use 按次计费。各客户端的接入步骤见通过 MCP 连接;实时工具列表和 每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

请求规范

  • 方法与路径: GET /apis/v1/financial/earnings
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/financial/earnings
  • cursor: query; 可选
  • limit: query; 可选
  • ticker: query; 必填
  • Runtime 事实版本: 694a99fb21efca575a4b8ff0db4c82ec36667c583b6490faf3c0b3ff64e0beaa
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.02 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.02
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

cursor
string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

limit
integer
默认值:1

Number of most-recent report periods worth of filings to return, sorted by (report_period DESC, filing_date ASC). The number of entries returned may exceed limit when a recent period has both an 8-K and a 10-Q / 10-K. Values above 40 are clamped to 40. Non-positive or non-integer values return 400. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

必填范围: 1 <= x <= 40
ticker
string
必填

The ticker symbol (e.g. AAPL).

响应

收益响应

earnings
object[]

Flat list of SEC filings for the ticker, sorted by (report_period DESC, filing_date ASC). When limit=N, up to N report_periods worth of filings are returned; entry count may exceed N when a recent period has both an 8-K and a 10-Q/10-K.

next_page_url
string

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.