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

circulation for bitcoin


Access

Restricted Access


Timebound

Timebound Metrics


Measuring Unit

Token/Coin amount


Data Type

Timeseries Data


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

Was this article helpful?