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.

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

Address for which token balances were returned.

tokenBalanceslist of objects or null

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

1	import requests
2
3	url = "https://eth-mainnet.g.alchemy.com/v2/:apiKey"
4
5	payload = {
6	"0": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
7	"1": ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]
8	}
9	headers = {"Content-Type": "application/json"}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

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	}