Balances - Token Terminal Docs

One row per holder of one stablecoin deployment, computed at query time from the transfer history by functions.calculate_latest_token_balances and functions.calculate_historical_eod_token_balances. balance is the holder’s amount in whole token units, and each call takes a chain, a token address and a token standard from Registry.

Columns

Column	Type	Description
`balance_date`	`DATE`	Day the balance moved. Returned by `calculate_historical_eod_token_balances`, which writes a row per day an account’s balance changed.
`account_address`	`STRING`	Account holding the balance. On Solana this is the token account; `dimensions.accounts` resolves the wallet behind it.
`balance`	`BIGNUMERIC`	End-of-day balance in whole token units, already scaled down by `decimals`. `calculate_latest_token_balances` returns the last one per account, positive balances only.

Sample queries

Current holders
Concentration on a date

Each call adds up the whole balance-change history of one deployment; a daily holder count is cheaper read from metrics_assets.holders_native_daily on Metrics. Addresses are lowercased on input, so a checksummed address pasted from an explorer resolves.

select
    account_address,
    balance
from `functions.calculate_latest_token_balances`(
    'ethereum',
    '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
    'erc20'
)
order by balance desc
limit 100

The historical function writes a row only on a day the balance moved. An account’s balance on a given date is its most recent row at or before that date.

with balances_on_date as (
    select
        account_address,
        balance,
        row_number() over (partition by account_address order by balance_date desc) as recency
    from `functions.calculate_historical_eod_token_balances`(
        'ethereum',
        '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
        'erc20'
    )
    where balance_date <= date '2026-06-30'
),

holders as (
    select
        balance,
        rank() over (order by balance desc) as balance_rank
    from balances_on_date
    where recency = 1
      and balance > 0
)

select
    count(*) as holders,
    sum(balance) as supply,
    sum(case when balance_rank <= 10 then balance end) / sum(balance) as top_10_share
from holders