Balances Latest

The balances latest table contains the latest balances of every type of token of any address. This includes Native Ether, ERC20, ERC721, and ERC1155 tokens.

For the value of the asset balances, there are two USD balance fields:

• usd_balance_current which reflects the current USD value of the asset.

• usd_balance_at_block_timestamp which reflects the USD value of the asset at the last transaction activity.

Sample Query

Finding the distribution of current ETH holdings amongst users who bought an NFT on OpenSea in the last 7 days.

select 
  case 
  when balance <= 1 then 'a. <1 MATIC'
  when balance > 1 and balance <= 100 then 'b. >1-100 MATIC'
  when balance > 100 and balance <= 1000 then 'c. >100-1k MATIC'
  when balance > 1000 and balance <= 10000 then 'd. >1k-10k MATIC'
  when balance > 10000 then 'e. >10k MATIC' end as matic_holdings,
  count(distinct address) as address_count
from 
  polygon.assets.balances_latest 
where 
  token_type = 'MATIC'
  and token_address = '0x0000000000000000000000000000000000000000'
  and address IN ( -- selecting address of Opensea buyers in the last 7 days 
    select 
      distinct buyer_address 
    from 
      polygon.nfts.trades 
    where 
      usd_price > 0 
      and current_date - date(block_timestamp) < 7
      and marketplace = 'opensea'
  )
group by matic_holdings
order by matic_holdings asc

Table Columns

Column Name	Description	Example
address	Address of the account.	0x66a84d487780c088d862971045d84b02d9b25aab
token_address	Address of the token. For Ether it is represented as nulll address.	0x0000000000000000000000000000000000000000
token_name	Name of the token.	ETH
token_symbol	Symbol of the token.	ETH
token_id	Token ID of a ERC721 token or ERC1155 token.
raw_balance	Raw balance amount of the token (not divided by the number of decimals)	216,765,847,229,634
raw_balance_str	Raw balance amount of the token (not divided by the number of decimals) in string.	216765847229634
balance	raw_balance divided by the number of decimals of this token. This value will be the same as raw_balance for erc721 and erc1155 tokens.	0.0002167658472
balance_str	Balance of token normalized and in string format.	0.0002167658472
usd_balance_current	USD balance of token at the current timestamp.	0.308804626
usd_balance_at_block_timestamp	USD balance of token at the timestamp of the last activity that resulted in balance change.	0.2800939895
usd_exchange_rate_current	USD exchange rate of token at the current timestamp.	1,424.60
usd_exchange_rate_at_block_timestamp	USD exchange rate of token at the timestamp of the last activity that resulted in balance update.	1,292.15
transaction_hash	The transaction hash that resulted in the balance update.	0xb2bf75bdb376ab2c59fdfed688355bc4b3b20d2e71d3ec6ff8e3a6b47f3894dc
last_activity_block_timestamp	The last timestamp of the block that that resulted in the balance update.	2022-12-05 03:58:11
last_activity_block_number	The last block number that resulted in the balance update.	16,116,061
last_activity_block_hash	The block hash of the last activity that resulted in this balance.	0x49ae37a2a5feb07d3f237dbfe4af59abb3b9ef19e3cd47ef083f1d7e45a2e616
_updated_at__usd_exchange_rate_current	Timestamp of the current USD exchange.	2023-03-10 22:00:00
unique_id	Unique ID of the balance.	block-16116061_address-0x66a84d487780c088d862971045d84b02d9b25aab_eth
_updated_at	Timestamp of the balance update.	2023-03-10 10:18:07