Change Metrics

    Definition

    The metrics with the suffix _change_<interval> indicate the percent value change at the given time compared to interval time ago. This allows the percent changes to be fetched historically and to be plotted on charts.

    Change metrics' names are formed from the original metric name and a change suffix. Available change intervals and their suffixes are:

    • _change_1h - 1 hour. Available only for USD price
    • _change_1d - 1 day
    • _change_7d - 7 days
    • _change_30d - 30 days

    Note: Change metrics are also available for some of the Timebound Metrics. In such cases, both suffixes are appended, and their order is important. In all cases, the order is timebound suffix, followed by change suffix.

    Units

    The metric units are numbers where 0 corresponds to 0% change, 1 corresponds to 100% change. Negative values indicate decrease. These values cannot be aggregated using SUM. The default aggregation is LAST.

    Examples

    price_usd_change_1d

    This metric represents the 24h price percent change.

    circulation_180d_change_1d

    This metric represents the 24h percent change of the circulation_180d timebound metric

    API examples

    Get timeseries data of a change metric

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {
      getMetric(metric: "price_usd_change_1d") {
        timeseriesData(
          slug: "bitcoin"
          from: "utc_now-7d"
          to: "utc_now"
          interval: "1d"
        ) {
          datetime
          value
        }
      }
    }

    Run in Explorer

    Get aggregated value for multiple assets

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    {
      # The default aggregation is LAST. The last known value, but
      # no older than 6 hours, is returned for every asset
      allProjects(page: 1, pageSize: 20){
        slug
        priceChange24h: aggregatedTimeseriesData(
          metric: "price_usd_change_1d"
          from: "utc_now-6h"
          to: "utc_now")
        tradingVolumeChange24h: aggregatedTimeseriesData(
          metric: "volume_usd_change_1d"
          from: "utc_now-6h"
          to: "utc_now")
      }
    }

    Run in Explorer