Financial Ratios API

Overview

To use Financial Ratios, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/financialratios

Example

How to call the Financial Ratios API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/financialratios?ticker=AAPL&year=2025&quarter=4" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/financialratios?ticker=AAPL&year=2025&quarter=4', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/financialratios?ticker=AAPL&year=2025&quarter=4', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/financialratios?ticker=AAPL&year=2025&quarter=4", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "ticker": "AAPL",
    "company": "Apple Inc.",
    "cik": "0000320193",
    "fiscalYear": 2025,
    "fiscalQuarter": 4,
    "filingType": "10-K",
    "filingDate": "2025-10-31",
    "periodEnd": "2025-09-27",
    "profitability": {
      "grossMargin": 46.91,
      "operatingMargin": 31.97,
      "netMargin": 26.92,
      "returnOnEquity": 151.91,
      "returnOnAssets": 31.18
    },
    "liquidity": {
      "currentRatio": 0.89,
      "quickRatio": 0.86,
      "cashRatio": 0.22
    },
    "leverage": {
      "debtToEquity": 3.87,
      "debtToAssets": 0.79,
      "equityMultiplier": 4.87,
      "interestCoverage": null
    },
    "efficiency": {
      "assetTurnover": 1.16,
      "inventoryTurnover": 38.64,
      "receivablesTurnover": 10.46
    },
    "cashFlow": {
      "freeCashFlow": 98767000000,
      "fcfMargin": 23.73,
      "operatingCashFlowMargin": 26.79,
      "capexToRevenue": 3.06
    },
    "perShare": {
      "eps": 7.46,
      "bookValuePerShare": 4.914,
      "freeCashFlowPerShare": 6.5824
    }
  }
}

Authentication

The Financial Ratios API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Financial Ratios API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the Financial Ratios API:

Response

The Financial Ratios API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <ticker>AAPL</ticker>
    <company>Apple Inc.</company>
    <cik>0000320193</cik>
    <fiscalYear>2025</fiscalYear>
    <fiscalQuarter>4</fiscalQuarter>
    <filingType>10-K</filingType>
    <filingDate>2025-10-31</filingDate>
    <periodEnd>2025-09-27</periodEnd>
    <profitability>
      <grossMargin>46.91</grossMargin>
      <operatingMargin>31.97</operatingMargin>
      <netMargin>26.92</netMargin>
      <returnOnEquity>151.91</returnOnEquity>
      <returnOnAssets>31.18</returnOnAssets>
    </profitability>
    <liquidity>
      <currentRatio>0.89</currentRatio>
      <quickRatio>0.86</quickRatio>
      <cashRatio>0.22</cashRatio>
    </liquidity>
    <leverage>
      <debtToEquity>3.87</debtToEquity>
      <debtToAssets>0.79</debtToAssets>
      <equityMultiplier>4.87</equityMultiplier>
      <interestCoverage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
    </leverage>
    <efficiency>
      <assetTurnover>1.16</assetTurnover>
      <inventoryTurnover>38.64</inventoryTurnover>
      <receivablesTurnover>10.46</receivablesTurnover>
    </efficiency>
    <cashFlow>
      <freeCashFlow>98767000000</freeCashFlow>
      <fcfMargin>23.73</fcfMargin>
      <operatingCashFlowMargin>26.79</operatingCashFlowMargin>
      <capexToRevenue>3.06</capexToRevenue>
    </cashFlow>
    <perShare>
      <eps>7.46</eps>
      <bookValuePerShare>4.914</bookValuePerShare>
      <freeCashFlowPerShare>6.5824</freeCashFlowPerShare>
    </perShare>
  </data>
</response>

status: ok
error: null
data:
  ticker: AAPL
  company: Apple Inc.
  cik: '0000320193'
  fiscalYear: 2025
  fiscalQuarter: 4
  filingType: 10-K
  filingDate: '2025-10-31'
  periodEnd: '2025-09-27'
  profitability:
    grossMargin: 46.91
    operatingMargin: 31.97
    netMargin: 26.92
    returnOnEquity: 151.91
    returnOnAssets: 31.18
  liquidity:
    currentRatio: 0.89
    quickRatio: 0.86
    cashRatio: 0.22
  leverage:
    debtToEquity: 3.87
    debtToAssets: 0.79
    equityMultiplier: 4.87
    interestCoverage: null
  efficiency:
    assetTurnover: 1.16
    inventoryTurnover: 38.64
    receivablesTurnover: 10.46
  cashFlow:
    freeCashFlow: 98767000000
    fcfMargin: 23.73
    operatingCashFlowMargin: 26.79
    capexToRevenue: 3.06
  perShare:
    eps: 7.46
    bookValuePerShare: 4.914
    freeCashFlowPerShare: 6.5824

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Financial Ratios through GraphQL to combine it with other API calls in a single request. Query only the financial ratios data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  financialratios(
    input: {
      ticker: "AAPL"
      year: 2025
      quarter: 4
    }
  ) {
    ticker
    company
    cik
    fiscalYear
    fiscalQuarter
    filingType
    filingDate
    periodEnd
    profitability {
      grossMargin
      operatingMargin
      netMargin
      returnOnEquity
      returnOnAssets
    }
    liquidity {
      currentRatio
      quickRatio
      cashRatio
    }
    leverage {
      debtToEquity
      debtToAssets
      equityMultiplier
      interestCoverage
    }
    efficiency {
      assetTurnover
      inventoryTurnover
      receivablesTurnover
    }
    cashFlow {
      freeCashFlow
      fcfMargin
      operatingCashFlowMargin
      capexToRevenue
    }
    perShare {
      eps
      bookValuePerShare
      freeCashFlowPerShare
    }
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Financial Ratios API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Financial Ratios requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Financial Ratios API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Financial Ratios

Official Financial Ratios packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Financial Ratios works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Financial Ratios, you might also like these APIs:

Balance Sheet

Balance Sheet returns the statement of financial position for a US public company by ticker - assets, liabilities and shareholders' equity - straight from SEC filings, with liquidity and leverage ratios like current ratio, quick ratio and debt-to-equity calculated for you.

1 credit per call

Benchmark Rate

Benchmark Rate is a tool for retrieving current risk-free reference rates that replaced LIBOR. It returns rates for SOFR (US), SONIA (UK), ESTR (EU), TONA (Japan), and SARON (Switzerland).

1 credit per call

BIN Lookup

BIN Lookup is a simple tool for looking up BIN number information. It returns information such as the bank, card type, and more based on the BIN number provided.

5 credits per call