Felo API PlatformFelo API Platform

数据 API / Financial Data / Earnings

Get earnings snapshot

Reported earnings for one stock, actuals against estimates. Each entry carries report_period, fiscal_period, filing_date, filing_url and accession_number, a quarterly block with revenue, estimated_revenue, revenue_surprise and revenue_surprise_pct, the same trio for earnings_per_share, plus year-over-year change fields. It also returns signals: upstream-computed flags such as EPS_BEAT with a headline and the actual / estimate / surprise_pct behind it. ticker is required and it is the only parameter. Use it for what a company actually reported. For forward-looking consensus that has not happened yet use get_financial_analyst_estimates.

参数

查询

  • tickerstring必填

    The ticker symbol.

请求示例

curl -G "https://openapi.felo.ai/v1/beta/financial/earnings" \
  --data-urlencode "ticker=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

响应

响应字段

  • earningsobject可选
  • tickerstring可选

    The requested ticker symbol.

  • report_periodstring可选

    Most recent report period found for the ticker.

  • fiscal_period可选

    Fiscal period label (e.g. 2025-Q4 or 2025-FY).

  • currency可选

    ISO currency code (e.g. USD).

  • quarterlyobject可选
  • fiscal_period可选

    Fiscal period label (e.g. 2025-Q4 or 2025-FY).

  • currency可选

    ISO currency code (e.g. USD).

  • revenue可选
  • estimated_revenuenumber可选

    Estimated revenue. Returned only when available.

  • revenue_surprisestring可选

    允许值： BEAT · MISS · MEET

    Revenue surprise classification versus estimate. Returned only when available.

  • earnings_per_share可选
  • estimated_earnings_per_sharenumber可选

    Estimated earnings per share. Returned only when available.

  • eps_surprisestring可选

    允许值： BEAT · MISS · MEET

    EPS surprise classification versus estimate. Returned only when available.

  • net_income可选
  • gross_profit可选
  • operating_income可选
  • weighted_average_shares可选
  • weighted_average_shares_diluted可选
  • cash_and_equivalents可选
  • total_debt可选
  • total_assets可选
  • total_liabilities可选
  • shareholders_equity可选
  • net_cash_flow_from_operations可选
  • capital_expenditure可选
  • net_cash_flow_from_investing可选
  • net_cash_flow_from_financing可选
  • change_in_cash_and_equivalents可选
  • free_cash_flow可选
  • revenue_chgnumber可选

    Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_income_chgnumber可选

    Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • operating_income_chgnumber可选

    Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • gross_profit_chgnumber可选

    Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_operations_chgnumber可选

    Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_investing_chgnumber可选

    Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_financing_chgnumber可选

    Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • free_cash_flow_chgnumber可选

    Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • annualobject可选
  • fiscal_period可选

    Fiscal period label (e.g. 2025-Q4 or 2025-FY).

  • currency可选

    ISO currency code (e.g. USD).

  • revenue可选
  • estimated_revenuenumber可选

    Estimated revenue. Returned only when available.

  • revenue_surprisestring可选

    允许值： BEAT · MISS · MEET

    Revenue surprise classification versus estimate. Returned only when available.

  • earnings_per_share可选
  • estimated_earnings_per_sharenumber可选

    Estimated earnings per share. Returned only when available.

  • eps_surprisestring可选

    允许值： BEAT · MISS · MEET

    EPS surprise classification versus estimate. Returned only when available.

  • net_income可选
  • gross_profit可选
  • operating_income可选
  • weighted_average_shares可选
  • weighted_average_shares_diluted可选
  • cash_and_equivalents可选
  • total_debt可选
  • total_assets可选
  • total_liabilities可选
  • shareholders_equity可选
  • net_cash_flow_from_operations可选
  • capital_expenditure可选
  • net_cash_flow_from_investing可选
  • net_cash_flow_from_financing可选
  • change_in_cash_and_equivalents可选
  • free_cash_flow可选
  • revenue_chgnumber可选

    Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_income_chgnumber可选

    Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • operating_income_chgnumber可选

    Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • gross_profit_chgnumber可选

    Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_operations_chgnumber可选

    Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_investing_chgnumber可选

    Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • net_cash_flow_from_financing_chgnumber可选

    Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.

  • free_cash_flow_chgnumber可选

    Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.