Token Balances By Wallet

Fetches fungible tokens (native and ERC-20) for multiple wallet addresses and networks. Returns a list of tokens with balances for each wallet/network combination. This endpoint is supported on Ethereum, Solana, and 30+ EVM chains. See the full list of supported networks here

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.

addresseslist of objectsRequired

Array of address and networks pairs (limit 3 pairs, max 20 networks). Networks should match network enums.

includeNativeTokensbooleanOptionalDefaults to true

Whether to include each chain’s native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address.

Response

Successful response!

dataobject

1	import requests
2
3	url = "https://api.g.alchemy.com/data/v1/docs-demo/assets/tokens/balances/by-address"
4
5	payload = { "addresses": [
6	{
7	"address": "0x1E6E8695FAb3Eb382534915eA8d7Cc1D1994B152",
8	"networks": ["eth-mainnet"]
9	}
10	] }
11	headers = {"Content-Type": "application/json"}
12
13	response = requests.post(url, json=payload, headers=headers)
14
15	print(response.json())

1	{
2	"data": {
3	"tokens": [
4	{
5	"network": "foo",
6	"address": "foo",
7	"tokenAddress": "foo",
8	"tokenBalance": "foo"
9	}
10	]
11	}
12	}

Path parameters

Request

Response

Errors