Skip to main content

Total ERC-721 Accounts

Total ERC-721 Accounts represents the cumulative number of unique accounts holding at least one ERC-721 token with a positive balance, as of the end of each period.

Hedera Data Access

To access this Hedera network statistic (and others) via Hgraph's GraphQL & REST APIs, create a free account at app.hgraph.com.

Hedera Stat Name: total_erc721_accounts

Methodology​

Qualifying Holders​

An account is counted when all of the following hold:

  • Contract Type: The associated token is classified as ERC-721 by the indexer (contract_type = 'ERC_721').
  • Positive Balance: The association carries a balance greater than zero.
  • Association Timestamp Present: The association has a non-null created_timestamp.

Holders are derived from token associations rather than transfer events. ERC-721 transfers are not populated in the indexer's transfer table, so the current association set is the only complete source of ownership.

Processing Logic​

  • First Association: An account may hold several ERC-721 tokens. It is counted once, anchored to the earliest created_timestamp among the associations it currently holds.
  • Baseline: Accounts whose first association predates start_timestamp are counted as a single baseline figure.
  • Per-Period Additions: Accounts whose first association falls inside the window are grouped by the period containing it.
  • Rolling Total: Each period's value is the baseline plus the running sum of new accounts up to and including that period, producing a monotonically non-decreasing series.

Interpretation​

This metric is built from current associations, projected backwards onto the timeline by first-association time. Two consequences follow:

  • An account that once held an ERC-721 token and has since disposed of all of them does not appear in any period, including historical ones.
  • The series is monotonic by construction rather than by measurement, so it does not reconstruct the exact positive-balance set as it stood at each historical period.

The most recent value is an accurate count of current holders. Earlier periods should be read as "of today's holders, how many had associated by then."

GraphQL API Examples​

Test out these queries using our developer playground.

Fetch current total ERC-721 accounts (day)​

query TotalErc721AccountsDay {
  ecosystem_metric(
    order_by: { end_date: desc_nulls_last }
    limit: 1
    where: { name: { _eq: "total_erc721_accounts" }, period: { _eq: "day" } }
  ) {
    total
    end_date
  }
}

Fetch monthly total ERC-721 accounts for 1 year (timeseries)​

query TotalErc721AccountsMonthly {
  ecosystem_metric(
    order_by: { end_date: desc_nulls_last }
    limit: 12
    where: { name: { _eq: "total_erc721_accounts" }, period: { _eq: "month" } }
  ) {
    total
    end_date
  }
}

Available Time Periods​

The period field supports the following values:

  • day
  • week
  • month
  • quarter
  • year

SQL Implementation​

Below is a link to the Hedera Stats GitHub repository. The repo contains the SQL function that calculates the Total ERC-721 Accounts statistic outlined in this methodology.

SQL Function: ecosystem.total_erc721_accounts

View GitHub Repository →

Dependencies​

  • Hedera mirror node
  • ERC token indexer (erc.token_account, erc.token)