GET
/
financial-metrics
/
snapshot
curl --request GET \
  --url https://api.financialdatasets.ai/financial-metrics/snapshot \
  --header 'X-API-KEY: <api-key>'
{
  "ticker": "<string>",
  "market_cap": 123,
  "enterprise_value": 123,
  "price_to_earnings_ratio": 123,
  "price_to_book_ratio": 123,
  "price_to_sales_ratio": 123,
  "enterprise_value_to_ebitda_ratio": 123,
  "enterprise_value_to_revenue_ratio": 123,
  "free_cash_flow_yield": 123,
  "peg_ratio": 123,
  "gross_margin": 123,
  "operating_margin": 123,
  "net_margin": 123,
  "return_on_equity": 123,
  "return_on_assets": 123,
  "return_on_invested_capital": 123,
  "asset_turnover": 123,
  "inventory_turnover": 123,
  "receivables_turnover": 123,
  "days_sales_outstanding": 123,
  "operating_cycle": 123,
  "working_capital_turnover": 123,
  "current_ratio": 123,
  "quick_ratio": 123,
  "cash_ratio": 123,
  "operating_cash_flow_ratio": 123,
  "debt_to_equity": 123,
  "debt_to_assets": 123,
  "interest_coverage": 123,
  "revenue_growth": 123,
  "earnings_growth": 123,
  "book_value_growth": 123,
  "earnings_per_share_growth": 123,
  "free_cash_flow_growth": 123,
  "operating_income_growth": 123,
  "ebitda_growth": 123,
  "payout_ratio": 123,
  "earnings_per_share": 123,
  "book_value_per_share": 123,
  "free_cash_flow_per_share": 123
}

​
👋 Overview

We have real-time financial metrics for all actively-traded equities in the US.

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.

​
🚀 Getting Started

There are only 3 steps for making a successful API call:

  1. Add your API key to the header of the request as X-API-KEY.
  2. Add query params like ticker to filter the data.
  3. Execute the API request.

Note: You must provide the ticker.

​
💻 Example

Financial Metrics Snapshot
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'

# create the URL
url = (
    f'https://api.financialdatasets.ai/financial-metrics/snapshot'
    f'?ticker={ticker}'
)

# make API request
response = requests.get(url, headers=headers)

# parse snapshot from the response
snapshot = response.json().get('snapshot')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string
required

The ticker symbol of the company.

Response

200
application/json
The current financial metrics snapshot for a ticker
​
ticker
string

The ticker symbol of the company.

​
market_cap
number

The market capitalization of the company.

​
enterprise_value
number

The total value of the company (market cap + debt - cash).

​
price_to_earnings_ratio
number

Price to earnings ratio.

​
price_to_book_ratio
number

Price to book ratio.

​
price_to_sales_ratio
number

Price to sales ratio.

​
enterprise_value_to_ebitda_ratio
number

Enterprise value to EBITDA ratio.

​
enterprise_value_to_revenue_ratio
number

Enterprise value to revenue ratio.

​
free_cash_flow_yield
number

Free cash flow yield.

​
peg_ratio
number

Price to earnings growth ratio.

​
gross_margin
number

Gross profit as a percentage of revenue.

​
operating_margin
number

Operating income as a percentage of revenue.

​
net_margin
number

Net income as a percentage of revenue.

​
return_on_equity
number

Net income as a percentage of shareholders' equity.

​
return_on_assets
number

Net income as a percentage of total assets.

​
return_on_invested_capital
number

Net operating profit after taxes as a percentage of invested capital.

​
asset_turnover
number

Revenue divided by average total assets.

​
inventory_turnover
number

Cost of goods sold divided by average inventory.

​
receivables_turnover
number

Revenue divided by average accounts receivable.

​
days_sales_outstanding
number

Average accounts receivable divided by revenue over the period.

​
operating_cycle
number

Inventory turnover + receivables turnover.

​
working_capital_turnover
number

Revenue divided by average working capital.

​
current_ratio
number

Current assets divided by current liabilities.

​
quick_ratio
number

Quick assets divided by current liabilities.

​
cash_ratio
number

Cash and cash equivalents divided by current liabilities.

​
operating_cash_flow_ratio
number

Operating cash flow divided by current liabilities.

​
debt_to_equity
number

Total debt divided by shareholders' equity.

​
debt_to_assets
number

Total debt divided by total assets.

​
interest_coverage
number

EBIT divided by interest expense.

​
revenue_growth
number

Year-over-year growth in revenue.

​
earnings_growth
number

Year-over-year growth in earnings.

​
book_value_growth
number

Year-over-year growth in book value.

​
earnings_per_share_growth
number

Growth in earnings per share over the period.

​
free_cash_flow_growth
number

Growth in free cash flow over the period.

​
operating_income_growth
number

Growth in operating income over the period.

​
ebitda_growth
number

Growth in EBITDA over the period.

​
payout_ratio
number

Dividends paid as a percentage of net income.

​
earnings_per_share
number

Net income divided by weighted average shares outstanding.

​
book_value_per_share
number

Shareholders' equity divided by shares outstanding.

​
free_cash_flow_per_share
number

Free cash flow divided by shares outstanding.