Balance Sheets

GET

financials

balance-sheets

Get balance sheets

curl --request GET \
  --url https://financialdatasets.rip/financials/balance-sheets \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/balance-sheets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/balance-sheets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://financialdatasets.rip/financials/balance-sheets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/balance-sheets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "balance_sheets": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "fiscal_period": "FY2025",
      "period": "annual",
      "total_assets": 359241000000,
      "current_assets": 147957000000,
      "cash_and_equivalents": 35934000000,
      "inventory": 5718000000,
      "trade_and_non_trade_receivables": 39777000000,
      "non_current_assets": 211284000000,
      "total_liabilities": 285508000000,
      "current_liabilities": 165631000000,
      "current_debt": 20329000000,
      "non_current_liabilities": 119877000000,
      "non_current_debt": 78328000000,
      "shareholders_equity": 73733000000,
      "retained_earnings": -14264000000
    }
  ]
}

This route returns one balance sheet row per reporting period: total assets, total liabilities, and shareholders’ equity, alongside their component lines, normalized to the Financial Datasets field names and order. It shares its provider chain and pagination shape with Income Statements: the same /equities/v1/statements fetch, joined against /equities/v1/filings for SEC identity.

What this answers

How a company’s total assets and shareholders’ equity have moved over recent periods.
How much cash, inventory, and receivables a company is carrying right now, or as of a past period.

Coverage


Provider chain	DefiLlama `/equities/v1/statements`, joined with `/equities/v1/filings`
Reporting periods	Annual, quarterly, and trailing-twelve-month (`ttm`)
Measured cost	$0.0012 per call (statement fetch plus the filings identity join)
Cache TTL	600 seconds, see Caching

Query rules

ticker is required. period accepts annual, quarterly, or ttm, and defaults to annual on this REST route, unlike the underlying MCP tool’s own ttm default. Pass period explicitly if the default matters. as_reported=true is accepted for parameter parity but always answers 400 bad_request. limit defaults to 4 and caps at 100. The report_period* family of filters narrows by report date, the same way it does on Income Statements. Fields the current Go source declares but our own live captures never populate: currency, accession_number, form_type, filing_url, filing_date, filing_datetime, current_investments, property_plant_and_equipment, goodwill_and_intangible_assets, investments, non_current_investments, outstanding_shares, tax_assets, trade_and_non_trade_payables, deferred_revenue, deposit_liabilities, tax_liabilities, accumulated_other_comprehensive_income, total_debt. These are schema-legal and left out of the response rather than guessed.

Worked example

curl

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

Response

{
  "balance_sheets": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "fiscal_period": "FY2025",
      "period": "annual",
      "total_assets": 359241000000,
      "current_assets": 147957000000,
      "cash_and_equivalents": 35934000000,
      "inventory": 5718000000,
      "trade_and_non_trade_receivables": 39777000000,
      "non_current_assets": 211284000000,
      "total_liabilities": 285508000000,
      "current_liabilities": 165631000000,
      "current_debt": 20329000000,
      "non_current_liabilities": 119877000000,
      "non_current_debt": 78328000000,
      "shareholders_equity": 73733000000,
      "retained_earnings": -14264000000
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

required

Uppercase-normalized ticker symbol (1-20 letters/digits/dots/hyphens).

period

enum<string>

default:annual

Reporting period. REST-level default is "annual"; the tool/FD-schema default is "ttm".

Available options:

annual,

quarterly,

ttm

limit

integer

default:4

Number of records to retrieve (default: 4, max: 100).

Required range: 1 <= x <= 100

as_reported

boolean

default:false

Accepted for FD parameter parity but always rejected: as_reported=true answers 400 bad_request ("as_reported is not supported; use the normalized balance-sheets endpoint") at zero cost.

report_period

string<date>

Exact report_period date filter (YYYY-MM-DD).

report_period_gte

string<date>

report_period >= this date (YYYY-MM-DD, inclusive).

report_period_lte

string<date>

report_period <= this date (YYYY-MM-DD, inclusive).

report_period_gt

string<date>

report_period > this date (YYYY-MM-DD, exclusive).

report_period_lt

string<date>

report_period < this date (YYYY-MM-DD, exclusive).

cursor

string

Opaque base64url pagination cursor from a previous response's next_page_url. Omit for the first page.

Response

A page of balance sheets, newest report_period first. Real AAPL FY2025 annual values captured from our own live API (docs/our-live-samples/balance_sheets.json).

Wrapped list envelope: {"balance_sheets": [...], "next_page_url": "..."}. Page size is 10 records (100 for /prices).

balance_sheets

BalanceSheet · object[]

required

Show child attributes

next_page_url

string<uri>

Absolute URL for the next page, present only when more records remain. Built from an opaque base64url cursor over this deployment's own host (never a fixed facade base).

Get balance sheets

curl --request GET \
  --url https://financialdatasets.rip/financials/balance-sheets \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/balance-sheets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/balance-sheets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://financialdatasets.rip/financials/balance-sheets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/balance-sheets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "balance_sheets": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-30",
      "fiscal_period": "FY2025",
      "period": "annual",
      "total_assets": 359241000000,
      "current_assets": 147957000000,
      "cash_and_equivalents": 35934000000,
      "inventory": 5718000000,
      "trade_and_non_trade_receivables": 39777000000,
      "non_current_assets": 211284000000,
      "total_liabilities": 285508000000,
      "current_liabilities": 165631000000,
      "current_debt": 20329000000,
      "non_current_liabilities": 119877000000,
      "non_current_debt": 78328000000,
      "shareholders_equity": 73733000000,
      "retained_earnings": -14264000000
    }
  ]
}

Overview

Integrations

Datasets

Guides

MCP Tools

What this answers

Coverage

Query rules

Worked example

Authorizations

Query Parameters

Response

​What this answers

​Coverage

​Query rules

​Worked example

Authorizations

Query Parameters

Response

What this answers

Coverage

Query rules

Worked example