Comprehensive Metrics

get

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

Returns comprehensive per-metric financial data with validity flags, descriptions, and units. Supports optional currency conversion. Results are paginated (default 50 metrics per page, max 200).

Query Params

symbol

string

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

isin

string

length between 12 and 12

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

currency

string

Target currency for monetary values (ISO 4217). Converts from reporting currency if different.

fields

string

Comma-separated list of fields to include in the response. When provided, only the specified fields are returned. Reduces payload size for high-volume endpoints.

limit

int32

1 to 200

Defaults to 50

Maximum number of metrics to return per page (default 50, max 200)

offset

int32

≥ 0

Defaults to 0

Number of metrics to skip for pagination (default 0)

cursor

string

Opaque cursor for cursor-based pagination. When provided, returns results after the cursor position. Takes precedence over offset.

Headers

string

enum

Defaults to application/json

Response content type. Only application/json is supported.

Allowed:

Responses

Language

Credentials

Header

URL

Request

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).

401Missing or invalid API key.

404Resource not found.

429Rate limit exceeded. Retry after the Retry-After header interval.

500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.

502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.

504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.

defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.