Financials
Balance sheet
GET/api/v2/balance-sheets
- Coverage
- US / CN / JP, the last 3 years
- Billing
- 20 cr / thousand calls
Returns a company's balance sheet: assets, liabilities, shareholders' equity and their line items, one row per reporting period as of period end. 41 line-item columns in total, plus the 14 meta-data fields shared by the three statements, all listed under Response fields; period_start is always null. total_debt / net_debt are derived columns (not as-reported lines); all other columns are as-reported values.
The example shows the complete key set; a line item that is missing or cannot be calculated reliably appears as null in the actual response.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | required | Up to 10 tickers, comma-separated. |
| period | stringenum | optional | FY (full fiscal year, excluding TTM), Q1, Q2, Q3, Q4 (the four quarters of the company’s fiscal year); multiple values allowed, comma-separated. Only periods with data are returned; no matching data returns an empty array. Default: FY. |
| limit | int | optional | Number of periods per ticker, counting back from the most recent period; maximum 40. Default: 4. |
Response fields
| Field | Type | Description |
|---|---|---|
| ticker | string | Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T) |
| market | stringenum | Market code: US / CN / JP |
| fiscal_year | int | Fiscal year |
| period | stringenum | FY / Q1 / Q2 / Q3 / Q4 |
| period_start | date | Period start date; null for /balance-sheets |
| report_period | date | Period end date |
| currency | string | Reporting currency |
| accounting_standard | stringenum | US-GAAP / IFRS / CN-GAAP / JP-GAAP |
| accession_number | string | Native document number from the official source: US is the SEC accession (e.g. 0000320193-25-000123), JP the EDINET docID, CN the cninfo announcement id |
| form_type | string | Type of the source filing, in the market's native encoding (US: SEC form names such as 10-K / 10-Q; JP: EDINET numeric codes; CN: annual_report and the like) |
| filing_url | string | Deep link to the official filing; opens the source document directly |
| filing_date | date | Filing date: the date the document became public on the official channel |
| derived_fields | string[] | Names of fields calculated from other periods or line items, or normalized for sign; [] when none |
| derivation | object | Calculation trees keyed by the names in derived_fields; {} when none. Each step includes operation, metric, value, currency, period_start, report_period, and available_at; calculated nodes list recursive inputs in operation order, while reported leaves include the four official provenance fields; cross-report calculations also include basis (the basis report’s four official provenance fields and available_at) |
| cash_and_cash_equivalents | number | Monetary funds / cash and cash equivalents |
| short_term_investments | number | Short-term investments / financial assets held for trading |
| accounts_receivable | number | Accounts receivable (net) |
| inventories | number | Inventories |
| prepaid_expenses | number | Prepayments |
| other_current_assets | number | Other current assets |
| current_assets | number | Total current assets |
| property_plant_equipment | number | Property, plant and equipment, net |
| right_of_use_assets | number | Right-of-use assets, net (operating and finance leases combined; null when a required component is missing) |
| goodwill | number | Goodwill |
| intangible_assets | number | Intangible assets |
| long_term_investments | number | Long-term investments (including long-term equity investments) |
| deferred_tax_assets | number | Deferred tax assets |
| other_non_current_assets | number | Other non-current assets |
| non_current_assets | number | Total non-current assets |
| total_assets | number | Total assets |
| accounts_payable | number | Accounts payable |
| short_term_debt | number | Short-term borrowings. When the source explicitly combines short-term debt and long-term debt due within one year, the entire line is recorded here and current_portion_of_long_term_debt is null; total_debt does not count that component twice |
| current_portion_of_long_term_debt | number | Non-current liabilities due within one year / current maturities |
| employee_compensation_payable | number | Employee compensation payable |
| income_taxes_payable | number | Income taxes payable |
| accrued_liabilities | number | Accrued liabilities |
| deferred_revenue | number | Contract liabilities / deferred revenue (current portion only) |
| other_current_liabilities | number | Other current liabilities |
| current_liabilities | number | Total current liabilities |
| long_term_debt | number | Long-term borrowings / bonds payable |
| lease_liabilities | number | Present value of lease liabilities (current and non-current, operating and finance leases combined; null when a required component is missing) |
| deferred_tax_liabilities | number | Deferred tax liabilities |
| other_non_current_liabilities | number | Other non-current liabilities |
| non_current_liabilities | number | Total non-current liabilities |
| total_liabilities | number | Total liabilities |
| common_stock | number | Share capital |
| additional_paid_in_capital | number | Capital reserve |
| retained_earnings | number | Retained earnings / undistributed profits (CN includes the surplus reserve) |
| treasury_stock | number | Treasury stock (negative) |
| accumulated_other_comprehensive_income | number | Accumulated other comprehensive income |
| equity_attributable_to_parent | number | Equity attributable to owners of the parent; null when a required component is missing. Unknown noncontrolling interests are not treated as zero. |
| noncontrolling_interests | number | Noncontrolling interests |
| total_equity | number | Total equity |
| temporary_equity | number | null | Temporary / mezzanine equity: redeemable preferred stock, redeemable noncontrolling interests and similar items presented between liabilities and equity. Returned only when it exactly closes the gap of total assets − total liabilities − total equity; otherwise null |
| total_debt | number | Derived (not an as-reported line) = short_term_debt + current_portion_of_long_term_debt + long_term_debt. A confirmed combined current-debt line already includes current maturities, which are not added again; any other missing required component makes the result null, rather than zero-filled |
| net_debt | number | Derived (not an as-reported line) = total_debt - cash_and_cash_equivalents - short_term_investments. Returns null if any required component is missing; the result can be negative |
No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.
Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.