Financial Ratios API
Receive an API key immediately and have access to the financial ratios data right away
Ratios and Indicators API - Features
The Financial Ratios API provides complete numerical data of the financial ratios of companies. The API returns ratios data in decimal values as an output that has been calculated by standard formulas in which figures from company financial statements (balance sheets, income statements and cash flow statements) are plugged in.
Ratios for Fundamental Analysis
The financial ratios and values the API provides are essential for carrying out a fundamental comprehensive quantitative analysis on companies, which can serve as a key element revealing to you whether a company is managing well financially and whether it is eligible to invest in.
Based on SEC Financial Statements
The Financial Ratios API connects to our database where financial ratio data is collected, stored and maintained as directly being reported to the SEC, and updated as new financial statements are disclosed by companies. Therefore, you always receive data on financial ratios based on the latest official figures in the financial reports, so that you are able to make correct investment decisions.
Indicator Data Accessible Through API
The complete set of calculated financial ratios data is accessible through the Financial Ratios API that returns data in the format of your choice. The Financial Ratios API directly returns calculated values. However, you could also use the Balance Sheet API, Income Statement API and Cash Flow Statement API separately to view the uncalculated values stated in these reports.
Compare Multiple Companies and Historical Data
By integrating Finnworlds Financial Ratios API, you can enter the stock ticker symbol of the company you are interested in and receive its financial ratio values based on the latest figures the company has reported. It is also possible to get figures on multiple companies via one endpoint and determine the type of financial ratio that you want to display. You should use the year and quarter filters for past values and view the changes in the financial ratios over the years. Mix and match parameters to receive straightforward data and build platforms for your clients on which they can examine both historical and current financial ratios data.
Code Examples for the Income Statement API
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"currentRatio": "1.3636044481554577"
"quickRatio": "1.2181949294064065"
"cashRatio": "0.36071049035979963"
"daysOfSalesOutstanding": "49.78753437881355"
"daysOfInventoryOutstanding": "8.741883356235881"
"operatingCycle": "58.52941773504943"
"daysOfPayablesOutstanding": "91.04818971567418"
"cashConversionCycle": "-32.518771980624756"
"grossProfitMargin": "0.38233247727810865"
"operatingProfitMargin": "0.24147314354406862"
"pretaxProfitMargin": "0.24439830246070343"
"netProfitMargin": "0.20913611278072236"
"effectiveTaxRate":" 0.14428164731484103"
"returnOnAssets": "0.1772557180259843"
"returnOnEquity": "0.8786635853012749"
"returnOnCapitalEmployed": "0.3033831282952548"
"netIncomePerEBT": "0.855718352685159"
"ebtPerEbit": "1.0121138064204682"
"ebitPerRevenue": "0.24147314354406862"
"debtRatio": "0.7982666847799239"
"debtEquityRatio": "3.957039440456695"
"longTermDebtToCapitalization": "0.6016060388034584"
"totalDebtToCapitalization": "0.6324623822247223"
"interestCoverage": "23.07274625826662"
"cashFlowToDebtRatio": "0.7175104059198122"
"companyEquityMultiplier": "4.957039440456695"
"receivablesTurnover": "7.331152356789959"
"payablesTurnover": "4.008866086627577"
"inventoryTurnover": "41.75301649839941"
"fixedAssetTurnover": "7.466545177609748"
"assetTurnover": "0.8475615027416885"
"operatingCashFlowPerShare": "4.649230448454163"
"freeCashFlowPerShare": "4.2280138811865"
}
[
}
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl,msft,dell
&financial-ratio=current_ratio,quick_ratio,cash_ratio
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.3636044481554577"
"quick_ratio": "1.2181949294064065"
"cash_ratio": "0.36071049035979963"
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.8155457736360444"
"quick_ratio": "1.2940640652181949"
"cash_ratio": "0.49035979963360710"
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.4815545773636044"
"quick_ratio": "1.2940640218194965"
"cash_ratio": "0.35979963360710490"
},
}
[
}
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl,msft,dell
&financial-ratio=current_ratio,quick_ratio,cash_ratio
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.3636044481554577"
"quick_ratio": "1.2181949294064065"
"cash_ratio": "0.36071049035979963"
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.8155457736360444"
"quick_ratio": "1.2940640652181949"
"cash_ratio": "0.49035979963360710"
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.4815545773636044"
"quick_ratio": "1.2940640218194965"
"cash_ratio": "0.35979963360710490"
},
}
[
}
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| financial_ratio | If you want to highlight specific components of the cash flow (operating cash flow, investing cash flow, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
Financial Ratio Database of All Companies
Finnworlds financial ratio database was created to collect and maintain financial ratio data of all companies on all exchange platforms including the largest ones such as NYSE, NASDAQ, TSE, SSE, Euronext, HKSE, LSE, Shenzhen and Toronto. Thanks to its big coverage, the API offers an opportunity to build platforms that address an equally wide range of investors and clients.
Financial Ratios Calculations
Financial ratios are automatically calculated in the Financial Ratios Database. The figures used for the calculations are received directly from the company reports. They are used for calculations in our system and delivered as data via the API response.
Downloadable Financial Ratio and Indicator Data
The financial ratio and indicator data is provided through a REST API that returns data in a JSON format. You can also request downloadable financial ratio data as well. Receive the complete data in the format of your choice such as PDF, Excel, CSV, via email, download link and more. In this way, you could display and work on the financial data in the format you like for an easier analysis and experience.
Historical and Current Financial Ratios Data
Historical and real-time financial ratio data is provided via a single API that you may access anytime. In this way, you can review the changes in the figures over time, ratio by ratio, and compare these to the historical and current industry averages to analyze the company performance over the years. Determining a company’s near-future performance relies on examining both historical and current financial ratios data, which makes the API a convenient tool for transferring both data types.
Financial Ratios Included In the API
The Financial Ratios API returns detailed data that covers all financial ratio types such as liquidity, leverage, efficiency, profitability and market values. The full list consists of cover current ratio, quick ratio, cash ratio, days of sales outstanding, days of inventory outstanding, operating cycle, days of payables outstanding, cash conversion cycle, gross profit margin, operating profit margin, pretax profit margin, net profit margin, effective tax rate, return on assets, return on equity, return on capital employed, net income per EBT, EBT per EBIT, EBIT per revenue, debt ratio, debt equity ratio, long-term debt to capitalization, total debt to capitalization, interest coverage, cash flow to debt ratio, company equity multiplier, receivables turnover, payables turnover, inventory turnover, fixed asset turnover, asset turnover, operating cash flow per share, free cash flow per share.
Please, contact us in case that you notice any ratio types that are missing from the list and we will add these right away. All values are shown in decimal format by using standard formulas. It is possible to get data only on the ratios you are interested in without having to receive them altogether and find them among a large response file.
Formats to Download the Data
The financial ratios data is accessible in three main formats. In this way, Finnworlds fully addresses your needs for data delivery formats. Request your data format and get financial ratios data instantly. No matter the format of your choice, you obtain financial ratios data without any differences in the data transfer time. Please, contact support@finnworlds.com for notifying which data format you prefer. You can always change the data delivery format.
Developer Notes
The Financial Ratios API connects to Finnworlds database and retrieves from it the data that you have filtered to meet your needs. The data is stored, maintained and updated in our database and presented both historically starting from the IPO of the companies and updated with each new financial statement a company reports. The API was created to address the needs of developers, businesses, analysts and hobbyists with all levels of experience. You can use it with any of the leading software development kits and all major programming and scripting languages.
Filtering
The API endpoints are user-friendly when it comes to setting data filters. You may get complete financial ratios of individual or multiple companies in one endpoint. Furthermore, you may even get a specific (or multiple different) type of financial ratio of all companies within a given sector such as “Technology”, “Industry”, “Consumer Electronics”, etc. It is possible to use multiple filters in one endpoint to mix and match so that you get precise data that you can use to increase the efficiency of your products as well.
SDKs and Devkits
REST JSON and XML
Excel and CSV
Financial Ratios API – Get Started!
Get access to the Financial Ratios API is simply with the API key automatically sent to your email address after signing up in a few easy steps. Once you receive the API key, no further authorization is required and you can start making API calls to get data immediately. Start testing the data with trial rate advantages. Upgrade or cancel your plan anytime depending on how your tests go. For any further questions, feel free to contact support.
Control the Data
/financialratios&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT
stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT