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。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

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.