Circulation

    Definition

    Circulation shows number of unique coins/tokens being used during a time period.

    Examples:

    • circulation_1d - Shows how many unique coins/tokens were transacted during a day. If one token/coin changes hands 5 times on a given day, it will be counted once by the token circulation, but 5 times by the transaction volume.
    • circulation_1y - Shows how many unique coins/tokens were transacted for the past 1 year.

    There are also circulation metrics circulation_usd_* that represent the USD value of all unique coins or tokens that were transacted within a single day. Unlike simple circulation metrics that count the unique cryptocurrencies moved, circulation_usd_* metrics convert the quantity of these coins or tokens into their equivalent value in USD.

    circulation for bitcoin


    Access

    Restricted Access


    Measuring Unit

    Token/Coin amount


    Data Type

    Timeseries Data


    Timebound

    Timebound Metrics


    Change Metrics

    Change Metrics


    Frequency

    Daily Intervals


    Latency

    On-Chain Latency


    Available Assets

    Available for these assets

    Note: circulation metric and all circulation metrics are available for the same set of assets.


    SanAPI

    Available under the circulation and circulation_<timebound> names.

    Gets the total amount of tokens that have been sent at least once during each day for given time period. Projects are referred to by a unique identifier (slug). This metric is calculated daily, so the interval should be selected accordingly.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {
      getMetric(metric: "circulation_1d") {
        timeseriesData(
          slug: "santiment"
          from: "2020-01-01T00:00:00Z"
          to: "2020-01-07T00:00:00Z"
          interval: "1d"
        ) {
          datetime
          value
        }
      }
    }

    Run in Explorer

    Without any suffixes like _1d, the metric returns the number of coins/tokens ever seen up until now, which is equal to the total supply at that datetime.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {
      getMetric(metric: "circulation") {
        timeseriesData(
          slug: "santiment"
          from: "2020-01-01T00:00:00Z"
          to: "2020-01-07T00:00:00Z"
          interval: "1d"
        ) {
          datetime
          value
        }
      }
    }

    Run in Explorer

    Full list of metrics

    The full list of Circulation metrics is:

    Open Metrics List

    • circulation
    • circulation_10y
    • circulation_180d
    • circulation_1d
    • circulation_2y
    • circulation_30d
    • circulation_365d
    • circulation_3y
    • circulation_5y
    • circulation_60d
    • circulation_7d
    • circulation_90d
    • circulation_change_1d
    • circulation_change_30d
    • circulation_change_7d
    • circulation_180d_change_1d
    • circulation_180d_change_30d
    • circulation_180d_change_7d
    • circulation_usd_180d
    • circulation_usd_180d_change_1d
    • circulation_usd_180d_change_30d
    • circulation_usd_180d_change_7d