Historical
Get financial metrics for a ticker, including valuation, profitability, efficiency, liquidity, leverage, growth, and per share metrics.
π Overview
The historical financial metrics API provides historical financial metrics and ratios for a given stock ticker.
Financial metrics include a companyβs valuation, profitability, efficiency, liquidity, leverage, growth, and per share metrics over a specified period.
To get started, please create an account and grab your API key at financialdatasets.ai.
You will use the API key to authenticate your API requests.
π Available Tickers
You can fetch a list of available tickers with a GET
request to:
https://api.financialdatasets.ai/financial-metrics/tickers/
π Getting Started
There are only 3 steps for making a successful API call:
- Add your API key to the header of the request as
X-API-KEY
. - Add query params like
ticker
to filter the data. - Execute the API request.
π Filtering the Data
You can filter the data by ticker
, period
, limit
, and report_period
.
Note: ticker
and period
are required. By default, limit
is 4
and report_period
is null
.
The period
parameter can be set to annual
, quarterly
, or ttm
(trailing twelve months). The limit
parameter is used to specify the number of periods to return.
The report_period
parameter is used to specify the date of the financial metrics. For example, you can include filters like report_period_lte=2024-09-30
and report_period_gte=2024-01-01
to get financial metrics between January 1, 2024 and September 30, 2024.
The available report_period
operations are:
report_period_lte
report_period_lt
report_period_gte
report_period_gt
report_period
π» Example
π» Example (with report_period)
Authorizations
API key for authentication.
Query Parameters
The ticker symbol of the company.
The time period for the financial data.
annual
, quarterly
, ttm
The maximum number of results to return.
Response
Revenue divided by average total assets.
Year-over-year growth in book value.
Shareholders' equity divided by shares outstanding.
Cash and cash equivalents divided by current liabilities.
Current assets divided by current liabilities.
Average accounts receivable divided by revenue over the period.
Total debt divided by total assets.
Total debt divided by shareholders' equity.
Year-over-year growth in earnings.
Net income divided by weighted average shares outstanding.
Growth in earnings per share over the period.
Growth in EBITDA over the period.
The total value of the company (market cap + debt - cash).
Enterprise value to EBITDA ratio.
Enterprise value to revenue ratio.
Growth in free cash flow over the period.
Free cash flow divided by shares outstanding.
Free cash flow yield.
Gross profit as a percentage of revenue.
EBIT divided by interest expense.
Cost of goods sold divided by average inventory.
The market capitalization of the company.
Net income as a percentage of revenue.
Operating cash flow divided by current liabilities.
Inventory turnover + receivables turnover.
Growth in operating income over the period.
Operating income as a percentage of revenue.
Dividends paid as a percentage of net income.
Price to earnings growth ratio.
Price to book ratio.
Price to earnings ratio.
Price to sales ratio.
Quick assets divided by current liabilities.
Revenue divided by average accounts receivable.
Net income as a percentage of total assets.
Net income as a percentage of shareholders' equity.
Net operating profit after taxes as a percentage of invested capital.
Year-over-year growth in revenue.
The ticker symbol of the company.
Revenue divided by average working capital.