alchemy_getTokenBalances

Returns ERC-20 token balances for a given address.

apiKeystringRequired

This endpoint expects an object.

addressstringRequired

A 20-byte wallet address.

tokenSpecenum or list of stringsOptional

A token specification: - The string “erc20” - “DEFAULT_TOKENS” (deprecated) - An array of token contract addresses.

optionsobjectOptional

Optional pagination options.

An object containing the queried address and an array of token balance objects.

addressstringOptionalformat: "^0x[0-9a-fA-F]{40}$"

Address for which token balances were returned.

tokenBalanceslist of objectsOptional

Array of token balance objects. Exactly one of tokenBalance or error is non-null.

1	curl -X POST https://eth-mainnet.g.alchemy.com/v2/{apiKey} \
2	-H "Content-Type: application/json" \
3	-d '{
4	"jsonrpc": "2.0",
5	"method": "alchemy_getTokenBalances",
6	"params": [
7	"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
8	[
9	"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
10	]
11	],
12	"id": 1
13	}'

1	{
2	"jsonrpc": "2.0",
3	"id": "1",
4	"result": {
5	"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
6	"tokenBalances": [
7	{
8	"contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
9	"tokenBalance": "0x0000000000000000000000000000000000000000000000000000000000000000",
10	"error": null
11	}
12	]
13	}
14	}