GET
/
financial-metrics
/
snapshot

​
👋 Overview

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

Any data that you receive from our API is yours to keep. You may save the data to minimize repeat API calls.

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
headerrequired

API key for authentication.

Query Parameters

ticker
string
required

The ticker symbol of the company.

Response

200 - application/json
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).

pe_ratio
number

Price to earnings ratio.

pb_ratio
number

Price to book ratio.

ps_ratio
number

Price to sales ratio.

ev_ebitda_ratio
number

Enterprise value to EBITDA ratio.

ev_revenue_ratio
number

Enterprise value to revenue 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.

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.

debt_to_equity
number

Total debt divided by shareholders' equity.

debt_to_assets
number

Total debt divided by total assets.

interest_coverage
number

Operating income 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.

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.

FactsIncome Statements