How to Get Fundamentals

This walkthrough pulls a company’s income statement, balance sheet, cash flow statement, and current valuation metrics for one ticker. Four calls, one ticker, no pagination needed at these limits.

1. Income statement

curl

curl -s 'https://financialdatasets.rip/financials/income-statements?ticker=AAPL&period=annual&limit=1' \
  -H 'X-API-KEY: <your-api-key>'

Response, trimmed

{
  "income_statements": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "fiscal_period": "FY2025",
      "period": "annual",
      "revenue": 416161000000,
      "gross_profit": 195201000000,
      "operating_income": 133050000000,
      "net_income": 112010000000,
      "earnings_per_share": 7.49,
      "earnings_per_share_diluted": 7.46
    }
  ]
}

Measured cost: $0.0012.

2. Balance sheet

curl

curl -s 'https://financialdatasets.rip/financials/balance-sheets?ticker=AAPL&period=annual&limit=1' \
  -H 'X-API-KEY: <your-api-key>'

Response, trimmed

{
  "balance_sheets": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "total_assets": 359241000000,
      "total_liabilities": 285508000000,
      "shareholders_equity": 73733000000
    }
  ]
}

Measured cost: $0.0012.

3. Cash flow statement

curl

curl -s 'https://financialdatasets.rip/financials/cash-flow-statements?ticker=AAPL&period=annual&limit=1' \
  -H 'X-API-KEY: <your-api-key>'

Response, trimmed

{
  "cash_flow_statements": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "net_cash_flow_from_operations": 111482000000,
      "free_cash_flow": 98767000000
    }
  ]
}

Measured cost: $0.0012.

4. Current valuation

The three statements above cover filed history. They carry no live market price, so enterprise_value and every price_to_* ratio are left out on purpose. Pull the snapshot route for those.

curl

curl -s 'https://financialdatasets.rip/financial-metrics/snapshot?ticker=AAPL' \
  -H 'X-API-KEY: <your-api-key>'

Response, trimmed

{
  "snapshot": {
    "ticker": "AAPL",
    "market_cap": 4674544794120,
    "price_to_earnings_ratio": 36.26,
    "gross_margin": 0.4865291555900202,
    "operating_margin": 0.3317,
    "net_margin": 0.27618604910212224
  }
}

Measured cost: $0.0006.

Total

Four calls, $0.0042 combined at these measured costs. Each response caches independently for 600 seconds on the statement routes and 60 seconds on the snapshot, see Caching, so repeating this sequence for the same ticker inside those windows costs nothing on the cached calls. See Income Statements, Balance Sheets, Cash Flow Statements, and Financial Metrics Snapshot for the full field list and query rules behind each call.

Overview

Integrations

Datasets

Guides

MCP Tools

1. Income statement

2. Balance sheet

3. Cash flow statement

4. Current valuation

Total

​1. Income statement

​2. Balance sheet

​3. Cash flow statement

​4. Current valuation

​Total

1. Income statement

2. Balance sheet

3. Cash flow statement

4. Current valuation

Total