Financial Data
Company fundamentals, financial statements, market prices and economic data.
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.
- 類型: stringticker必填
The ticker symbol.
- 類型: object · EarningsResponse200
Earnings response
- 類型: object · Earningsearnings
- annual類型: object · EarningsTimeDimension
- capital類型: number 可為 null
_expenditure - cash類型: number 可為 null
_and _equivalents - change類型: number 可為 null
_in _cash _and _equivalents - currency類型: string 可為 null
ISO currency code (e.g. USD).
- earnings類型: number 可為 null
_per _share - eps類型: string 列舉
_surprise EPS surprise classification versus estimate. Returned only when available.
值- B
E A T - M
I S S - M
E E T
- estimated類型: number
_earnings _per _share Estimated earnings per share. Returned only when available.
- estimated類型: number
_revenue Estimated revenue. Returned only when available.
- fiscal類型: string 可為 null
_period Fiscal period label (e.g. 2025-Q4 or 2025-FY).
- free類型: number 可為 null
_cash _flow - free類型: number
_cash _flow _chg Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- gross類型: number 可為 null
_profit - gross類型: number
_profit _chg Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _financing - net類型: number
_cash _flow _from _financing _chg Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _investing - net類型: number
_cash _flow _from _investing _chg Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _operations - net類型: number
_cash _flow _from _operations _chg Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_income - net類型: number
_income _chg Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- operating類型: number 可為 null
_income - operating類型: number
_income _chg Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- revenue類型: number 可為 null
- revenue類型: number
_chg Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- revenue類型: string 列舉
_surprise Revenue surprise classification versus estimate. Returned only when available.
值- B
E A T - M
I S S - M
E E T
- 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 可為 null
ISO currency code (e.g. USD).
- fiscal類型: string 可為 null
_period Fiscal period label (e.g. 2025-Q4 or 2025-FY).
- quarterly類型: object · EarningsTimeDimension
- capital類型: number 可為 null
_expenditure - cash類型: number 可為 null
_and _equivalents - change類型: number 可為 null
_in _cash _and _equivalents - currency類型: string 可為 null
ISO currency code (e.g. USD).
- earnings類型: number 可為 null
_per _share - eps類型: string 列舉
_surprise EPS surprise classification versus estimate. Returned only when available.
值- B
E A T - M
I S S - M
E E T
- estimated類型: number
_earnings _per _share Estimated earnings per share. Returned only when available.
- estimated類型: number
_revenue Estimated revenue. Returned only when available.
- fiscal類型: string 可為 null
_period Fiscal period label (e.g. 2025-Q4 or 2025-FY).
- free類型: number 可為 null
_cash _flow - free類型: number
_cash _flow _chg Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- gross類型: number 可為 null
_profit - gross類型: number
_profit _chg Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _financing - net類型: number
_cash _flow _from _financing _chg Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _investing - net類型: number
_cash _flow _from _investing _chg Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_cash _flow _from _operations - net類型: number
_cash _flow _from _operations _chg Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- net類型: number 可為 null
_income - net類型: number
_income _chg Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- operating類型: number 可為 null
_income - operating類型: number
_income _chg Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- revenue類型: number 可為 null
- revenue類型: number
_chg Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
- revenue類型: string 列舉
_surprise Revenue surprise classification versus estimate. Returned only when available.
值- B
E A T - M
I S S - M
E E T
- 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
- report類型: string 格式: date
_period Most recent report period found for the ticker.
- ticker類型: string
The requested ticker symbol.
application/json - 類型: object · ErrorResponse400
Bad request
- 類型: stringerror
A short error message.
- 類型: stringmessage
A more detailed error message.
application/json - 類型: object · ErrorResponse401
Unauthorized
- 類型: stringerror
A short error message.
- 類型: stringmessage
A more detailed error message.
application/json - 類型: object · ErrorResponse402
The request requires a paid subscription
- 類型: stringerror
A short error message.
- 類型: stringmessage
A more detailed error message.
application/json - 403
The account is not permitted to perform this operation.
- 類型: object · ErrorResponse404
The specified resource was not found
- 類型: stringerror
A short error message.
- 類型: stringmessage
A more detailed error message.
application/json - 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"earnings": {
"ticker": "string",
"report_period": "2026-09-30",
"fiscal_period": "string",
"currency": "string",
"quarterly": {
"fiscal_period": "string",
"currency": "string",
"revenue": 1,
"estimated_revenue": 1,
"revenue_surprise": "BEAT",
"earnings_per_share": 1,
"estimated_earnings_per_share": 1,
"eps_surprise": "BEAT",
"net_income": 1,
"gross_profit": 1,
"operating_income": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1,
"cash_and_equivalents": 1,
"total_debt": 1,
"total_assets": 1,
"total_liabilities": 1,
"shareholders_equity": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"net_cash_flow_from_investing": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"free_cash_flow": 1,
"revenue_chg": 1,
"net_income_chg": 1,
"operating_income_chg": 1,
"gross_profit_chg": 1,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_financing_chg": 1,
"free_cash_flow_chg": 1
},
"annual": {
"fiscal_period": "string",
"currency": "string",
"revenue": 1,
"estimated_revenue": 1,
"revenue_surprise": "BEAT",
"earnings_per_share": 1,
"estimated_earnings_per_share": 1,
"eps_surprise": "BEAT",
"net_income": 1,
"gross_profit": 1,
"operating_income": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1,
"cash_and_equivalents": 1,
"total_debt": 1,
"total_assets": 1,
"total_liabilities": 1,
"shareholders_equity": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"net_cash_flow_from_investing": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"free_cash_flow": 1,
"revenue_chg": 1,
"net_income_chg": 1,
"operating_income_chg": 1,
"gross_profit_chg": 1,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_financing_chg": 1,
"free_cash_flow_chg": 1
}
}
}