ApiFinance AI logo
Dashboard Sign in

Ratios

Retrieve ratio history derived from the statement layer for quality, leverage, liquidity, and valuation analysis.

Endpoint

GET /statements/ratio
Test request
/statements/ratio?ticker=AAPL&start=2024&end=2024&timeframe=annual&limit=5

Create a free account to run these investor-grade stock endpoints with your own key. Create a free account to run the full workflow.

Send a request to view the response.

Query Parameters

  • ticker: required when cik is not provided
  • cik: optional SEC CIK
  • start: optional fiscal-year lower bound
  • end: optional fiscal-year upper bound
  • timeframe: optional annual, quarterly, or ttm
  • limit: optional row limit

Response

Typical fields include:

  • gross_margin
  • operating_margin
  • net_margin
  • roa
  • roe
  • roic
  • current_ratio
  • quick_ratio
  • debt_to_equity
  • interest_coverage

Example Request

curl -H "Authorization: Bearer $your_api_key" \
  "https://api.apifinance.ai/statements/ratio?ticker=AAPL&timeframe=annual&limit=5"

Next step

Run this endpoint with your own API key

Use the playground to inspect the response first, then create a key and move into implementation once the payload fits your product.

Get Free API KeyOpen playground

Cash Flow Statements

Retrieve cash flow statement history using ticker or CIK, timeframe, fiscal-year filters, and limit.

Growth

Retrieve growth history derived from reported statements for trend and acceleration analysis.