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 stringsRequired

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

optionsobjectRequired

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	import requests
2
3	url = "https://eth-mainnet.g.alchemy.com/v2/:apiKey"
4
5	payload = { "0": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	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	}