Fetch Metrics
Fetch one or more metrics for one or more assets over a date range.
Metric names are comma-separated in the path and case-insensitive. Symbols are comma-separated in the query and may mix crypto with eq--prefixed equities in a single request.
Response shape
series_columns describes each tuple in data, and it changes with summarize:
- Default:
["timestamp","value"], wheretimestampis epoch milliseconds (UTC). - With
summarize=true:["label","value"], wherelabelis the asset’s display name.
Reading the results correctly
- A metric that isn’t available returns a string in place of the array:
"Metric not available for asset."(unsupported for that asset) or"Latest data not available for this asset."(supported, no recent data). Type-check before iterating. - The current period is usually present with a
nullvalue because it hasn’t closed. - Every requested symbol is returned. A symbol with no data for the request arrives with an error string in place of the array.
summarize=trueadditionally returns a<METRIC>_PCT_CHGseries for each metric.
Authorizations
Path Parameters
Comma-separated, case-insensitive metric names.
Query Parameters
Comma-separated asset symbols. May mix crypto symbols with eq--prefixed equities in a single request.
Start date in YYYY-MM-DD format.
End date in YYYY-MM-DD format.
Rolls the daily series up to weeks, months, quarters, or years, according to each metric's aggregation_type. Two labelling conventions apply: ordinary time series (on-chain, stablecoin, equity PRICE) are labelled by period start, while equity fundamentals such as TOTAL_REVENUE follow the company's fiscal calendar, are labelled by period end, and snap to fiscal periods regardless of the granularity requested.
DAY, WEEK, MONTH, QUARTER, YEAR When true, returns the endDate day's value for each metric rather than the full series, plus a <METRIC>_PCT_CHG series giving the percent change from the startDate value to the endDate value. The range acts as a comparison window rather than an aggregation window. Use granularity for a period roll-up.
Splits a series by chain, protocol version, or market category. The values each metric supports are listed under cuts[] on List Supported Metrics.
CHAIN, VERSION, CATEGORY, TOKEN, TOKEN_TYPE, SYMBOL 