Financial Data
Company fundamentals, financial statements, market prices and economic data.
获取盈利快照
单只股票的已公布盈利,实际值与预期值对比。每条记录包含 report_period、fiscal_period、filing_date、filing_url 和 accession_number,以及一个 quarterly 区块,内含 revenue、estimated_revenue、revenue_surprise 和 revenue_surprise_pct,earnings_per_share 也有同样的三项,外加同比变化字段。它还返回 signals:上游计算的标记,例如 EPS_BEAT,并附带 headline 以及其背后的 actual / estimate / surprise_pct。ticker 为必填,也是唯一的参数。用于了解公司实际公布的数据。若需尚未发生的、前瞻性的一致预期,请用 get_financial_analyst_estimates。
计费参考
- 计量方式:按成功请求的固定成本计费。
- 参考请求估算:0.02 美元。
- 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: stringcursor
来自先前响应 next_page_url 的不透明分页游标。提供后,其他所有查询参数都会被忽略:游标携带原始请求的筛选条件。请将其视为不透明值,不要构造或修改。
- 类型: integerlimit最小值:1最大值:40
要返回的最近 报告期 的申报文件数量,按
(report_period DESC, filing_date ASC)排序。如果最近的报告期同时包含 8-K 和 10-Q / 10-K,返回的条目数可能超过limit。大于 40 的值会被限制为 40。非正数或非整数值返回 400。这是所有页面的总数,而不是页大小:每页最多包含 10 条记录,并通过next_page_url链接。 - 类型: stringticker必填
股票代码(例如
AAPL)。
- 类型: object · ResponseE40Feb4D3D6B_EarningsResponse200
盈利响应
- 类型: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]earnings
该 ticker 的 SEC 申报文件平铺列表,按 (report_period DESC, filing_date ASC) 排序。当
limit=N时,最多返回 N 个 report_period 的申报文件;如果最近一个期间同时包含 8-K 和 10-Q/10-K,条目数可能超过 N。- accession类型: string
_number 必填标识该申报文件的 SEC accession number。
- filing类型: string 格式: date
_date 必填SEC 受理申报的日历日,采用美国东部时间(SEC 的运营时区)。与
filing_datetime配对的日历日。 - filing类型: string 格式: uri
_url 必填SEC 申报文件的 URL。
- report类型: string 格式: date
_period 必填该申报文件覆盖的报告期。
- source类型: string 枚举
_type 必填该申报文件对应的 SEC 表格类型。
值- 8
- K - 10
- Q - 10
- K - 20
- F
- ticker类型: string必填
请求的 ticker 代码。
- annual类型: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capital类型: number | null
_expenditure - capital类型: number
_expenditure _chg 资本支出相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- capital类型: number
_expenditure _yoy _chg 资本支出相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- cash类型: number | null
_and _equivalents - change类型: number | null
_in _cash _and _equivalents - earnings类型: number | null
_per _share - earnings类型: number
_per _share _chg EPS 相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- earnings类型: number
_per _share _yoy _chg EPS 相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- free类型: number | null
_cash _flow - free类型: number
_cash _flow _chg 自由现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- free类型: number
_cash _flow _yoy _chg 自由现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- gross类型: number
_margin 毛利率,以小数表示(gross_profit / revenue)。仅在可计算时返回。
- gross类型: number
_margin _chg _bps 毛利率相对上一期间的绝对变化,以基点表示(例如 200.0 = 利润率扩大 200 bps)。仅在可计算时返回。
- gross类型: number
_margin _chg _pct 毛利率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- gross类型: number
_margin _yoy _chg _bps 毛利率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- gross类型: number
_margin _yoy _chg _pct 毛利率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- gross类型: number | null
_profit - gross类型: number
_profit _chg 毛利相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- gross类型: number
_profit _yoy _chg 毛利相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _financing - net类型: number
_cash _flow _from _financing _chg 融资活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _financing _yoy _chg 融资活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _investing - net类型: number
_cash _flow _from _investing _chg 投资活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _investing _yoy _chg 投资活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _operations - net类型: number
_cash _flow _from _operations _chg 经营活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _operations _yoy _chg 经营活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_income - net类型: number
_income _chg 净利润相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_income _yoy _chg 净利润相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number
_margin 净利率,以小数表示(net_income / revenue)。仅在可计算时返回。
- net类型: number
_margin _chg _bps 净利率相对上一期间的绝对变化,以基点表示。仅在可计算时返回。
- net类型: number
_margin _chg _pct 净利率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- net类型: number
_margin _yoy _chg _bps 净利率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- net类型: number
_margin _yoy _chg _pct 净利率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- operating类型: number | null
_income - operating类型: number
_income _chg 营业利润相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- operating类型: number
_income _yoy _chg 营业利润相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- operating类型: number
_margin 营业利润率,以小数表示(operating_income / revenue)。仅在可计算时返回。
- operating类型: number
_margin _chg _bps 营业利润率相对上一期间的绝对变化,以基点表示。仅在可计算时返回。
- operating类型: number
_margin _chg _pct 营业利润率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- operating类型: number
_margin _yoy _chg _bps 营业利润率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- operating类型: number
_margin _yoy _chg _pct 营业利润率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- revenue类型: number | null
- revenue类型: number
_chg 营收相对上一期间的百分比变化,以小数表示(例如 0.10 = +10%)。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- revenue类型: number
_yoy _chg 营收相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- shareholders类型: number | null
_equity - total类型: number | null
_assets - total类型: number | null
_debt - total类型: number | null
_liabilities - weighted类型: number | null
_average _shares - weighted类型: number | null
_average _shares _diluted
- currency类型: string
ISO 货币代码(例如 USD)。
- filing类型: string | null 格式: date-time
_datetime 记录 SEC 受理申报的日内时间戳,采用美国东部时间。取自 SEC EDGAR submissions API 上的
acceptanceDateTime字段。与filing_date配对(同一事件的日历日精度)。 - filing类型: string | null 枚举
_window SEC 受理申报时的市场时段,按美国东部时间评估。PRE_MARKET = 工作日 04:00–09:30 ET。DURING_MARKET = 工作日 09:30–16:00 ET。AFTER_HOURS = 工作日正常交易时段之外。WEEKEND = 周六或周日。当 filing_datetime 不可用时为 null。
值- P
R E _ M A R K E T - D
U R I N G _ M A R K E T - A
F T E R _ H O U R S - W
E E K E N D
- fiscal类型: string
_period 财年期间标签(例如 2026-Q1 或 2025-FY)。
- quarterly类型: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capital类型: number | null
_expenditure - capital类型: number
_expenditure _chg 资本支出相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- capital类型: number
_expenditure _yoy _chg 资本支出相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- cash类型: number | null
_and _equivalents - change类型: number | null
_in _cash _and _equivalents - earnings类型: number | null
_per _share - earnings类型: number
_per _share _chg EPS 相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- earnings类型: number
_per _share _yoy _chg EPS 相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- free类型: number | null
_cash _flow - free类型: number
_cash _flow _chg 自由现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- free类型: number
_cash _flow _yoy _chg 自由现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- gross类型: number
_margin 毛利率,以小数表示(gross_profit / revenue)。仅在可计算时返回。
- gross类型: number
_margin _chg _bps 毛利率相对上一期间的绝对变化,以基点表示(例如 200.0 = 利润率扩大 200 bps)。仅在可计算时返回。
- gross类型: number
_margin _chg _pct 毛利率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- gross类型: number
_margin _yoy _chg _bps 毛利率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- gross类型: number
_margin _yoy _chg _pct 毛利率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- gross类型: number | null
_profit - gross类型: number
_profit _chg 毛利相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- gross类型: number
_profit _yoy _chg 毛利相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _financing - net类型: number
_cash _flow _from _financing _chg 融资活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _financing _yoy _chg 融资活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _investing - net类型: number
_cash _flow _from _investing _chg 投资活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _investing _yoy _chg 投资活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_cash _flow _from _operations - net类型: number
_cash _flow _from _operations _chg 经营活动净现金流相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_cash _flow _from _operations _yoy _chg 经营活动净现金流相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number | null
_income - net类型: number
_income _chg 净利润相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- net类型: number
_income _yoy _chg 净利润相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- net类型: number
_margin 净利率,以小数表示(net_income / revenue)。仅在可计算时返回。
- net类型: number
_margin _chg _bps 净利率相对上一期间的绝对变化,以基点表示。仅在可计算时返回。
- net类型: number
_margin _chg _pct 净利率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- net类型: number
_margin _yoy _chg _bps 净利率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- net类型: number
_margin _yoy _chg _pct 净利率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- operating类型: number | null
_income - operating类型: number
_income _chg 营业利润相对上一期间的百分比变化,以小数表示。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- operating类型: number
_income _yoy _chg 营业利润相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- operating类型: number
_margin 营业利润率,以小数表示(operating_income / revenue)。仅在可计算时返回。
- operating类型: number
_margin _chg _bps 营业利润率相对上一期间的绝对变化,以基点表示。仅在可计算时返回。
- operating类型: number
_margin _chg _pct 营业利润率相对上一期间的百分比变化,以小数表示。仅在可计算时返回。
- operating类型: number
_margin _yoy _chg _bps 营业利润率相对上年同一财季的同比变化,以基点表示。仅限季度负载。仅在可计算时返回。
- operating类型: number
_margin _yoy _chg _pct 营业利润率相对上年同一财季的同比百分比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- revenue类型: number | null
- revenue类型: number
_chg 营收相对上一期间的百分比变化,以小数表示(例如 0.10 = +10%)。季度负载中为环比,年度负载中为同比。仅在可计算时返回。
- revenue类型: number
_yoy _chg 营收相对上年同一财季的同比变化,以小数表示。仅限季度负载。仅在可计算时返回。
- shareholders类型: number | null
_equity - total类型: number | null
_assets - total类型: number | null
_debt - total类型: number | null
_liabilities - weighted类型: number | null
_average _shares - weighted类型: number | null
_average _shares _diluted
- signals类型: array object[] · ResponseE40Feb4D3D6B_Signal[]
从该申报文件中提炼的、经整理的股价敏感洞察。每项包含预渲染的
headline、结构化的details和importance排名。仅当该条目触发至少一个信号时返回;否则省略该字段。每个条目最多 8 条,按 HIGH → MEDIUM → LOW 排序。从该申报文件中提炼的、经过整理的股价敏感洞察。预渲染的
headline适合直接展示;details包含用于筛选和程序化使用的结构化字段。信号按优先级顺序返回(最重要的在前);type本身即编码了量级(例如STRONG_REVENUE_INCREASE与REVENUE_INCREASE)。- headline类型: string必填
预渲染的人类可读摘要,适合直接展示。
- type类型: string 枚举必填
信号类别。MARGIN_EXPANSION/MARGIN_CONTRACTION:毛利率、营业利润率或净利率中任一项同比变动 ≥100bps。GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED:申报文件中报告的前瞻性指引变化。SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE:按有机营收增长计算表现最好或最差的可报告分部。NON_GAAP_DIVERGENCE:调整后/非 GAAP 数字与同期的 GAAP 对应数字存在重大差异。BACKLOG_SURGE/BACKLOG_DECLINE:积压订单或剩余履约义务同比变动 ≥20%。REVENUE_INCREASE/STRONG_REVENUE_INCREASE 及 DECLINE 变体:分档的营收同比变化(≥10% / ≥20% 量级)。NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE 及 DECLINE 变体:分档的净利润同比变化(≥15% / ≥30%)。EPS_INCREASE/STRONG_EPS_INCREASE 及 DECLINE 变体:分档的 EPS 同比变化(≥15% / ≥30%);与净利润相互独立,因为股份回购会放大 EPS 变动。CAPEX_INCREASE/STRONG_CAPEX_INCREASE 及 DECLINE 变体:分档的资本支出同比变化,以支出量级计(≥15% / ≥30%)。
值- M
A R G I N _ E X P A N S I O N - M
A R G I N _ C O N T R A C T I O N - G
U I D A N C E _ R A I S E D - G
U I D A N C E _ L O W E R E D - G
U I D A N C E _ R E A F F I R M E D
- details类型: object
特定于信号类型的结构化字段。内容因类型而异:指引信号包含
low、high、point_estimate、prior_value、revision_pct;分部信号包含best、worst、spread_pp;非 GAAP 信号包含gaap_field、non_gaap_value、gaap_value、divergence_pct;增长信号包含current、yoy_chg。null 值会被省略。请参考各类型的示例。- property类型: anything
Name
- metric类型: string | null
该信号引用的指标(如适用,例如
revenue、earnings_per_share、operating_margin,或指引/KPI 指标名称)。 - period类型: string | null
该信号引用的财年期间(例如
2026-Q1、FY 2026)。前瞻指引信号引用被指引的期间;财务信号引用该申报文件的报告期。
- 类型: stringnext
_page _url 下一页结果的绝对 URL。仅在还有更多结果时出现;按原样请求即可继续。每页最多 10 条记录。
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求,请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应;上游透传响应可能采用提供方格式
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"earnings": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"currency": "string",
"source_type": "8-K",
"filing_date": "2026-10-26",
"filing_datetime": null,
"filing_window": "PRE_MARKET",
"signals": [
{
"type": "MARGIN_EXPANSION",
"metric": null,
"period": null,
"headline": "string",
"details": {
"additionalProperty": "anything"
}
}
],
"filing_url": "https://example.com",
"accession_number": "string",
"quarterly": {
"revenue": null,
"revenue_chg": 1,
"revenue_yoy_chg": 1,
"earnings_per_share": null,
"earnings_per_share_chg": 1,
"earnings_per_share_yoy_chg": 1,
"gross_profit": null,
"gross_profit_chg": 1,
"gross_profit_yoy_chg": 1,
"gross_margin": 1,
"gross_margin_chg_bps": 1,
"gross_margin_chg_pct": 1,
"gross_margin_yoy_chg_bps": 1,
"gross_margin_yoy_chg_pct": 1,
"operating_income": null,
"operating_income_chg": 1,
"operating_income_yoy_chg": 1,
"operating_margin": 1,
"operating_margin_chg_bps": 1,
"operating_margin_chg_pct": 1,
"operating_margin_yoy_chg_bps": 1,
"operating_margin_yoy_chg_pct": 1,
"net_income": null,
"net_income_chg": 1,
"net_income_yoy_chg": 1,
"net_margin": 1,
"net_margin_chg_bps": 1,
"net_margin_chg_pct": 1,
"net_margin_yoy_chg_bps": 1,
"net_margin_yoy_chg_pct": 1,
"weighted_average_shares": null,
"weighted_average_shares_diluted": null,
"cash_and_equivalents": null,
"change_in_cash_and_equivalents": null,
"total_debt": null,
"total_assets": null,
"total_liabilities": null,
"shareholders_equity": null,
"net_cash_flow_from_operations": null,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_operations_yoy_chg": 1,
"net_cash_flow_from_investing": null,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_investing_yoy_chg": 1,
"net_cash_flow_from_financing": null,
"net_cash_flow_from_financing_chg": 1,
"net_cash_flow_from_financing_yoy_chg": 1,
"capital_expenditure": null,
"capital_expenditure_chg": 1,
"capital_expenditure_yoy_chg": 1,
"free_cash_flow": null,
"free_cash_flow_chg": 1,
"free_cash_flow_yoy_chg": 1
},
"annual": {
"revenue": null,
"revenue_chg": 1,
"revenue_yoy_chg": 1,
"earnings_per_share": null,
"earnings_per_share_chg": 1,
"earnings_per_share_yoy_chg": 1,
"gross_profit": null,
"gross_profit_chg": 1,
"gross_profit_yoy_chg": 1,
"gross_margin": 1,
"gross_margin_chg_bps": 1,
"gross_margin_chg_pct": 1,
"gross_margin_yoy_chg_bps": 1,
"gross_margin_yoy_chg_pct": 1,
"operating_income": null,
"operating_income_chg": 1,
"operating_income_yoy_chg": 1,
"operating_margin": 1,
"operating_margin_chg_bps": 1,
"operating_margin_chg_pct": 1,
"operating_margin_yoy_chg_bps": 1,
"operating_margin_yoy_chg_pct": 1,
"net_income": null,
"net_income_chg": 1,
"net_income_yoy_chg": 1,
"net_margin": 1,
"net_margin_chg_bps": 1,
"net_margin_chg_pct": 1,
"net_margin_yoy_chg_bps": 1,
"net_margin_yoy_chg_pct": 1,
"weighted_average_shares": null,
"weighted_average_shares_diluted": null,
"cash_and_equivalents": null,
"change_in_cash_and_equivalents": null,
"total_debt": null,
"total_assets": null,
"total_liabilities": null,
"shareholders_equity": null,
"net_cash_flow_from_operations": null,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_operations_yoy_chg": 1,
"net_cash_flow_from_investing": null,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_investing_yoy_chg": 1,
"net_cash_flow_from_financing": null,
"net_cash_flow_from_financing_chg": 1,
"net_cash_flow_from_financing_yoy_chg": 1,
"capital_expenditure": null,
"capital_expenditure_chg": 1,
"capital_expenditure_yoy_chg": 1,
"free_cash_flow": null,
"free_cash_flow_chg": 1,
"free_cash_flow_yoy_chg": 1
}
}
],
"next_page_url": "string"
}