Daily metrics
Daily metrics; latest=1 for snapshot mode
GET
/openapi/v3/instruments/{ref}/metricsRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | Required | Instrument reference. A full_symbol such as AAPL.US or BTC-USDT-PERP.BINANCE is recommended; a stable id, symbol or FIGI also works |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| metric | string | Optional | Filter by a single metric code (comma-separated multi-values not supported). Omit = all |
| latest | boolean | Optional | 1 / true = snapshot mode: each metric returns its own most recent row (mutually exclusive with from / to) |
| from / to / limit | — | Optional | See Pagination (time-series mode only) |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/MSTR.US/metrics?latest=1" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.metrics[]: metric_code (String) / metric_date (String YYYY-MM-DD) / value (Number). meta.as_of = the max metric_date on the page.
Common Metric Codes
Full list and units: the metrics vocabulary.
| Category | Codes |
|---|---|
| Shares & market cap | market_cap · shares_outstanding · shares_float · weighted_shares_outstanding |
| Valuation | pe_ttm · pb · ps_ttm · forward_pe · eps_ttm · bvps |
| Dividends | dividend_share · dividend_yield |
| Risk | beta |
| Trading | volume_24h |
Notes
- For a detail page needing "latest values with all fields present", use
latest=1— this is not an optional optimization. Each metric's latest date can differ, and a descending time series withlimitwill push rarely-updated metrics out of the window — picking from the series yourself cannot guarantee field completeness. Use each row'smetric_dateto judge whether an individual field is stale. float_market_capandfdvare not metric codes — they are real-time snapshot fields that move with the price (see Unified Quote Snapshot).- Applicability: historical daily metrics are primarily available for equities and ETFs; coverage varies by market. Perpetual-futures funding is a current quote-snapshot field, not a historical metric series in this version. Although the metric dictionary lists
funding_rateandopen_interest, historical queries for them are not supported and return empty series.