Token Balances

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

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 for 15 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 minute of the previous refresh
• You can only refresh 3 times within a 5 minute period
• 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