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.
Request
- Base URL: https://api.tapetide.com
- URL: https://api.tapetide.com/v1/stocks/{symbol}/fundamentals
- Auth: HTTP bearer
Path parameters
Stock symbol, e.g. "RELIANCE". Percent-encode "&" (M%26M).
Query parameters
Comma-separated metric names (see GET /v1/fundamentals/metrics). Default: all.
quarter or annual. Default: both.
Statement basis. preferred = consolidated when the company publishes consolidated annual statements (as of as_of), otherwise standalone.
Earliest period end (inclusive). Default: 10 years before to.
Latest period end (inclusive). Default: as_of.
Only values public on or before this date (inclusive). Default: today.
Sort direction by date.
Items per page (default 200, max 1000). Values over the max are rejected, never clamped.
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.