post
https://api.bavest.co/v1/stock/metrics
The Stock Metrics API provides key financial and performance metrics for individual stocks. Each metric includes a value, validity flag, and supporting metadata. Version v1 introduces safer calculations and handles cases where metric denominators are near zero, preventing unstable results like NaN or Infinity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | YES | The stock ticker symbol (e.g., AAPL) |
Response
| Field | Type | Description |
|---|---|---|
date | string | Date for which metrics are returned |
metrics | array[object] | List of metric objects |
Metric Object
| Field | Type | Description |
|---|---|---|
metric_id | string | Unique identifier for the metric (e.g., wrapper_10y_return) |
value | number or null | Calculated metric value. null indicates an invalid calculation (e.g., division by near-zero) |
valid | boolean | Indicates whether the value is safe and accurate |
reason | string or null | Optional explanation if valid is false |
root_cause | string or null | Optional root cause of invalid metrics |
description | string | Human-readable description of the metric |
unit | string | Unit of the metric (e.g., NUMERIC) |
currency | string or null | Currency of the metric if applicable (e.g., USD) |