Fungible Balances

The fungible balances table contains historical native token (e.g. ETH, MATIC, AVAX) and ERC20 tokens the balance of all addresses, at block height that has a balance change for the particularly address.

Sample Query

Query wallet Balance of a wallet by token address.

PSQL

select * from base.assets_fungible_balances 
where address = '0xb5a0bb236466fdb3282d0dff3eb7e4fb33b53f13'
and token_address = '0x0000000000000000000000000000000000000000' -- ETH

API (cURL)

curl 'https://api.allium.so/api/v1/developer/base/address/0xb5a0bb236466fdb3282d0dff3eb7e4fb33b53f13/balances/fungible?page=1&size=10&token_address=0x0000000000000000000000000000000000000000' \
  -X GET \
  -H 'X-API-KEY: <API KEY>'

Table Columns

Column Name	Type	Description	Example
address	varchar	Address of the account.	0xd97d0911007bef00748579c5b8879a135ca31950
token_address	varchar	Token address. Native ETH is represented as 0x0000000000000000000000000000000000000000	0x0000000000000000000000000000000000000000
raw_balance	numeric(512)	Unormalized token balance. For ETH, balance of eth in wei.	8276168041811796
block_timestamp	timestamp	The timestamp of the block that that resulted in the balance.	2023-10-14T18:22:25
block_number	bigint	The number of the block that resulted in the balance.	5259199
block_hash	varchar	The hash of the block that resulted in the balance.	0x255d26efe0fe8c636f26f922ffb6de2093a070dd779a835e06f554b4d7a1181c