API Reference

Metric History

get
https://api.bavest.co/v2/equities/metrics/history

Returns one statement-derived metric (ratios, margins, growth and every *_ttm name) as a series of points, one per fiscal period end, newest first. Suppressed periods are returned as explicit null points with a reason instead of being omitted, so point counts stay stable for mirrors; see the Metric History guide for basis, vintage and TTM-overlap semantics.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Stock ticker symbol (e.g., AAPL, MSFT, GOOGL). Provide exactly one of symbol or isin.

string
length between 12 and 12
^[A-Z]{2}[A-Z0-9]{9}[0-9]$

ISIN code (e.g., US0378331005). Provide exactly one of symbol or isin.

string
required

Metric name. Discover valid names via GET /equities/metrics/names.

string
enum

Reporting basis. Defaults to TTM for *_ttm names, FY otherwise.

string
enum
Defaults to MR

MR = most recent restated statements. AR / as_of point-in-time replay is not yet enabled.

Allowed:
date

Earliest period end (inclusive).

date

Latest period end (inclusive).

boolean
Defaults to false

When true, each point carries a provenance block (knownAt, restated, and the vendor's acceptedDate/filingDate claim). Empty while ledger coverage has not begun for the security.

Responses

Updated 6 days ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 days ago

Did this page help you?