fundamentals

Point-in-time fundamentals

Financial statement metrics as a tidy series: one row per metric and fiscal period. Quarterly results from 2002 and annual statements from 1999 where the company reported them; updated as results are declared. Every row carries available_from, the date the value became public. Pass as_of to see only what was public on that date, with the value as it was then (before any later restatement) — the backtest-safe view. Where more than one reading exists for the same metric and period, a populated value is preferred over an empty one, then a non-zero value over a 0 (one dataset rounds to whole crore, so small figures can read 0 there), then the primary dataset over the secondary, then the most recently published reading on or before as_of. A reported 0 that means "not reported" is not published as a value: periods where total assets, total liabilities or share capital read 0 are omitted, and revenue reading 0 while the same period shows non-zero operating expenses is published as value: null. Defaults to the last 10 years of periods. Rows are ordered by period end (oldest first by default; order=desc for newest first), then in a fixed metric order.

get/v1/stocks/{symbol}/fundamentals

Request

  • Base URL: https://api.tapetide.com
  • URL: https://api.tapetide.com/v1/stocks/{symbol}/fundamentals
  • Auth: HTTP bearer

Path parameters

symbolstring required

Stock symbol, e.g. "RELIANCE". Percent-encode "&" (M%26M).

Query parameters

metricsstring[]

Comma-separated metric names (see GET /v1/fundamentals/metrics). Default: all.

period_type'quarter' | 'annual'

quarter or annual. Default: both.

basis'preferred' | 'consolidated' | 'standalone'

Statement basis. preferred = consolidated when the company publishes consolidated annual statements (as of as_of), otherwise standalone.

fromstring

Earliest period end (inclusive). Default: 10 years before to.

tostring

Latest period end (inclusive). Default: as_of.

as_ofstring

Only values public on or before this date (inclusive). Default: today.

order'asc' | 'desc'

Sort direction by date.

limitinteger

Items per page (default 200, max 1000). Values over the max are rejected, never clamped.

cursorstring

Opaque cursor from meta.next_cursor of the previous page.

Response

OK. Costs one request unit.

Example response

{
  "data": [
    {
      "metric": "revenue",
      "period_type": "annual",
      "period_end": "2025-03-31",
      "basis": "consolidated",
      "value": 255324,
      "unit": "inr_crore",
      "available_from": "2025-04-10",
      "available_from_estimated": false
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.