Overview
Our balances models are broadly classified the following:Type | Model Name | Description |
---|---|---|
Daily | <chain>.assets.fungible_balances_daily | Daily balance entry of address & tokens pairs balances. |
Latest | <chain>.assets.fungible_balances_latest | Latest balances of every address & tokens pairs balances. |
Granular | <chain>.assets.fungible_balances /balances | Granular block/transaction-level changes in the balances of assets & tokens pairs across wallets. |
Blockchain Coverage
We support balances data for the following blockchains:Blockchain | Balances Model |
---|---|
Bitcoin | The bitcoin.assets.balances contains Bitcoin balance-block changes in balances. Refer to here for more details. |
Solana | The solana.assets.balances contains Solana SOL and SPL token balances models. Refer to here for more details. |
Sui | The sui.raw.balance_changes Balance changes track the alterations in the amount of assets held by accounts, caused by transactions on Sui. Refer to here for more details. |
Tron | The tron.assets.fungible_balances contains TRX and TRC20 token balances models. Refer to here for more details. |
EVM-Compatible Blockchains | The crosschain.assets.fungible_balances_evm model offers a historical record of fungible asset balances, including native gas tokens and ERC-20 compatible tokens. |
EVM-Compatible Blockchains
We currently support fungible balances for the following evm-compatible blockchains:Blockchain | Network |
---|---|
arbitrum | Mainnet |
avalanche | Mainnet |
b3 | Mainnet |
base | Mainnet |
berachain | Mainnet |
blast | Mainnet |
bsc | Mainnet |
core | Mainnet |
ethereum | Mainnet |
hyperevm | Mainnet |
ink | Mainnet |
linea | Mainnet |
optimism | Mainnet |
plasma | Mainnet |
polygon | Mainnet |
scroll | Mainnet |
soneium | Mainnet |
unichain | Mainnet |
vana | Mainnet |
worldchain | Mainnet |
x_layer | Mainnet |
monad_testnet | Testnet |
Daily Balances
Use Cases:- Track the portfolio balance of wallet over time
- Track the number of holders of an asset over time
- Identify the distribution of assets across wallets over time
Sample Query: Number of USDC Holders holding >100 USDC daily
Sample Query: Portfolio balance of a wallet over time
Latest Balances
Use Cases:- Track the latest balance of a group of addresses across different blockchains
- Track the distribution of a particular token address currently
Sample Query: Portfolio balance of a wallet currently
Granular Balances
- In
fungible_balances
/balances
, balances model, each entry corresponds to a specific event/transaction that causes a balance change in a particular asset at the block level. - This means a new entry is only created when a transaction alters an asset’s balance at the block level.
- For example, if a wallet receives 1 ETH in 2015 and experiences no further changes until yesterday, the model will have two entries: one for the initial receipt in 2015 and another for the recent change
- Track granular, block-level changes of address and token address pairs whenever there are changes in the balance of assets