Financial Ratios API - Finnworlds

The Financial Ratios API delivers a set of standardized financial ratios for public companies. The financial ratio data in a single API call allows developers to retrieve profitability, liquidity, efficiency, valuation, and leverage ratios data along with other key metrics such as free cash flow, enterprise value ratios, and market performance indicators.

Utilize the financial ratio data for portfolio analysis, screening, benchmarking, quantitative research, and corporate financial monitoring. It allows you to integrate pre-calculated financial ratios directly into applications, dashboards, or data pipelines.

Common Use Cases

– Screening stocks based on valuation, profitability, and leverage ratios
– Benchmarking companies against peers in the same sector or industry
– Risk analysis using Altman Z-score, interest coverage, and debt ratios
– Portfolio analytics with free cash flow, operating margin, and P/E metrics

API Features

• Profitability Ratios – Gross margin, EBIT margin, operating margin, net profit margin, pretax margin
• Liquidity Ratios – Current ratio, quick ratio, cash per share
• Leverage Ratios – Debt/Equity, debt/EBITDA, debt/FCF, interest coverage
• Efficiency Ratios – Asset turnover, inventory turnover, revenue per employee, profit per employee
• Valuation Ratios – P/E, forward P/E, PEG, EV/EBIT, EV/EBITDA, P/B, P/FCF, P/S, P/TBV
• Other Metrics – Altman Z-score, Piotroski F-score, insider ownership, institutional ownership, shareholder yield, market averages

Access today by getting an API key on the Finnworlds website.
For academic or non-profit use, contact support to start the conversation.

How to Access the Data

• JSON REST API
• Excel CSV download
• PDF reports
• Email link

Documentation

Full documentation is available at product documentation, including parameter definitions, output objects, and SDK support for Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Rust, Swift, and Scala.

Examples

https://api.finnworlds.com/api/v1/financialratios?key=APIKEY&ticker=AAPL

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "company": "Apple Inc.",
            "ticker": "AAPL",
            "isin": "US0378331005"
        },
        "output": {
            "altman_z_score": "10",
            "asset_turnover_ratio": "1.232",
            "Average Volume (20 Days)": "63849257",
            "book_value_per_share": "4.431",
            "buyback_yield": "0.02681",
            "current_ratio": "0.868",
            "debt_ebitda_ratio": "0.645717",
            "debt_equity_ratio": "1.545",
            "debt_fcf_ratio": "1.057",
            "dividend_per_share": "1.040",
            "dividend_yield": "0.00449",
            "earnings_yield": "0.0288866",
            "ebit_margin": "0.31866",
            "ebitda_margin": "0.34676",
            "employees": "164000",
            "enterprise_value": "3405597920100",
            "eps": "6.573",
            "Equity (Book Value)": "65830000000",
            "ev_earnings_ratio": "34.30",
            "ev_ebit_ratio": "26.15385",
            "ev_ebitda_ratio": "24.03454",
            "ev_fcf_ratio": "35.40711",
            "evsales_ratio": "8.33429",
            "fcf_margin": "0.23538",
            "fcf_per_share": "6.481",
            "fcf_yield": "0.0279858",
            "gross_margin": "0.46678",
            "insider_owned_rate": "0.00065",
            "interest_coverage_ratio": "60.056",
            "inventory_turnover_ratio": "36.044",
            "Last Close Price": "231.59",
            "Market Cap Growth": "-0.07009",
            "market_capitalization": "3436885920100",
            "moving_average_200day": "221.051",
            "moving_average_50day": "209.587",
            "net_cash_per_share": "2.108",
            "operating_margin": "0.31866",
            "owned_by_institutions_percent": "0.62758",
            "P/TBV Ratio": "52.20851",
            "payout_ratio": "0.1551709",
            "pb_ratio": "52.26597",
            "pe_forward_ratio": "30.470",
            "pe_ratio": "35.2313924652984",
            "peg_ratio": "2.91738",
            "pfcf_ratio": "35.73241",
            "piotroski_f_score": "7",
            "pocf_ratio": "31.6574",
            "pretax_margin": "0.317",
            "profit_margin": "0.24296",
            "profit_per_employee": "605366",
            "ps_ratio": "8.523",
            "quick_ratio": "0.724",
            "relative_strength_index": "70.783",
            "Return on Capital Employed (ROCE)": "0.684",
            "return_on_assets": "0.24546",
            "return_on_equity": "1.49814",
            "return_on_invested_capital": "0.48509",
            "revenue_per_employee": "2491616",
            "share_float": "14814318282",
            "shareholder_yield": "0.0313",
            "shares_change_qoq": "-0.00717",
            "shares_change_yoy": "-0.02681",
            "shares_outstanding": "14840390000",
            "short_interest_amount": "104634941",
            "short_percentage_float": "0.00706",
            "short_percentage_shares": "0.00705",
            "short_ratio": "2.050",
            "tax_rate_effective": "0.23357",
            "date": "2025-08-18"
        }
    }
}

Customer Support

Need help, have questions? Get in touch with Support.

Legal

Use of the Finnworlds website, services like API and database are subject to the Finnworlds Terms & Conditions.