apiverve / financialratios

1.2.5 2026-11-09 18:06 UTC

Requires

• php: >=7.4
• guzzlehttp/guzzle: ^7.0

Requires (Dev)

• phpunit/phpunit: ^9.0

MIT

• APIVerve

• api
• apiverve
• financialratios
• financial ratios api
• ratio analysis api
• profitability ratios api
• liquidity ratios api
• leverage ratios api

Published on Packagist.org on 2026-11-09 21:29 UTC

README

Financial Ratios returns the key profitability, liquidity, leverage, efficiency and cash-flow ratios for a US public company by ticker - margins, ROE, ROA, current ratio, debt-to-equity, interest coverage, asset turnover, FCF margin and more - all computed from SEC filing data. On paid plans, valuation=true adds market cap, P/E, P/S, P/B and earnings yield against the latest stored share price.

The Financial Ratios API provides a simple, reliable way to integrate financial ratios functionality into your applications. Built for developers who need production-ready financial ratios capabilities without the complexity of building from scratch.

View API Details →

Available on:

Quick Start

Using JavaScript

async function callFinancialRatiosAPI() {
    try {
        const params = new URLSearchParams({
            ticker: 'AAPL',
            valuation: true
        });

        const response = await fetch(`https://api.apiverve.com/v1/financialratios?${params}`, {
            method: 'GET',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE'
            }
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callFinancialRatiosAPI();

Using cURL

curl -X GET "https://api.apiverve.com/v1/financialratios?ticker=AAPL&valuation=true" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Get your API key: https://apiverve.com

📁 For more examples, see the examples folder

Installation

Choose your preferred programming language:

📦 NPM (JavaScript/Node.js)

npm install @apiverve/financialratios

View NPM Package → | Package Code →

🔷 NuGet (.NET/C#)

dotnet add package APIVerve.API.FinancialRatios

View NuGet Package → | Package Code →

🐍 Python (PyPI)

pip install apiverve-financialratios

View PyPI Package → | Package Code →

💎 Ruby (RubyGems)

gem install apiverve_financialratios

View RubyGems Package → | Package Code →

🐘 PHP (Packagist)

composer require apiverve/financialratios

View Packagist Package → | Package Code →

🎯 Dart (pub.dev)

dart pub add apiverve_financialratios

View pub.dev Package → | Package Code →

🤖 Android (JitPack)

implementation 'com.github.apiverve:financialratios-api:1.0.0'

Package Code →

🐹 Go

go get github.com/apiverve/financialratios-api/go

Package Code →

Why Use This API?

Feature	Benefit
Multi-language SDKs	Native packages for JavaScript, Python, C#, Go, and Android
Simple Integration	Single API key authentication, consistent response format
Production Ready	99.9% uptime SLA, served from 24 global regions
Comprehensive Docs	Full examples, OpenAPI spec, and dedicated support

Documentation

• 🏠 API Home: Financial Ratios API
• 📚 API Reference: docs.apiverve.com/ref/financialratios
• 📖 OpenAPI Spec: openapi.yaml
• 💡 Examples: examples/

What Can You Build?

The Financial Ratios API is commonly used for:

• Web Applications - Add financial ratios features to your frontend or backend
• Mobile Apps - Native SDKs for Android development
• Automation - Integrate with n8n, Zapier, or custom workflows
• SaaS Products - Enhance your product with financial ratios capabilities
• Data Pipelines - Process and analyze data at scale

API Reference

Authentication

All requests require an API key in the header:

x-api-key: YOUR_API_KEY_HERE

Get your API key: https://apiverve.com

Response Format

Every APIVerve endpoint returns the same envelope — check status, then read data:

{
  "status": "ok",
  "error": null,
  "data": { ... }
}

Example Response

A real response from the Financial Ratios API:

{
  "status": "ok",
  "error": null,
  "data": {
    "ticker": "COST",
    "company": "COSTCO WHOLESALE CORP /NEW",
    "cik": "0000909832",
    "fiscalYear": 2026,
    "fiscalQuarter": 4,
    "filingType": "10-K",
    "filingDate": "2026-10-07",
    "periodEnd": "2026-08-30",
    "profitability": {
      "grossMargin": null,
      "operatingMargin": 3.85,
      "netMargin": 3.04,
      "returnOnEquity": 25.77,
      "returnOnAssets": 10.36
    },
    "liquidity": {
      "currentRatio": 1.06,
      "quickRatio": 0.62,
      "cashRatio": 0.46
    },
    "leverage": {
      "debtToEquity": 1.49,
      "debtToAssets": 0.6,
      "equityMultiplier": 2.49,
      "interestCoverage": 80.59
    },
    "efficiency": {
      "assetTurnover": 3.4,
      "inventoryTurnover": 13.68,
      "receivablesTurnover": null
    },
    "cashFlow": {
      "freeCashFlow": 9382000000,
      "fcfMargin": 3.09,
      "operatingCashFlowMargin": 5.22,
      "capexToRevenue": 2.12
    },
    "perShare": {
      "eps": 20.76,
      "bookValuePerShare": 80.5599,
      "freeCashFlowPerShare": 21.1103
    },
    "valuation": {
      "priceAsOf": "2026-11-05T21:00:00.000Z",
      "marketCap": 473576966930,
      "priceToEarnings": 51.33,
      "earningsYield": 1.95,
      "priceToSales": 1.56,
      "priceToBook": 13.23,
      "trailingEps": 20.76,
      "trailingRevenue": 303154000000,
      "trailingNetIncome": 9226000000,
      "trailingBasis": "annual"
    }
  }
}

Support & Community

• 🏠 API Home: Financial Ratios API
• 💬 Support: https://apiverve.com/contact
• 🐛 Issues: GitHub Issues
• 📖 Documentation: https://docs.apiverve.com
• 🌐 Website: https://apiverve.com

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Security

For security concerns, please review our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Built with ❤️ by APIVerve

Copyright © 2026 APIVerve. All rights reserved.