ETF Metrics

get

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

Returns a paginated list of all ETF metrics — performance, risk, volatility, and fund characteristics — with full lineage/traceability.

Metric groups:

Returns: 1M, 3M, YTD, 1Y, 3Y, 5Y, 10Y
Risk (security & category): beta, alpha, sharpe ratio, treynor ratio, R-squared, standard deviation, mean annual return (1Y/3Y/5Y/10Y)
Volatility: YTD, 1Y, 3Y, 5Y, 10Y
Risk indicators: SRI (price-based, 1-7), SRRI (document-based, 1-7)
Fund: tracking error, net management fee

Pass trace=true to include computation lineage (formula, inputs, explanation) for each metric.

Query Params

symbol

string

ETF ticker symbol (e.g., ARKK, SPY, QQQ). Provide exactly one of symbol or isin.

isin

string

length between 12 and 12

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

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 1000

Defaults to 100

Maximum number of results to return (default 100, max 1000)

offset

int32

≥ 0

Defaults to 0

Number of results 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.

trace

boolean

Defaults to false

Include computation lineage (formula, inputs, explanation) for each metric

Headers

string

enum

Defaults to application/json

Response content type. Only application/json is supported.

Allowed:

Responses

Language

Credentials

Header

URL

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.