Core Hooks
Token Balances
Hooks
useTokenBalances - A React hook that fetches token balances for an account on a specified network. Returns token balances with optional fiat prices and native balance inclusion. useMultichainTokenBalances - A React hook that fetches token balances across multiple chains and networks for linked wallet addresses.Caching information
Token balances are cached for15 seconds by default unless force refreshing
Rate Limiting when using the forceRefresh feature of useTokenBalances
To prevent abuse of force refreshing the balances, we have implemented configurable rate limiting on this feature.
The default limits are as follows
- You cannot request a refresh within
1 minuteof the previous refresh - You can only refresh 3 times within a
5 minuteperiod - You can only force refresh 40 times a day
If you would like higher limits, please reach out to our sales team.
Supported chains
EVM networks
| Name | Chain ID |
|---|---|
| abstract | 2741 |
| ancient8 | 888888888 |
| ape_chain | 33139 |
| arbitrum | 42161 |
| arbitrum_nova | 42170 |
| avalanche_c | 43114 |
| avalanche_fuji | 43113 |
| b3 | 8333 |
| base | 8453 |
| base_sepolia | 84532 |
| berachain | 80094 |
| blast | 81457 |
| bnb | 56 |
| bob | 60808 |
| boba | 288 |
| celo | 42220 |
| corn | 21000000 |
| cyber | 7560 |
| degen | 666666666 |
| ethereum | 1 |
| fantom | 250 |
| flare | 14 |
| forma | 984122 |
| fraxtal | 252 |
| funkichain | 33979 |
| gnosis | 100 |
| ham | 5112 |
| hychain | 2911 |
| hyper_evm | 999 |
| ink | 57073 |
| interop_alpha_0 | 420120000 |
| interop_alpha_1 | 420120001 |
| kaia | 8217 |
| katana | 747474 |
| linea | 59144 |
| lisk | 1135 |
| mantle | 5000 |
| metis | 1088 |
| mint | 185 |
| mode | 34443 |
| monad_testnet | 10143 |
| omni | 166 |
| opbnb | 204 |
| optimism | 10 |
| polygon | 137 |
| proof_of_play | 70700 |
| proof_of_play_boss | 70701 |
| rari | 1380012617 |
| redstone | 690 |
| ronin | 2020 |
| scroll | 534352 |
| sei | 1329 |
| sepolia | 11155111 |
| shape | 360 |
| soneium | 1868 |
| sonic | 146 |
| superposition | 55244 |
| superseed | 5330 |
| swellchain | 1923 |
| unichain | 130 |
| wemix | 1111 |
| world | 480 |
| xai | 660279 |
| zero_network | 543210 |
| zkevm | 1101 |
| zksync | 324 |
| zora | 7777777 |
SVM networks
| Name | Chain ID |
|---|---|
| Solana Mainnet | 101 |
| Solana Devnet | 103 |
| Eclipse Mainnet | 201 |
BTC networks
| Name | Chain ID |
|---|---|
| Bitcoin Mainnet | 1 |