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
}
}
}