Skip to main content

Total ERC-3643 Accounts

Total ERC-3643 Accounts represents the cumulative number of unique accounts holding at least one ERC-3643 (T-REX) permissioned security 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_erc3643_accounts

Methodology​

Qualifying Holders​

An account is counted when all of the following hold:

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

ERC-3643 extends ERC-20 with on-chain identity and transfer-eligibility rules for permissioned securities. Holders are derived from the current association set, the same approach used for the ERC-721 and ERC-1400 statistics.

Processing Logic​

  • First Association: An account holding several ERC-3643 tokens 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, producing a monotonically non-decreasing series.

Interpretation​

ERC-3643 adoption on Hedera is at a very early stage, so this statistic returns small counts. A low number reflects genuine on-chain adoption rather than a gap in indexer coverage.

As with the other association-derived ERC statistics, the series is built from current holders projected backwards by first-association time. It does not reconstruct the exact positive-balance set as it stood at each historical period, and accounts that have since disposed of their entire balance do not appear.

GraphQL API Examples​

Test out these queries using our developer playground.

Fetch current total ERC-3643 accounts (day)​

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

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

query TotalErc3643AccountsMonthly {
  ecosystem_metric(
    order_by: { end_date: desc_nulls_last }
    limit: 12
    where: { name: { _eq: "total_erc3643_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-3643 Accounts statistic outlined in this methodology.

SQL Function: ecosystem.total_erc3643_accounts

View GitHub Repository →

Dependencies​

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