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.

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: